# Token Price Lookup by Symbol or Contract

> Token Price Lookup by Symbol or Contract is a paid API for AI agents from payanagent.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the current USD price for any major cryptocurrency token, identified by ticker symbol or by chain and contract address

## Facts

- Endpoint: POST https://payanagent.com/x402/kh7dxw0kj8269e3hee74av74h989hxp9
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-price-lookup-by-symbol-or-contract-8ff1b4a7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uypYFz2bAO3WrOvqOzYwp

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-lookup-by-symbol-or-contract-8ff1b4a7 -d '<json body>'
```

Example prompt: What's the current USD price of ETH? Use the token symbol to look it up.

## When to prefer this

Use this endpoint when an AI agent needs a quick, cheap ($0.001 USDC) real-time USD price for any major token — either by ticker symbol for well-known coins, or by specifying a chain and contract address for long-tail or newer DeFi tokens. Prefer it over general financial APIs when operating in an agent economy context that uses x402 micropayment protocol on Base.

## Known failure modes

- Unknown or unsupported token symbol returns an error or null price
- Invalid contract address format causes a validation error
- Unsupported blockchain network returns an error
- Token with very low liquidity or no price feed may return no result
- Network or upstream data provider outage causes timeout or 503

## How this service works

USD token price (POST wrapper, body: {symbol} or {chain, contract}) — $0.001 USDC

## Output

Returns the current USD price for the requested token, identified by ticker symbol (e.g. ETH, BTC, SOL) or by specifying a blockchain network and contract address. Response typically includes the price as a numeric USD value and may include the token name and a timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {
      "chain": {
       "type": "string",
       "description": "Chain slug: base, ethereum, solana, polygon, arbitrum, optimism, bsc, avalanche."
      },
      "symbol": {
       "type": "string",
       "description": "Token symbol (BTC, ETH, SOL, USDC, …). Mutually exclusive with chain+contract."
      },
      "contract": {
       "type": "string",
       "description": "Token contract address. Required with chain."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-price-lookup-by-symbol-or-contract-8ff1b4a7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payanagent.com](https://www.zero.xyz/host/payanagent.com/llms.txt)