On-Demand Crypto Price & Market Data (x402)

x402-enabled, instant, pay-per-use crypto price & market data endpoints. Access with native crypto payment, no key or account required.

These are experimental endpoints. Their features, pricing, and availability are subject to change without prior notice. For production systems, we strongly advise using the stable, standard subscription endpoints.

If you have any questions or feedback, please share with us here.

x402 Overview

x402 is a new open payment protocol developed by Coinbase that enables instant, automatic stablecoin payments directly over HTTP. Learn more about x402 here.

How It Works

Make Request

Make a request to the x402-enabled endpoint. The server returns payment requirements with a 402 response.

Sign

Your wallet signs a USDC authorization for the requested amount.

Pay & Get Data

Send the signed payment header and receive the data you requested.

Authentication

To access CoinGecko API with x402, you can follow the simple steps below:

Set up an x402 client by following the official x402 Quickstart for Buyers
Use the x402 Path: Call any supported endpoint by inserting /x402/ immediately after the version segment (/v3/) in the URL path.

Reminder

Do not send x-cg-pro-api-key or x-cg-demo-api-key, as an API key is not required.
Root URL for the endpoints: All x402 requests must use the base path:
pro-api.coingecko.com/api/v3/x402/...

Supported Endpoints

Endpoints	Description & Endpoint Path
Onchain: Simple Token Price	To get token price & market data based on the provided token contract addresses on a network. `/x402/onchain/simple/networks/{id}/token_price/{address}`
Onchain: Search Pools	To search pools and tokens, by contract address, name or token symbol. `/x402/onchain/search/pools`
Onchain: Trending Pools by Network	To query the latest trending pools & tokens based on a provided network. `/x402/onchain/networks/{id}/trending_pools`
Onchain: Token Data by Token Address	To query the latest price, liquidity, and market data of a token, based on the provided token contract address on a network `/x402/onchain/networks/{network}/tokens/{address}`
CoinGecko: Simple Price	To get token price & market data of coins listed on CoinGecko.com, via symbol or unique coin IDs. `/x402/simple/price` Get full list of coin IDs via CSV, or GSheet.

All parameters from the CoinGecko Pro API endpoints are supported. For the complete list of available parameters, features, limits, and payload data, please refer to the Pro API References of respective endpoints.
For Onchain endpoint requests that require network_id, you may check for the full list of network IDs via CSV or GSheet. We cover more than 250 networks, the widest coverage in the industry!
If you wish to learn more details about how to use CoinGecko API x402 endpoints, please visit this guide.

Request URL Examples:

Example 1: Get VIRTUALS and WETH tokens data on Base network:

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

Example 2: Search tokens and pools data on Solana network, with name, symbol, or contract address:

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

Example 3: Get the top trending tokens and pools data on Base network, in the last 5 minutes:

GET /api/v3/x402/onchain/networks/base/trending_pools
  ?page=1
  &duration=5m
  &include_gt_community_data=true
  &include=base_token,quote_token,dex

Example 4: Get KEETA price, liquidity, market data and more on Base network:

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

Example 5: Get USD price & market data of Bitcoin, Ethereum and Solana, by symbols:

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

Pricing & Payment Method

Current price: $0.01 USDC per API request, for all endpoints stated above.

Pricing Notice: The current pricing of $0.01 USDC per request is subject to change at any time without prior notice. Please check the latest pricing when generating your payment header.

Each search request is charged on a pay-per-use basis using cryptocurrency through the payment header system.

Network supported:

Base
Solana

Paying with Privy Wallet

Privy provides embedded and agent wallets that natively support x402, making them an all-in-one option for paying for CoinGecko API calls.

Request Example

curl --request GET \
  --url 'https://pro-api.coingecko.com/api/v3/x402/onchain/networks/eth/tokens/0xdac17f958d2ee523a2206206994597c13d831ec7?include_composition=true' \
  -H 'PAYMENT-SIGNATURE: {{paymentSignature}}' \

Response Example

Please refer to the respective endpoint documentation for full parameter and payload support.

expandable

{
  "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"
          }
        }
      }
    }
  ]
}