Skip to content

SEC filings list API: pay per call with x402

View as Markdown

Pay per call for a company’s filings list 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 a page of SEC filings for a company from submissions, newest 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/filings?limit=5"

Any other company answers 402 Payment Required until paid:

curl -i "https://api.belfortagent.xyz/v1/companies/NVDA/filings?limit=5"

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

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