Coin snapshot on a date
GET /api/coin-historyPrice, market cap and 24h volume of a coin on ONE past date (00:00 UTC snapshot), in every currency at once plus your chosen one called out. Pass `date` (YYYY-MM-DD) or `daysAgo` (1-365). The point-in-time sibling of crypto-history (which returns a series): use it to value a position as of a date, compute a since-date return, or check a tax-lot basis. Historical range on this plan is the past 365 days, enforced before the call. Cached in-process for 5 minutes.
Input
| Field | Type | Description |
|---|---|---|
coin * | string | Coin id (bitcoin, ethereum, ...). |
date | string | Snapshot date YYYY-MM-DD (UTC), within the past 365 days. Alternative to daysAgo. |
daysAgo | number | Days before today, 1-365 (used when date is absent; default 30). |
currency | string | Currency to call out (default usd); all currencies are still returned under `allCurrencies`. |
Example output
{
"source": "coingecko",
"fetchedAt": "2026-08-22T13:20:00.000Z",
"cached": false,
"id": "bitcoin",
"symbol": "BTC",
"name": "Bitcoin",
"date": "2026-07-23",
"currency": "usd",
"price": 118412.55,
"marketCap": 2356000000000,
"volume24h": 41000000000,
"allCurrencies": {
"price": {
"usd": 118412.55,
"eur": 100812.3,
"btc": 1
},
"marketCap": {
"usd": 2356000000000
},
"volume24h": {
"usd": 41000000000
}
}
}
Try it - see the 402 challenge (free)
curl -i "https://agent402.tools/api/coin-history?coin=bitcoin&daysAgo=30¤cy=usd"
The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:
Paid call (JavaScript agent)
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);
const res = await payFetch("https://agent402.tools/api/coin-history?coin=bitcoin&daysAgo=30¤cy=usd");
Related tools
Crypto order book
GET /api/crypto-orderbookL2 order-book snapshot for a spot pair: best bid/ask, mid price, spread (absolute + %), and the top N aggregated price l…
try in playground →Stablecoin peg monitor
GET /api/stablecoin-pegLive $1-peg deviation for the top USD stablecoins (USDT, USDC, USDS, DAI, USDe, PYUSD, USDD, TUSD, FDUSD by default, or …
try in playground →Wallet balance (native + ERC-20)
POST /api/wallet-balanceLook up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, A…
try in playground →