API Pricing

No API key. No subscription. No signup. Most endpoints are free forever. Data-intensive endpoints include a free quota; beyond that, pay per call via the x402 protocol on Radius using SBC stablecoin.

How It Works

Free endpoints — reference data, prices, token lists, AI context — are always free with no limits.
Paid endpoints — transaction lookup, wallet history, MCP — include 5 free requests per minute per IP address.
Beyond the free quota, the API returns 402 Payment Required with an x402 payment offer in the PAYMENT-REQUIRED header.
Your client sends payment proof (signed by your wallet) and the request is served immediately upon settlement.

Payment settles on Radius (eip155:723487) in SBC stablecoin. Any x402-compatible wallet or agent SDK works — including @radiustech/sdk, @x402/evm, and agent frameworks with native x402 support.

Paid Endpoints

Tier	Endpoints	Price	Free Quota
Transaction Lookup Look up individual transactions by hash. Supports on-demand indexing for unknown transactions.	/tx/{hash} /tx/{transfer_type}/{hash} /tx/{transfer_type}/{value_type}/{hash}	$0.0001	5 req/min per IP
Wallet History Paginated transaction history for any wallet address. Heavier database queries than transaction lookup.	/wallet/{address} /wallet/{transfer_type}/{address}	$0.0003	5 req/min per IP
MCP (AI Agents) Model Context Protocol server. Each call may chain multiple internal queries, justifying a higher price.	/mcp	$0.0005	5 req/min per IP

Free Endpoints

These endpoints are free, unlimited, and require no authentication.

Endpoint	Description	Price
/value-type/list	List all value types	Free
/value-type/{id}	Get a single value type	Free
/transfer-type/list	List all transfer types	Free
/transfer-type/{id}	Get a single transfer type	Free
/price/list	All prices with 24h volume	Free
/price/{value_type}	Price with per-chain breakdown	Free
/price/{value_type}/{transfer_type}	Chain-scoped price	Free
/tokenlist/brale.json	Full Brale token list	Free
/tokenlist/uniswap.json	EVM-only token list	Free
/llms/static-context.json	AI/LLM platform context	Free
/analytics/summary	Network statistics	Free
/openapi.json	OpenAPI 3.1 specification	Free
/capabilities	Endpoint discovery	Free
/errors	Error catalog	Free

x402 Payment Flow

When a paid endpoint returns 402:

GET /api/tx/base/sbc/0xabc... HTTP/1.1 HTTP/1.1 402 Payment Required PAYMENT-REQUIRED: <base64-encoded payment offer> Content-Type: application/json { "x402": 1, "accepts": [{ "scheme": "exact", "network": "eip155:723487", "maxAmountRequired": "100", "resource": "/api/tx/base/sbc/0xabc...", "payTo": "0x26ECe47A7a7DF6692dD11F42C1B465116a7B068d" }], "price": "$0.0001", "description": "Transaction lookup — $0.0001/call after 5 free/min" }

Your client signs a payment for the required amount, then retries with the proof:

GET /api/tx/base/sbc/0xabc... HTTP/1.1 PAYMENT-SIGNATURE: <signed x402 payment proof> HTTP/1.1 200 OK PAYMENT-RESPONSE: <settlement receipt> Content-Type: application/json { "data": [...], "count": 1 }

Machine-Readable Pricing

For agents and automated clients, pricing is available in multiple formats:

pricing.md — pricing.md — Markdown format for LLMs
OpenAPI spec — /api/openapi.json — Pricing in endpoint descriptions and 402 response schemas
Capabilities — /api/capabilities — Structured pricing object
LLM Context — /api/llms/static-context.json — Full pricing in AI context payload
Error Catalog — /api/errors — 402 handling instructions and recovery hints

Payment Details

Protocol	x402 (HTTP 402 Payment Required)
Payment Network	Radius (eip155:723487)
Payment Asset	SBC stablecoin (6 decimals, 1 SBC = $1 USD)
Recipient	0x26ECe47A7a7DF6692dD11F42C1B465116a7B068d
Settlement	Immediate — payment verifies and settles on-chain before the response is served

FAQ

Do I need an API key?

No. There are no API keys, no accounts, and no signup. Free endpoints are open. Paid endpoints accept x402 payments from any wallet.

Why are wallet queries more expensive?

Wallet history requires paginated database scans across potentially thousands of transactions, with on-demand indexing when the wallet hasn't been seen before. Transaction lookups are single-row queries.

Why is MCP the most expensive?

A single MCP tool call may trigger multiple internal queries — listing value types, looking up transactions, and formatting results. The higher price reflects the composite cost.

Can I use the free quota for testing?

Yes. Every paid endpoint allows 5 requests per minute per IP at no cost. This is enough for development and light usage.

What wallets work with x402?

Any EVM wallet that can sign EIP-191 messages. Agent SDKs like @radiustech/sdk and @x402/evm handle the payment flow automatically.