# CoinGecko Onchain Token Price – Polygon PoS

> CoinGecko Onchain Token Price – Polygon PoS 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-16).

Returns real-time DEX token price and market data for one or more token contract addresses on the Polygon PoS network.

## Facts

- Endpoint: GET https://pro-api.coingecko.com/api/v3/x402/onchain/simple/networks/polygon_pos/token_price/:address
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/coingecko-fc2ab25d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0e3S_oahESGFRxGmWS3hu

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-fc2ab25d
```

Example prompt: What's the current on-chain price and 24-hour trading volume for the Polygon PoS token at contract address 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174? Include market cap and 24hr price change too.

## When to prefer this

Use this endpoint when you need real-time on-chain DEX prices for tokens specifically on the Polygon PoS network, identified by contract address rather than coin ID or ticker symbol. Prefer this over CoinGecko's standard coin price endpoint when the token is primarily traded on-chain via DEXes and may not have a CoinGecko coin ID. Choose this over Ethereum or Base equivalents when the token contract is on Polygon PoS.

## Known failure modes

- Token contract address not found on Polygon PoS – returns empty or null price data
- Invalid contract address format – returns 400 Bad Request
- Token has no active DEX liquidity on Polygon – returns no data or inactive source
- Payment not provided or insufficient – returns 402 Payment Required
- Rate limit exceeded – returns 429 Too Many Requests
- Network identifier mismatch – using Ethereum address on Polygon endpoint returns 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 real-time on-chain price data for the specified Polygon PoS token contract address(es), sourced from DEX liquidity pools. Can include optional fields: 24-hour trading volume, market cap, 24-hour price change percentage, and total reserve in USD, depending on query parameters.

## 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-fc2ab25d/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)