Explainer · Agent payments
Crypto data by the call: how our x402 API works
October 10, 2026
Blockchain IQ sells crypto data and research by the request, paid in USDC over the open x402 standard with no account and no API key; here is what is for sale, how a call works, and what building it taught us.
Terms with a dotted underline link to the glossary.
What it is
Blockchain IQ is a subscription research service for people. Alongside it we run a second, much smaller door for software: an API where each request is paid for on its own. There is no signup, no API key and no monthly plan. A program asks for a resource, is told the price, pays it in USDC on Base, and gets JSON back.
The mechanism is x402, an open payment standard built on a status code that has been in HTTP for decades and almost never used: 402 Payment Required. We run protocol version 2 and settle through Coinbase's CDP facilitator.
Why pay per call suits an agent
Two reasons, both practical.
The first is signup. A person can create an account, confirm an email and paste a key into a config file. An autonomous agent that discovers it needs a Bitcoin price in the middle of a task cannot do any of that, and should not be handed a way to. With x402 the only credential is a wallet holding a little USDC.
The second is size. Our cheapest call costs $0.005. Card processing carries a fixed fee per transaction that is many times larger than that, so a card cannot carry a payment this small; the usual answer is a subscription or prepaid credits, which brings the account back. A stablecoin transfer settled through a facilitator can carry half a cent, and the payer does not pay gas.
What is for sale
Twenty-four paid resources, all GET, all under https://www.blockchainiq.co/api/x402/v1: fourteen data resources, in the table below, and ten research resources (The Ripple Review, Coin Research briefs, Dispatches and the glossary), described after it. Four of the data resources are one-call answers shaped for an agent loop rather than raw data: a parameter-free market brief, scheduled event risk, and per-chain network activity for 15 blockchains. Three more sell Circle's USDC and EURC on Ethereum, Base and Arbitrum as we read them from the token contracts themselves: supply, issuance by minter class, and control events such as blacklistings and upgrades.
| Resource | Path | Price per call |
|---|---|---|
| Market brief: majors, next-48h events, risk flags (parameter-free) | /brief | $0.01 |
| Event risk: dated macro and crypto events, next 7 days by default | /event-risk?days= | $0.05 |
| One chain's activity with 7-day change (15 chains) | /network/{chain} | $0.03 |
| All 15 chains' activity in one call (parameter-free) | /networks | $0.10 |
| x402 Conformance Index: the top 1,000 mainnet x402 sellers with their A to F grade (parameter-free) | /x402-market | $0.02 |
| Circle USDC and EURC snapshot: supply, net issuance by minter class, roles, blacklist count (parameter-free) | /stablecoins | $0.02 |
| USDC and EURC control events: blacklistings, pauses, minter allowances, upgrades | /stablecoins/events?since= | $0.02 |
| One USDC or EURC token-chain's daily supply and issuance, up to 365 days | /stablecoins/history?chain=&token=&days= | $0.02 |
| US macro indicators | /macro | $0.05 |
| Economic and crypto calendar, next 90 days | /calendar | $0.03 |
| Sector indices, list | /indices | $0.03 |
| One analytics dashboard, every panel with its analyst read | /dashboards/{slug} | $0.25 |
| One dashboard panel | /dashboards/{slug}/{panel} | $0.03 |
| An Analytics section: every blockchain network dashboard on one page | /sections/{section} | $0.50 |
The $0.50 resource is a bundle of our own analysis rather than raw market data: a whole Analytics section. Each dashboard panel comes back with an analyst_read, the analyst's short note on what that chart shows. The agent-shaped resources sit in the $0.01 to $0.05 band where most agent purchases happen, and the parameter-free ones can be called exactly as they appear in a listing.
Free, with no payment: the catalog at /api/x402/v1 (also served at /.well-known/x402), a sample at /api/x402/v1/sample that returns Bitcoin's network activity for its latest day so you can test your parsing before spending anything, and the OpenAPI document at /openapi.json.
The research, by the call
The same catalog sells our written work as well as numbers. A Coin Research brief or a Dispatch comes back as the whole piece in Markdown, plus its structured sections (tables, chart data, timelines), its sources and links back to its page. A report comes back as the stored edition, exactly as its page renders it. Glossary terms named in the text are linked to their definitions.
| Resource | Path | Price per call |
|---|---|---|
| One coin's research brief (132 coins), by research slug or CoinGecko id | /research/{coin} | $0.05 |
| Chain research digest: the dated chain-data read for all 21 blockchains we track (parameter-free) | /research/digest | $0.50 |
| The Ripple Review, newest daily edition (parameter-free) | /reports/the-ripple-review | $0.10 |
| Reports digest: the newest edition of every report sold here, today The Ripple Review only (parameter-free) | /reports/digest | $0.50 |
| Dispatch: What the BIS says crypto, stablecoins and CBDCs must do | /dispatch/bis-digital-money-research-review | $0.02 |
| Dispatch: The Charter Race | /dispatch/occ-bank-charter-race | $0.02 |
| Dispatch: SEC v. Ripple | /dispatch/sec-v-ripple | $0.02 |
| Dispatch: Who's Actually in Charge? A Field Guide to Blockchain Governance | /dispatch/blockchain-governance-models | $0.02 |
| Dispatch: BlackRock Puts Three Model Portfolios on Ondo | /dispatch/ondo-blackrock-intelligent-portfolios | $0.02 |
| The whole crypto glossary: every term with its definition, category and related terms (parameter-free) | /glossary | $0.05 |
Three free indexes show what is on the shelf before anything is bought: /reports lists each report with the date of its newest edition, /research lists every Coin Research brief with the date its lede was last updated, and /dispatch lists the Dispatches for sale, newest first. Each entry carries the path to buy it.
How a call works
- 1. Send a plain GET. No headers.
- 2. The reply is HTTP 402. Its PAYMENT-REQUIRED header is base64-encoded JSON naming the price, the asset, the network and the address to pay.
- 3. Your x402 client signs a USDC authorization for that amount locally and repeats the request with a PAYMENT-SIGNATURE header.
- 4. The reply is HTTP 200 with the data, plus a PAYMENT-RESPONSE header carrying the transaction hash. A 404 or an error is never charged.
This is the decoded header from an unpaid GET to /api/x402/v1/brief on 11 October 2026 (the extensions block, which carries an example response and a JSON schema for directories, is left out for length):
json
{
"x402Version": 2,
"error": "Payment required",
"resource": {
"url": "https://www.blockchainiq.co/api/x402/v1/brief",
"description": "Market brief in one parameter-free call: BTC, ETH, SOL and XRP prices with 24h, 7d and 30d moves and rank, scheduled macro and crypto events in the next 48 hours, and short risk flags. Use as the opening call of a trading, portfolio or research agent loop. Refreshed every minute. JSON, no API key. $0.01 per call. Blockchain IQ.",
"mimeType": "application/json",
"serviceName": "Crypto Market Brief for Agents",
"tags": ["crypto", "market-brief", "event-risk", "macro", "trading"]
},
"accepts": [
{
"scheme": "exact",
"network": "eip155:8453",
"amount": "10000",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0x617dA9383fbA67e86137BC4924b8b7E400fB7C9e",
"maxTimeoutSeconds": 300,
"extra": { "name": "USD Coin", "version": "2" }
}
]
}eip155:8453 is Base. The asset is the USDC contract on Base, and USDC has six decimals, so an amount of 10000 is one cent.
In practice a client library does steps 2 and 3 for you. This is the example from our agents page, the same code we run against production:
js
// npm install @x402/fetch @x402/evm viem
import { privateKeyToAccount } from "viem/accounts";
import { wrapFetchWithPayment, x402Client, decodePaymentResponseHeader } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
// A wallet holding a little USDC on Base. Settlement is gasless for the payer.
const account = privateKeyToAccount(process.env.AGENT_PRIVATE_KEY);
const client = x402Client.fromConfig({
schemes: [{ network: "eip155:*", client: new ExactEvmScheme(account) }],
spendControls: { maxAmountPerPayment: 0.3 }, // dollars; refuse anything dearer
});
const payFetch = wrapFetchWithPayment(fetch, client);
// The first request gets HTTP 402 with a PAYMENT-REQUIRED header; the wrapper
// signs a USDC payment for that amount and retries with it.
const res = await payFetch("https://www.blockchainiq.co/api/x402/v1/event-risk?days=7");
const { data } = await res.json();
console.log(data);
// Proof of settlement: payer, network and transaction hash.
console.log(decodePaymentResponseHeader(res.headers.get("payment-response")));Node 18 or later. The spend control matters: it makes the client refuse any single payment above the amount you set, whatever a server asks for.
Where an agent can find it
An API nobody can discover is not much use to software, so the same catalog is published in several places: the Coinbase x402 Bazaar, x402scan, an OpenAPI 3.1 document at /openapi.json with a price on every operation, a plain-text summary at /llms.txt, and a human-readable guide at blockchainiq.co/agents.
What we learned building it
- A directory only re-reads a listing when someone pays. The Bazaar picks up a resource's name, description and tags at the moment a payment for that resource settles through the facilitator. Edit the text and the index keeps the old version until the next purchase of that resource. When we shipped per-resource listings on 2 October, the Bazaar still showed four of our nine resources under the generic descriptions they had on 29 September. We now run a small daily job that buys each resource once, from our own wallet, when its listing has changed, so the index catches up. That is all it does: it never buys to move a ranking.
- The limits are short and not all of them fail loudly. A service name must be 32 printable ASCII characters or fewer, or the directory drops it. A description over 500 characters makes the payment itself fail. Only five tags are kept. We now check all three at build time, so a long description breaks our build instead of a customer's payment.
- Search takes query=. The Bazaar's search endpoint reads the search text from a parameter called query. Send q= instead and you still get a 200 and a page of results, just not results for what you asked. Nothing tells you the parameter was ignored.
Where it stands
The API went to Base mainnet on 21 September 2026 and was first indexed in the Bazaar on 29 September. As of 2 October, five payments had settled, about $0.32 in total. Four were our own test purchases on 29 September. One, $0.02 for the global market resource on 1 October, came from a wallet that is not ours. That is the whole record, and we would rather state it than round it up. (The daily listing job's own purchases are internal and are not counted here.)
Not investment advice
Everything the API returns is market data and general-circulation analysis, not investment advice, and every response says so in its JSON envelope. Use is covered by our terms: https://www.blockchainiq.co/terms
This is general-circulation educational content, not investment advice.
Prices, paths and the 402 shown were read from the live API on 11 October 2026. Updated 12 October 2026: the coin price, price history, market snapshot, sector index, coin card and free sample resources were withdrawn, and five network dashboards and Hedera are no longer sold through the API. Updated 14 October 2026: the free sample is back, now Bitcoin's network activity rather than market data, and the research resources are listed with their prices; the catalog, paths and prices were re-read from the live API that day. Updated 22 October 2026: prices were changed to a new list (the table above shows it); the event-risk call, for example, went from $0.005 to $0.05 and a whole Analytics section from $0.25 to $0.50. The free catalog at /api/x402/v1 is the current source of truth.