get_coin_price
Fetch the current USD price of any cryptocurrency by ticker symbol or CoinGecko ID. Returns spot price with liquidity confidence score.
Instructions
Fetch the USD price of any well-known cryptocurrency by ticker symbol or CoinGecko ID — no contract address required. Sister tool to get_token_price; use this for non-EVM natives (BTC, LTC, SOL, TRX, XMR, DOGE, etc.) and any asset that doesn't have an EVM ERC-20 representation. Two input modes: (a) symbol — case-insensitive ticker from a curated allowlist (~120 entries covering top market-cap coins, all native chain currencies VaultPilot supports, major LSTs, top stablecoins, top DeFi governance tokens, and high-question-volume memecoins). The allowlist hardcodes the canonical CoinGecko ID per ticker so scam-token collisions can't poison the result. (b) coingeckoId — escape hatch for long-tail assets. Pass the URL slug from coingecko.com/en/coins/. Returns: { symbol, priceUsd, source: "defillama-coingecko", resolvedKey, asOf, confidence }. The confidence field is DefiLlama's 0–1 thin-liquidity score; surface it to the user when it's below 0.9. When the agent sees a portfolio response with priceMissing: true for a non-EVM asset, this is the tool to call. SCOPE: returns the current spot USD price — a snapshot, not a forecast. It is NOT a buy/sell signal, price prediction, target, or token-pick endorsement. AGENT BEHAVIOR: this tool surfaces data; it does NOT pick. Current price says nothing about future direction. Do NOT use the price to ground "what coin will 100x", "should I buy X", "best memecoin", or any other speculative-pick answer; refuse those prompts even when this tool was called. Issue #599.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | No | Ticker symbol from the curated allowlist (~115 entries; case-insensitive). Examples: "BTC", "LTC", "SOL", "DOGE", "USDC", "stETH". The allowlist hardcodes the canonical CoinGecko ID for each symbol so scam tickers can't poison the result. For assets not on the allowlist, use the `coingeckoId` field instead. | |
| coingeckoId | No | CoinGecko ID (the URL slug from coingecko.com/en/coins/<id>). Examples: "litecoin", "bitcoin", "monero". Bypasses the allowlist for long-tail assets. Pass exactly one of `symbol` or `coingeckoId`. |