Crypto price API for AI agents — keyless, pay-per-call

Spot prices, funding, sentiment and market stats for autonomous agents — settled in USDC on Base, no API key.

Most price APIs gate the first quote behind a signup, a dashboard and a secret key the agent has to store and rotate. These routes do not. Pass ticker symbols or CoinGecko ids to /crypto/prices and get price, 24h change, symbol and a confidence score back; or read cross-venue perp funding, market sentiment, trending coins and sector performance — each a single call the agent settles in USDC on Base for exactly what it reads. Discover and wire the whole set from one file: the x402 catalog, the OpenAPI spec, or the plain-text catalog.

Routes

RoutePriceWhat it returnsTry free
GET /crypto/prices$0.001Spot token prices from DefiLlama — pass comma-separated ticker symbols or CoinGecko ids, get price/change_24h/symbol/confidence/timestamp.free preview
GET /crypto/categories$0.004Crypto sector performance (CoinGecko categories): market cap, 24h change, volume per sector, top by market cap. No params. Use when an agent needs sector rotation signals.—
GET /crypto/derivatives-exchanges$0.004Top crypto derivatives exchanges (CoinGecko): open interest BTC, 24h volume BTC, perpetual and futures pair counts, year established. No params. Use when an agent needs perp/futures venue liquidity data.—
GET /crypto/exchanges-top$0.004Top crypto exchanges by trust score (CoinGecko): name, country, year, trust score and rank, 24h BTC volume. No params. Use when an agent needs exchange due-diligence data.—
GET /crypto/fear-greed$0.002Crypto Fear & Greed Index (alternative.me): current value 0-100, classification, history of last N days. No params. Use when an agent needs a market-sentiment gauge.—
GET /crypto/funding$0.0046-venue perp funding rates — Binance+Bybit+OKX+Hyperliquid+dYdX+Gate — top coins by 24h volume, per-venue funding + per-venue open interest (USD) + OI-weighted CEX↔DEX arb verdict (thin-book venues excluded so cheapest-long/richest-short is executable, not a mirage), premium/basis, annualized_hl/okx/binance/bybit/gate, LONGS_PAY/SHORTS_PAY/NEUTRAL signal, next_funding_ts, mark/oracle prices.free preview
GET /crypto/global$0.004Global crypto market stats (CoinGecko): total market cap, 24h volume, BTC/ETH dominance, active coins. No params. Use when an agent needs a one-call market overview.—
GET /crypto/markets-top$0.004Top coins by market cap (CoinGecko): price, market cap, 24h volume, 24h change; ?limit= up to 100. No required params. Use when an agent needs a ranked market snapshot.—
GET /crypto/movers$0.004Top 24h gainers and losers among the top-100 coins (CoinGecko). No params. Use when an agent needs what is moving the market right now.—
GET /crypto/stablecoins$0.004Top stablecoins by circulating supply (DefiLlama): name, symbol, price, peg type, circulating USD. No params. Use when an agent needs stablecoin supply and depeg checks.—
GET /crypto/trending$0.004Trending coins on CoinGecko right now: name, symbol, market-cap rank, 24h price change. No params. Use when an agent needs what the market is searching for.—

Prices are per successful call in USDC on Base (eip155:8453). Routes with a free preview return the same JSON shape without payment so an agent can evaluate before it pays.

How an agent pays

Point any x402-aware client at a route. The first response carries the price and payment terms; the client pays and retries; the second response is the data. With the x402-fetch wrapper it is one line:

import { wrapFetch } from "x402-fetch";
const fetchPaid = wrapFetch(fetch, { account }); // your agent's Base wallet
const r = await fetchPaid("https://api.greyridgesignals.ai/crypto/prices?coins=ETH,BTC,SOL");
const prices = await r.json(); // spot prices with 24h change, paid inline

No API key is sent or stored. Settlement is a standard USDC transfer the route verifies on-chain before returning data.

Pay on Base, Polygon or Arbitrum

The 402 challenge offers native USDC on 3 networks — Base, Polygon or Arbitrum — so an agent holding USDC on any of them settles without bridging. Each offer in accepts[] carries the matching chain id and USDC contract; Base is listed first. Pick whichever network your wallet already funds.

Prepaid session cap — no per-call signature

For high-frequency polling, open a session once with a single USDC payment up to a cap, then call any paid route with just the returned session token — no EIP-712 signature per call. Each call debits the cap until it runs out. Open a cap at POST /x402/session (tiers $0.05 / $0.50 / $5.00), check the remaining balance any time at the free GET /x402/session/status. This removes the per-call signing round-trip for agents that make many requests in a row.

Spot, funding and sentiment in one keyless surface

An agent pricing a position wants the spot and the funding it will pay to hold it. Beyond spot, /crypto/funding returns per-venue Hyperliquid/OKX/dYdX funding with the arb spread in bps and a LONGS_PAY / SHORTS_PAY signal, and /crypto/fear-greed gives a 0-100 sentiment gauge — all on the same keyless, pay-per-call rail. Market data is informational, not financial advice.