# Token Price — Live DEX Price for Any Token Contract

> Token Price — Live DEX Price for Any Token Contract is a paid API for AI agents from api.gadgethumans.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-15).

Returns real-time USD price, 24h change, liquidity, volume, FDV, and deepest trading pair for any ERC-20 token contract address or ticker symbol, sourced from Dexscreener and CoinGecko.

## Facts

- Endpoint: GET https://api.gadgethumans.com/token-price?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-price-live-dex-price-for-any-token-contract-57c38226
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4sTMrlCakZxVKWb_DnY7q

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 token-price-live-dex-price-for-any-token-contract-57c38226
```

Example prompt: What's the current USD price, 24h change, and liquidity for the token at contract address 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed on Base? I need it before I size a swap.

## When to prefer this

Use this endpoint when you need real-time DEX-sourced token prices (not centralized exchange prices) for ERC-20 tokens across Base, Ethereum, BSC, Arbitrum, or Polygon — especially before quoting, routing, or sizing a swap. Prefer it over CoinGecko-only endpoints when you also need liquidity depth, trading pair info, and 24h DEX volume in a single call. Also ideal when you have a contract address rather than a ticker symbol.

## Known failure modes

- Unknown or unlisted contract address returns no price data
- Ticker symbol not found on CoinGecko results in resolution failure
- Token exists but has no DEX liquidity, returning null/zero values
- Unsupported chain or non-ERC-20 address causes lookup failure
- Rate limiting or upstream Dexscreener/CoinGecko outage returns error

## How this service works

Live USD price for any ERC-20 token contract address (Base, Ethereum, BSC, Arbitrum, Polygon): price, 24h change, liquidity, 24h volume, FDV and the deepest trading pair, from Dexscreener. Also accepts a ticker symbol and resolves it via CoinGecko. Use before quoting, routing or sizing a swap.

## Output

A JSON object containing the live USD price, 24h percentage price change, available liquidity in USD, 24h trading volume, fully diluted valuation (FDV), and the identifier of the deepest trading pair for the queried token, sourced from Dexscreener. If a ticker symbol is provided, it is first resolved to a contract address via CoinGecko.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "ERC-20 contract address, or a ticker symbol"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "ok": true
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-price-live-dex-price-for-any-token-contract-57c38226/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.gadgethumans.com](https://www.zero.xyz/host/api.gadgethumans.com/llms.txt)
