# CoinGecko Onchain Token Price - HyperEVM Network

> CoinGecko Onchain Token Price - HyperEVM Network 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-15).

Fetches real-time DEX token price and market data for a given token contract address on the HyperEVM network via CoinGecko's onchain data feed.

## Facts

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

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-37782a39
```

Example prompt: What's the current onchain price, 24-hour volume, and market cap for the token at contract address 0xABC123... on HyperEVM? Use CoinGecko's onchain DEX data and include the 24hr price change too.

## When to prefer this

Use this endpoint when you specifically need onchain DEX-sourced price data for tokens on the HyperEVM network by contract address. Prefer this over CeFi/exchange price endpoints when dealing with newly listed or long-tail tokens that trade primarily on DEXes and may not be listed on centralized exchanges. Choose this over other CoinGecko onchain endpoints when the target network is HyperEVM specifically.

## Known failure modes

- Token contract address not found on HyperEVM — returns empty or null data
- Invalid contract address format — returns 400 or empty result
- Token exists but has no active DEX liquidity — may return stale or missing price
- Payment not included or invalid — returns 402 Payment Required
- Rate limit exceeded — returns 429
- Network identifier mismatch — wrong network returns no data

## 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 the USD price of the specified token contract on HyperEVM, along with optionally requested fields such as 24hr trading volume, market cap, 24hr price change percentage, and total reserve in USD, all sourced from onchain DEX liquidity pools.

## 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-37782a39/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)