CoinStats turns crypto market, wallet, and portfolio data into an onchain pay-per-use utility with x402
CoinStats Open API has enabled x402-powered access for its full read-only Public API, 34 endpoints spanning prices, markets, wallet balances, DeFi positions, news, and shared portfolios — turning the service from keyed SaaS into a machine-to-machine data utility, settled via the Coinbase CDP Facilitator.
What is x402
x402 is an open payment protocol from Coinbase that makes HTTP’s long-dormant 402 Payment Required status code a real payment rail. A service quotes a price in-band, the client signs a USDC authorization, the server settles on chain and returns the data — all in two round-trips, all inside ordinary HTTP. The result is APIs that behave like programmable utilities: agents discover, pay for, and consume them without the sign-up flow designed for humans. Every paid call indexes the endpoint into a public discovery layer, so an agent that doesn’t know CoinStats exists today can find it tomorrow by searching for the data it needs.
Why it matters for agents
For developers building autonomous trading bots, portfolio monitors, research agents, or onchain analytics pipelines, this removes the entire onboarding layer. Agents can start consuming live coin prices, wallet holdings, and DeFi position data in a single API call, paying only for what they use. There’s no human sign-up, no rate-limit tier to negotiate, and no API key to rotate. Discovery, authentication, and payment all happen in-band, per call, over HTTP.
What’s live
The rollout covers the endpoints agents reach for most:
- Markets & prices — /coins, /coins/{coinId}, /coins/charts, /markets, /tickers/*, /fiats, /currencies
- Historical pricing — /coins/price/avg, /coins/price/exchange
- Wallet data — /wallet/balance, /wallet/balances, /wallet/transactions, /wallet/chart, /wallet/status, /wallet/blockchains across 30+ chains
- Wallet DeFi — /wallet/defi and /portfolio/defi — staked, lent, borrowed, LP, and yield-farming balances across Aave, Lido, Uniswap, Curve, Pendle, Morpho, and 100+ more protocols
- News — /news, /news/sources, /news/type/{type}, /news/{id}
- Market sentiment — /insights/btc-dominance, /insights/fear-and-greed, /insights/rainbow-chart/{coinId}
- Shared portfolios — /portfolio/value, /portfolio/coins, /portfolio/chart, /portfolio/transactions, /portfolio/snapshot/items (via CoinStats share token)
Full endpoint + pricing reference: docs.coinstats.app/ai-agents/x402.
Pricing
Pricing is tiered by the cost of the underlying data:
- $0.001 USDC — simple lookups (coin details, markets, news, insights)
- $0.004 USDC — wallet-scoped queries (balances, transactions, charts)
- $0.04 USDC — DeFi position aggregation (single wallet or portfolio)
- $0.05 USDC — full portfolio snapshots
Payments settle in USDC on Base mainnet. Gas is sponsored by the facilitator — payers hold USDC only. These endpoints are experimental and pricing is subject to change.
Discovery
Every x402-paid call is indexed into the CDP Bazaar at api.cdp.coinbase.com/platform/v2/x402/discovery/resources, with descriptions, input schemas, and example responses agents can search in-context. CoinStats endpoints also surface on agentic.market alongside the rest of the x402 ecosystem.
Getting started
- Read the x402 section of the CoinStats docs.
- Fund a Base wallet with a few USDC.
- Point the @x402/fetch client at https://x402.coinstats.app.
Your first paid request will index the endpoint into the CDP Bazaar within seconds. From there, every agent in the x402 ecosystem can find it.
