Skip to content

SEC financial statements API: pay per call with x402

View as Markdown

Pay per call for financial statements as filed 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.

$0.018 per call in USDC on Base. Returns statements as filed, one document per filing and statement, newest filing first. Every document links to its SEC filing. 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/statements?statement=IS&limit=1"

Any other company answers 402 Payment Required until paid:

curl -i "https://api.belfortagent.xyz/v1/companies/NVDA/statements?statement=IS&limit=1"

The PAYMENT-REQUIRED header, base64-decoded (trimmed to the payment terms):

{
"x402Version": 2,
"resource": {
"url": "https://api.belfortagent.xyz/v1/companies/NVDA/statements?statement=IS&limit=1"
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:8453",
"amount": "18000",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x80bEF165f2895539CfEcd74A7949A88e576e5E09",
"maxTimeoutSeconds": 60
}
]
}