{"uid":"cap_YyAikwncaIeYuNO2y5ER2","slug":"taifoon-coordination-layer-token-price-lookup-4593bf9d","name":"Taifoon Coordination Layer – Token Price Lookup","description":"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.","url":"https://coord.taifoon.dev/v1/exchanges/edge_e5123abb3523a419/call?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_x_TtNJQj5zLaHn77iZYO2","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"What's the current USD price of ETH? Use the Taifoon coordination layer token price tool.","exampleUseCases":[{"title":"DeFi portfolio valuation","prompt":"I need the current USD price of SOL so I can calculate the total value of my on-chain portfolio — can you look that up?"},{"title":"Crypto trading signal context","prompt":"Before executing this trade, grab me the latest price of BTC from Taifoon so I can confirm the market hasn't moved too much."},{"title":"Altcoin research price check","prompt":"What's the current USD price of PEAQ? I'm researching it and need a fresh market price to compare against its all-time high."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:30:55.596Z","isFirstParty":false,"canonicalSlug":"taifoon-coordination-layer-token-price-lookup-4593bf9d"}