{"uid":"cap_1WxQd9-bXc2IkD7qDbMH8","slug":"blockrun-ai-defillama-token-price-lookup-f36746b4","name":"BlockRun.AI DeFiLlama Token Price Lookup","description":"Token price lookup. Pass coin identifiers as `/v1/defillama/prices/{coins}` (e.g. `coingecko:bitcoin`, `ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2`). Supports comma-separated lists.","url":"https://blockrun.ai/api/v1/defillama/prices/coingecko:base-protocol","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"object","properties":{"query":{"type":"object","required":[],"properties":{}}}},"output":{"type":"object","properties":{"example":{"type":"object","properties":{"data":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CwRQJvAfDJWfBQ2YgjPZF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches current token prices by coin identifier (CoinGecko slug or contract address) via the DeFiLlama price feed, supporting comma-separated multi-token queries.","exampleAgentPrompt":"What's the current price of Bitcoin and Ethereum right now? Also grab the price of WETH at contract 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Ethereum while you're at it.","exampleUseCases":[{"title":"Live portfolio valuation for DeFi holdings","prompt":"I hold coingecko:bitcoin, coingecko:ethereum, and coingecko:uniswap — can you fetch the current prices for all three so I can calculate my total portfolio value?"},{"title":"Contract address price check for on-chain token","prompt":"What's the current price of the WETH token at Ethereum contract address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2?"},{"title":"Crypto price alert bot data feed","prompt":"Fetch the latest price for coingecko:base-protocol so I can check if it's crossed my alert threshold of $0.50."}],"resultDescription":"Returns a JSON object containing the current USD price(s) for the requested coin identifiers, keyed by the coin identifier string (e.g. coingecko:bitcoin). Each entry typically includes the price value and a timestamp of when the price was last updated, sourced from the DeFiLlama price aggregator.","failureModes":["Invalid or unknown coin identifier returns an empty result or error for that token","Malformed identifier format (missing prefix like 'coingecko:') may result in no data returned","Network or upstream DeFiLlama API unavailability causes 5xx errors","Payment failure (insufficient USDC balance) results in 402 Payment Required","Rate limiting may apply if many requests are sent in rapid succession"],"whenToPreferThis":"Use this endpoint when you need real-time token price lookups across a wide range of assets including both CoinGecko-listed tokens and arbitrary ERC-20 contracts by address. It is particularly useful for DeFi-native workflows where you may have contract addresses rather than named tokens, or when you need to price multiple tokens in a single call. Prefer this over CoinGecko direct API when you want DeFiLlama's aggregated pricing and the x402 micropayment model suits your agent's billing setup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:55:35.036Z","isFirstParty":false}