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.
| Route | Price | What it returns | Try free |
|---|---|---|---|
GET /crypto/prices | $0.001 | Spot 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.004 | Crypto 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.004 | Top 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.004 | Top 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.002 | Crypto 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.004 | 6-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.004 | Global 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.004 | Top 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.004 | Top 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.004 | Top 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.004 | Trending 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.
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.
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.
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.
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.