Where is the machine-readable version of this page?

GET /api/v1/pricing returns the exact same table as JSON, no key required. This page and that endpoint are rendered from the same source, so they can never disagree.

x402 · usdc on base

Pricing for AI agents

Q: Do I need an API key to pay per request?

No. Per-request payments need no key at all: GET the endpoint, receive a 402, sign the amount, retry with the signed x-payment header. Passes and subscriptions do return an smk_live_ key, once, because they grant standing access rather than a single response.

Q: What if I'm polling an endpoint regularly?

Use a key instead. A free key serves the same endpoints at no cost up to 100 requests a day, and a pass or subscription removes the daily limit. Paying per call only makes sense for occasional or exploratory use with no signup.

Agents pay in USDC over the x402 protocol: gasless on Base, with Ethereum and Solana also supported. Two rails, open to any wallet, no account required.

Buy an hour / day pass All endpoint prices GET /api/v1/pricing

$0.01

cheapest call

1-hour pro pass

$0 gas

on base

no key

to pay per call

AI AGENT

402 · USDC

/companies/{ticker}/financials

$0.05

/companies/{ticker}/metrics

$0.05

/companies/{ticker}

$0.02

/companies/{ticker}/filings

$0.02

/indices/{index_name}

$0.02

/companies/search

$0.01

402 → sign → 200stablecoin settlement

01 · pay per time

Hour & day passes

A real smk_live_ key, Pro or Pro Plus, for a fixed window. When the window ends the key drops back to the free tier.

POST /payments/agent-subscribe

pass_1h

1 hour · Pro

no daily request limit

{"plan": "pass_1h"}

pass_1d

1 day · Pro

no daily request limit

{"plan": "pass_1d"}

pass_7d

7 days · Pro

no daily request limit

{"plan": "pass_7d"}

pass_1h_plus

1 hour · Pro Plus

no daily request limit

{"plan": "pass_1h_plus"}

pass_1d_plus

1 day · Pro Plus

no daily request limit

{"plan": "pass_1d_plus"}

pass_7d_plus

$15

7 days · Pro Plus

no daily request limit

{"plan": "pass_7d_plus"}

Buy one with POST /payments/agent-subscribe and a body of {"plan": "<pass>"}. The response returns an smk_live_ key once: store it, it is not shown again. Send your existing key in X-API-Key to put the pass on that key instead. A pass on top of an active subscription lifts the tier for its duration, then falls back automatically.

02 · pay per request

All endpoints & prices

One response from one endpoint. Keyless GET → 402 → signed retry. Calling with a normal X-API-Key works exactly as before, and a free key serves all of these at no cost up to 100 requests a day.

GET /api/v1/companies companies

List tracked companies with basic info: ticker, name, sector, exchange.

$0.01

per call

GET /api/v1/companies/search search

Search companies by name, ticker or sector.

$0.01

per call

GET /api/v1/companies/bulk bulk

Detailed profiles for up to 25 companies in a single call (?tickers=AAPL,MSFT,...).

$0.10

per call

GET /api/v1/companies/{ticker} company

A company's full profile: identity, classification, description, headquarters, employees, market cap and data-completeness signals.

$0.02

per call

GET /api/v1/companies/{ticker}/financials financials

Financial statements for a company: income statement, balance sheet and cash flow, each field tagged with its source.

$0.05

per call

GET /api/v1/companies/{ticker}/metrics metrics

Calculated financial metrics and ratios for a company.

$0.05

per call

GET /api/v1/companies/{ticker}/metrics/summary metrics_summary

Key metrics in one object: P/E, P/B, P/S, ROE, ROA, margins, EPS, debt/equity, current ratio.

$0.03

per call

GET /api/v1/companies/{ticker}/filings filings

Filings for a company: US SEC filings (10-K, 10-Q, 8-K with EDGAR URLs) and ASX annual and half-year reports with links to the PDF and its markdown conversion.

$0.02

per call

GET /api/v1/indices indices

List the available market indices with member counts.

$0.01

per call

GET /api/v1/indices/{index_name} index_members

List the companies in a market index, for example /indices/sp500.

$0.02

per call

GET /api/v1/formulas formulas

List the financial formula definitions behind the calculated metrics.

$0.01

per call

GET /api/v1/formulas/categories formula_cats

List formula categories: profitability, liquidity, valuation and so on.

$0.01

per call

GET /api/v1/formulas/{name} formula

One formula by name, including its calculation logic.

$0.01

per call

03 · which tier

Pro vs Pro Plus

A pass or subscription grants one of these two tiers. Pro is for live use; Pro Plus adds the historical and bulk layer for backtesting.

Pro

unlimited daily requests

Agent Trader · all real-time data

✓Full ASX 200 + S&P 500 coverage

✓Financial statements: income statement, balance sheet and cash flow

✓Computed ratios: P/E, ROE, margins and leverage

✓SEC filings and ASX announcements, annual reports as PDF and markdown

✓Intraday price data and on-demand data completion

Pro Plus

unlimited daily requests

Agent Backtester · everything in Pro, plus history

✓Everything in Pro

✓Market and company news feeds

✓Full historical and bulk data access for backtesting

✓Extended historical depth, 20+ years where available

✓Bulk company endpoints and raw XBRL filing data

Full tier comparison on /pricing.

04 · how to pay

The x402 flow, in four steps

Call it with no key

GET the endpoint without X-API-Key. You receive HTTP 402 with a Payment-Required header and a body whose accepts[] lists amount, network and payTo.

Sign the amount

EIP-3009 transferWithAuthorization on Base. The x402 client libraries do this, and no gas is spent by you.

Retry signed

Repeat the request with the payload in the x-payment header. The facilitator settles on-chain and the response is your data or your key.

Polling? Switch rails

A free key covers 100 requests a day at no cost, and a pass or subscription removes the limit. Pay per call to look around, not to run a schedule.

1) keyless GET · 402

curl -i https://stockmarketapi.ai/api/v1/companies/AAPL
# HTTP/1.1 402 Payment Required
# { "accepts": [{ "amount": "20000",
#     "network": "eip155:8453", "payTo": "0x..." }],
#   "price_usd": 0.02 }

2) signed retry · 200

curl -i https://stockmarketapi.ai/api/v1/companies/AAPL \
  -H "x-payment: <signed-payment-header>"
# HTTP/1.1 200 OK
# { "ticker": "AAPL", "name": "Apple Inc.", ... }

3) buy a pass or subscription · key returned once

# discover the 402 (price + networks), then re-POST signed
curl -X POST https://stockmarketapi.ai/payments/agent-subscribe \
  -H "Content-Type: application/json" \
  -H "x-payment: <signed-payment-header>" \
  -d '{"plan":"pass_1d"}'
# plan: pass_1h | pass_1d | pass_7d | *_plus | monthly | monthly_plus | yearly | yearly_plus
# { "api_key": "smk_live_..." }   ← shown once, store it

The x-payment header is a signed EIP-3009 transferWithAuthorization payload, not something you build by hand. The x402 client libraries (npm and PyPI) produce it from a wallet key. Per-request responses carry Cache-Control: private, no-store. Passes and subscriptions return an smk_live_ key once; per-request payments do not return a key at all.

05 · subscriptions

Polling on a schedule? Use a key instead.

A free key serves every endpoint on this page at no cost, up to 100 requests a day. Past that, Pro at $19/month removes the daily limit: at the cheapest per-request price ($0.01/call) the same money buys 1,900 calls. x402 and USDC payments settle on-chain and are final.

monthly

$19

Pro · monthly

monthly_plus

$49

Pro Plus · monthly

Compare subscriptions Get a free key or x402: POST /payments/agent-subscribe · {"plan": "monthly" | "monthly_plus"}

FAQ

Do I need an API key to pay per request?

No. Per-request payments need no key: GET, receive a 402, sign, retry. Passes and subscriptions do return an smk_live_ key, once, because they grant standing access.

Which networks are supported?

Base is recommended and gasless through the x402 facilitator. Ethereum and Solana are also supported for USDC settlement. Testnets are not accepted.

Is a paid response cached?

No. Every per-request response carries Cache-Control: private, no-store, so it is never reused for a different payer.

What if I'm polling an endpoint regularly?

Use a key. A free key serves the same endpoints at no cost up to 100 requests a day; a pass or subscription removes the limit.

Are x402 payments refundable?

No. x402 and USDC payments settle on-chain and are final.

Where is the machine-readable version?

GET /api/v1/pricing returns the same tables as JSON, no key required. This page and that endpoint render from the same source, so they can never disagree.