The docs

One HTTP call returns a company’s latest earnings as JSON. Every number comes with the line it was read from and a link to the SEC document.

• Quick start
• Free vs paid
• The x402 flow
• From an agent
• Response fields
• Other routes
• Limits
• Error codes
• Disclaimer

Quick start

No key, no wallet, no account:

curl https://quarterquill.xyz/v1/free/earnings/NFLX

You get the latest earnings release the company filed (8-K Item 2.02, Exhibit 99.1, or the 10-Q / 10-K), read into fields such as revenue, operating income, net income, diluted EPS and cash flow. Each figure has a quote (the exact text or table row) and a source (the sec.gov URL of that document). A number that cannot be found verbatim in the source is dropped.

Extraction is deterministic (table rows and sentence parsing). There are no analyst estimates and no “beat” or “miss” labels.

Free vs paid

Paid reads settle only when the read succeeds (the handler answers below 400). A filing that cannot be read is not charged.

The x402 flow

1. Ask. GET /v1/earnings/NFLX without payment answers 402 Payment Required. The terms are in the PAYMENT-REQUIRED header (x402 v2): scheme exact, network eip155:4663, asset USDG, amount 0.05 (50000 in 6-decimal units), and the payTo address.
2. Sign. The client signs an EIP-3009 TransferWithAuthorization for that amount on USDG (0x5fc5360d0400a0fd4f2af552add042d716f1d168). It is a signature, not a transaction: the buyer needs USDG, not ETH.
3. Retry. The same request is sent again with the signed payload in the PAYMENT-SIGNATURE header.
4. Read. The server verifies the authorization, then reads the filing from SEC EDGAR.
5. Settle and receipt. If the read succeeded, the facilitator submits the authorization on Robinhood Chain and the response carries a PAYMENT-RESPONSE header with the transaction hash, plus a receipt object signed by the server (EIP-712). If it failed, nothing is submitted and nothing is charged.

Every settled read is listed on /proof with its Blockscout link.

From an agent

Generic: @x402/fetch (Node)

// npm i @x402/fetch @x402/core @x402/evm viem
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { toClientEvmSigner } from "@x402/evm";
import { wrapFetchWithPayment } from "@x402/fetch";
import { createPublicClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";

// A wallet that holds a little USDG on Robinhood Chain (no ETH needed).
const account = privateKeyToAccount(process.env.BUYER_KEY);
const rpc = createPublicClient({ transport: http("https://robinhood-rpc.publicnode.com") });
const client = new x402Client().register("eip155:4663", new ExactEvmScheme(toClientEvmSigner(account, rpc)));

const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://quarterquill.xyz/v1/earnings/NFLX");
const report = await res.json();
for (const it of report.items) console.log(it.label, it.value, "←", it.quote, it.source);

Keep the key in a file or secret store your agent cannot print, and cap what it may spend per call (0.05 USDG is the price of one read).

MCP clients (Claude Code, Cursor, others)

The API is agent-callable as is:

• For free reads, any tool that can make an HTTP GET is enough: point it at /v1/free/earnings/:ticker.
• For paid reads, give the agent an x402-capable MCP payment tool configured for eip155:4663 and USDG, then let it call /v1/earnings/:ticker. The tool handles the 402, the signature and the retry.
• Discovery: /.well-known/agent.json and /openapi.json list the routes, prices and the payment network.

A prompt that works well: “Get NFLX earnings from quarterquill.xyz and list each number with its footnote and source link.”

Response fields

Other routes (free)

curl https://quarterquill.xyz/v1/watch

Limits

• Free route: 3 reads a day per IP. After that it answers 429 with a JSON reason.
• Paid route: $0.05 USDG per read, charged only for successful reads.
• Coverage: US companies that file with the SEC. Fields appear only when they can be quoted from the filing, so a report may have fewer items than another.
• Prior-period comparisons depend on SEC XBRL data and may be missing for some companies or quarters.
• SEC EDGAR asks for fair access; reads are cached, so repeated calls for the same report are fast.
• CORS is open, so the API can be called from a browser.

Error codes

Errors are JSON with a reason you can show to a person.

Disclaimer

Not investment advice. Quarterquill quotes public SEC filings and links each number to its source; check the source before relying on any figure. It does not forecast, rate or recommend anything.

Quarterquill is not affiliated with the SEC, Robinhood, Chainlink or any company it reads.

The token has no claim on revenue, fees or profits, and holding it is not required to use the API.