Skip to main content
Experimental endpoints — features, pricing, and availability may change without notice.
For production systems, use the standard subscription endpoints.
x402 is an open payment protocol by Coinbase that enables instant stablecoin payments over HTTP.

​
Getting Started

1

Set up an x402 client

Follow the x402 Quickstart for Buyers to configure your wallet.
2

Call an x402 endpoint

Insert /x402/ after /v3/ in any supported endpoint path.
https://pro-api.coingecko.com/api/v3/x402/...
The server responds with 402 code and payment requirements.
3

Sign and pay

Your wallet signs a USDC authorization.
Resend the request with the PAYMENT-SIGNATURE header:
curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/simple/networks/eth/token_price/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 \
  -H 'PAYMENT-SIGNATURE: {{paymentSignature}}'
The x402 client generates the PAYMENT-SIGNATURE header automatically — you don’t need to create it manually.
4

Receive data

"token_prices": {
  "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2": "1678.6456001894"
}
See each endpoint reference for full payload details.
Do NOT send x-cg-pro-api-key or x-cg-demo-api-key — no API key is required for x402 requests.

​
Supported Endpoints

Endpointx402 Path
Simple Price/x402/simple/price
Simple Token Price/x402/onchain/simple/networks/{id}/token_price/{address}
Search Pools/x402/onchain/search/pools
Trending Pools by Network/x402/onchain/networks/{id}/trending_pools
Token Data by Address/x402/onchain/networks/{network}/tokens/{address}
  • All parameters from the Pro API are supported — refer to each endpoint’s reference page for details.
  • For network_id values, see the Networks List or this Google Sheet.
  • See the x402 guide for more usage details.

​
Request Examples

GET /api/v3/x402/onchain/simple/networks/base/token_price/0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b,0x4200000000000000000000000000000000000006
  ?include_market_cap=true
  &include_24hr_vol=true
  &include_24hr_price_change=true

GET /api/v3/x402/onchain/search/pools
  ?query=pump
  &network=solana
  &include=base_token,quote_token,dex
  &page=1

GET /api/v3/x402/onchain/networks/base/tokens/0xc0634090f2fe6c6d75e61be2b949464abb498973
  ?include=top_pools
  &include_composition=true

GET /api/v3/x402/simple/price
  ?vs_currencies=usd
  &symbols=btc,eth,sol
  &include_market_cap=true
  &include_24hr_vol=true
  &include_24hr_change=true
  &precision=full

​
Pricing & Payment

  • $0.01 USDC per request for all supported endpoints.
  • Payment networks: Base, Solana
Pricing is subject to change without notice.
Always check the latest pricing from the 402 response when generating your payment header.
Paying with Privy Wallet
Privy provides embedded and agent wallets with native x402 support — an all-in-one option for paying CoinGecko API calls.

Share Feedback

Questions or feedback about x402 endpoints? Let us know.