Skip to content

Segment revenue API: pay per call with x402

View as Markdown

Pay per call for segment revenue 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 single-axis product, geographic and business-segment revenue figures from SEC filings, newest filing first. Every figure carries its source accession and the 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/segments?limit=1"

Any other company answers 402 Payment Required until paid:

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

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

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