# CoinGecko Onchain Solana Token Price API

> CoinGecko Onchain Solana Token Price API is a paid API for AI agents from pro-api.coingecko.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns real-time DEX price and market data for tokens on the Solana network, queried by contract address.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/solana/token_price/probe
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-onchain-solana-token-price-api-b44fc7f5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7OJrsMEHqpLi0J5Ljrp9m

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability coingecko-onchain-solana-token-price-api-b44fc7f5
```

Example prompt: What's the current onchain price, market cap, and 24-hour trading volume for the Solana token at contract address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v?

## When to prefer this

Use this endpoint when you need real-time onchain price and market data for tokens deployed on the Solana blockchain, specifically queried by contract address rather than by coin name or CoinGecko ID. It is ideal when working with new or obscure Solana tokens that may not have centralized exchange listings, or when you need DEX-sourced liquidity and reserve data rather than CEX prices.

## Known failure modes

- Invalid or unrecognized contract address returns empty or null data
- Token with no active DEX liquidity on Solana returns no price data
- Inactive token may require include_inactive_source=true to retrieve data
- Missing required query parameters (contract address) returns 400 error
- Rate limiting or payment failure returns 402 or 429 error
- Token exists on a different chain than Solana, causing no results

## How this service works

Query onchain DEX token price & market data based on the provided token contract addresses on a network.

## Output

Returns a JSON object containing onchain price data for the specified Solana token contract, including current USD price, optionally market cap, 24-hour trading volume, 24-hour price change percentage, total reserve in USD, and FDV fallback data sourced from DEX pool activity on the Solana network.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "include_24hr_vol": {
       "type": "boolean"
      },
      "mcap_fdv_fallback": {
       "type": "boolean"
      },
      "include_market_cap": {
       "type": "boolean"
      },
      "include_inactive_source": {
       "type": "boolean"
      },
      "include_24hr_price_change": {
       "type": "boolean"
      },
      "include_total_reserve_in_usd": {
       "type": "boolean"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type",
    "example"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/coingecko-onchain-solana-token-price-api-b44fc7f5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from pro-api.coingecko.com](https://www.zero.xyz/host/pro-api.coingecko.com/llms.txt)
