# ERC20 Token USD Price Lookup

> ERC20 Token USD Price Lookup is a paid API for AI agents from twin.unykorn.org, paid per call via x402, $0.004/call, status unknown (last checked 2026-10-01).

Returns the current USD price of an ERC20 token given its contract address and chain

## Facts

- Endpoint: POST https://twin.unykorn.org/token-price?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc20-token-usd-price-lookup-533cebf2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dcROP3SsInH6KB3UCvsOf

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 erc20-token-usd-price-lookup-533cebf2 -d '<json body>'
```

Example prompt: What's the current USD price of the USDC token at contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?

## When to prefer this

Use this endpoint when you need a quick, on-demand USD price for any ERC20 token across ten major EVM chains (Ethereum, Base, Polygon, Arbitrum, Optimism, BSC, Avalanche, Gnosis, Linea, Scroll) and have the token's contract address. It is ideal for per-call, real-time price fetches rather than bulk historical data or streaming price feeds. Prefer this over general-purpose DEX aggregators when working in a pay-per-use agentic context with the x402 payment protocol.

## Known failure modes

- Invalid contract address format (not matching 0x[40 hex chars] pattern) returns a validation error
- Unsupported chain not in the allowed enum returns an error
- Token contract not found or not an ERC20 on the specified chain may return an error or null price
- Payment of 0.004 USDC not received results in 402 Payment Required
- Network timeouts or RPC failures on the target chain may cause transient errors

## How this service works

Current USD price of an ERC20 token — Genesis402 / UnyKorn Operator Network

## Output

Returns a JSON object with ok status, the token type identifier, a receipt containing transaction hash, amount paid in USD, and a receipt ID, plus a generated_at ISO8601 timestamp. The actual USD price of the token is included in the response payload.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "params": {
   "type": "object",
   "properties": {
    "chain": {
     "enum": [
      "ethereum",
      "base",
      "polygon",
      "arbitrum",
      "optimism",
      "bsc",
      "avalanche",
      "gnosis",
      "linea",
      "scroll"
     ],
     "type": "string"
    },
    "contract": {
     "type": "string",
     "pattern": "^0x[0-9a-fA-F]{40}$"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "type": "token-price",
  "receipt": {
   "tx_hash": "0x<64hex>",
   "amount_usd": 0.004,
   "receipt_id": "g402-<16hex>"
  },
  "generated_at": "<iso8601>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc20-token-usd-price-lookup-533cebf2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twin.unykorn.org](https://www.zero.xyz/host/twin.unykorn.org/llms.txt)