Financial statements fields API: pay per call with x402
Pay per call for normalized financial statement fields with x402: no account and no API key. An x402 client gets a 402 Payment Required answer with the price, pays in USDC on Base, and repeats the request.
GET /v1/companies/{id}/financials
Section titled “GET /v1/companies/{id}/financials”$0.006 per call in USDC on Base. Returns normalized core financials from printed statement lines, newest period first. Only fields that passed the publish bar are served. Every figure names its SEC filing in source_accession. Charged only when at least one record comes back; errors and empty results are free.
Free for the demo companies, with no key and no payment (up to 60 an hour per network):
curl "https://api.belfortagent.xyz/v1/companies/AAPL/financials?field=revenue&period=annual&limit=4"Any other company answers 402 Payment Required until paid:
curl -i "https://api.belfortagent.xyz/v1/companies/NVDA/financials?field=revenue&period=annual&limit=4"The PAYMENT-REQUIRED header, base64-decoded (trimmed to the payment terms):
{ "x402Version": 2, "resource": { "url": "https://api.belfortagent.xyz/v1/companies/NVDA/financials?field=revenue&period=annual&limit=4" }, "accepts": [ { "scheme": "exact", "network": "eip155:8453", "amount": "6000", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x80bEF165f2895539CfEcd74A7949A88e576e5E09", "maxTimeoutSeconds": 60 } ]}Details
Section titled “Details”- Every field, parameter and error: Financial statements fields.
- Machine-readable: the API’s OpenAPI document (
x-payment-infoon each paid route) and/.well-known/x402. - With an API key and card credits instead: Pricing.