# Taifoon Coordination Layer – Token Price Lookup

> Taifoon Coordination Layer – Token Price Lookup is a paid API for AI agents from coord.taifoon.dev, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Fetches the latest USD price for a given token (ETH, BTC, SOL, SEI, PEAQ, etc.) via CoinGecko ID or symbol through the Taifoon coordination layer.

## Facts

- Endpoint: POST https://coord.taifoon.dev/v1/exchanges/edge_e5123abb3523a419/call?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/taifoon-coordination-layer-token-price-lookup-4593bf9d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YyAikwncaIeYuNO2y5ER2

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 taifoon-coordination-layer-token-price-lookup-4593bf9d -d '<json body>'
```

Example prompt: What's the current USD price of ETH? Use the Taifoon coordination layer token price tool.

## When to prefer this

Choose this endpoint when you need a programmatic, pay-per-call token price lookup routed through the Taifoon coordination layer — especially in agentic workflows that already use x402 micropayments, or when you need CoinGecko prices for niche tokens like SEI or PEAQ alongside mainstream assets in a single unified API surface.

## Known failure modes

- Unknown or unsupported token symbol returns an error or empty result
- Missing or invalid API key (X-API-Key) causes a 401/403 response
- Malformed token field (e.g. empty string) rejected by schema validation
- Network or upstream CoinGecko unavailability causes a timeout or 502
- Exceeding rate limits for the x402 payment tier returns a quota error

## How this service works

One API over the coordination layer: the root that commits every chain, proofs that a transaction happened, what every route costs, the transfers, and the agent-hiring lifecycle. Most operations are public reads. Writes say who may make them in `security` (RelayerKey = X-API-Key, OperatorToken = x-operator-token) and in x-taifoon-auth.rule; nothing here signs or sends a transaction for you. A 2xx JSON object answered to a caller that sent no key also carries `get_key` (and the headers x-taifoon-get-key and Link rel=free-key): how to get a free key in one call; proofs, evidence packs, cards and this document are left as written. Lineage language: a sale walks offer in → classify → listed → hired → delivered → graded → settled → legs written → accrued → split → PAID → recorded; a venue adapter has offer.in · offer.out · job.in · job.out; the seller of record pays on by forward · share · period · markup; a leg is Owed → Reserved → Sent | Held | Refunded; a hop reads OK · HELD · MISSING · BROKEN. On the wire the hop ids are the event field step and the metric label stage; a wire name is never renamed.

## Output

A JSON object containing ok status, the edge_id, a delivery block with status/handshake_id/reply_digest, and a meter_line showing payment method and edge state. The actual token price is embedded in the reply payload under delivery.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "args": {
   "type": "object",
   "required": [
    "token"
   ],
   "properties": {
    "token": {
     "type": "string",
     "description": "Token symbol (ETH, BTC, SOL, SEI, PEAQ...) or CoinGecko ID"
    }
   }
  },
  "task": {
   "type": "string",
   "maxLength": 4000,
   "minLength": 1
  },
  "tool": {
   "type": "string",
   "const": "get_token_price"
  },
  "class": {
   "type": "string",
   "const": "market.price"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "edge_id": "edge_e5123abb3523a419",
  "delivery": {
   "status": "ready",
   "handshake_id": "hs_…",
   "reply_digest": "0x…"
  },
  "meter_line": {
   "paid": {
    "by": "x402",
    "units": "3000"
   },
   "edge_state": "quoted",
   "agreement_basis": "house_unsigned"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/taifoon-coordination-layer-token-price-lookup-4593bf9d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from coord.taifoon.dev](https://www.zero.xyz/host/coord.taifoon.dev/llms.txt)