GET /api/v3/x402/onchain/simple/networks/base/token_price/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b,0x4200000000000000000000000000000000000006
?include_market_cap=true
&mcap_fdv_fallback=true
&include_24hr_vol=true
&include_24hr_price_change=true
&include_total_reserve_in_usd=true
Trusted by Industry Builders
Make A Request
Send a request to any x402-enabled endpoint. The server responds a 402 status with payment requirements.
GET /api/v3/x402/onchain/simple/networks/base/token_price/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b,0x4200000000000000000000000000000000000006
?include_market_cap=true
&mcap_fdv_fallback=true
&include_24hr_vol=true
&include_24hr_price_change=true
&include_total_reserve_in_usd=true
Sign & Pay
Your wallet signs a USDC authorization and submits the payment signature header. CoinGecko currently support USDC payments on Solana and Base.
Receive Data
API access granted and it returns the data you requested. You're all done!
{
"data": {
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
"type": "token",
"attributes": {
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"name": "Tether USD",
"symbol": "USDT",
"decimals": 6,
"image_url": "https://coin-images.coingecko.com/coins/images/325/large/Tether.png?1696501661",
"coingecko_coin_id": "tether",
"total_supply": "91775654692250534.0",
"normalized_total_supply": "91775654692.2505",
"price_usd": "0.999188255",
"fdv_usd": "91700939859.6687",
"total_reserve_in_usd": "405089394.14192413773442554227",
"volume_usd": {
"h24": "1142454033.37436"
},
"market_cap_usd": "171798403974.784"
},
"relationships": {
"top_pools": {
"data": [
{
"id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",
"type": "pool"
},
{
"id": "eth_0xf063bd202e45d6b2843102cb4ece339026645d4a",
"type": "pool"
},
{
"id": "eth_0x8aa4e11cbdf30eedc92100f4c8a31ff748e201d44712cc8c90d189edaa8e4e47",
"type": "pool"
}
]
}
}
},
"included": [
{
"id": "eth_0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",
"type": "pool",
"attributes": {
"base_token_price_usd": "0.999949947925521",
"base_token_price_native_currency": "0.000223341206041575",
"base_token_balance": "74198606.301554",
"base_token_liquidity_usd": "74194892.50738515",
"quote_token_price_usd": "0.99918825500163",
"quote_token_price_native_currency": "0.000223171080110164",
"quote_token_balance": "29771050.29628",
"quote_token_liquidity_usd": "29746883.795105774",
"base_token_price_quote_token": "1.0007623117",
"quote_token_price_base_token": "0.9992382689",
"address": "0x667701e51b4d1ca244f17c78f7ab8744b4c99f9b",
"name": "USDC / USDT",
"pool_created_at": "2025-09-18T08:28:30Z",
"token_price_usd": "0.99918825500163",
"fdv_usd": "91700939859.6687",
"market_cap_usd": "171798403975.064",
"price_change_percentage": {
"m5": "-0.02",
"m15": "-0.65",
"m30": "-0.01",
"h1": "0",
"h6": "-0.18",
"h24": "-0.5"
},
"transactions": {
"m5": {
"buys": 0,
"sells": 2,
"buyers": 0,
"sellers": 2
},
"m15": {
"buys": 4,
"sells": 7,
"buyers": 3,
"sellers": 5
},
"m30": {
"buys": 12,
"sells": 19,
"buyers": 7,
"sellers": 9
},
"h1": {
"buys": 39,
"sells": 48,
"buyers": 16,
"sellers": 15
},
"h6": {
"buys": 180,
"sells": 271,
"buyers": 31,
"sellers": 35
},
"h24": {
"buys": 870,
"sells": 1109,
"buyers": 55,
"sellers": 59
}
},
"volume_usd": {
"m5": "988.7572917698",
"m15": "1857835.95996426",
"m30": "3190909.49729904",
"h1": "9434171.29930675",
"h6": "84784863.3965608",
"h24": "388004708.962186"
},
"reserve_in_usd": "103939687.035"
},
"relationships": {
"base_token": {
"data": {
"id": "eth_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"type": "token"
}
},
"quote_token": {
"data": {
"id": "eth_0xdac17f958d2ee523a2206206994597c13d831ec7",
"type": "token"
}
},
"dex": {
"data": {
"id": "fluid-ethereum",
"type": "dex"
}
}
}
}
]
}
x402-enabled Endpoints
Simple Price
Fetch price, market cap and 24-hour trade volume for coins listed on CoinGecko by symbols or coin ids
On-chain Simple Price
Access on-chain token price, market cap, liquidity and 24-hour volume for tokens listed on GeckoTerminal
Token Data
Get complete on-chain price and market data, including logo, price changes, transactions and more
Search Pools
Query data for a specific pool or token by contract address, token name, or symbol
Trending Pools
Discover what's popular on a blockchain with CoinGecko API's on-chain trending pools endpoint
Low Entry Barriers
Access crypto data without API keys, account setups or credit card details. Just instant access.
Agent-Ready
Built for AI agents to operate independently—pay, access, and retrieve data autonomously.
