Token by address
Tool ID: coingecko_token_by_address
Summary
Looks up a token from the chain it lives on and its contract or mint address. The answer includes the CoinGecko coin id, a short English description, a few links, and the US dollar price, market cap, and volume.
When to use it
- Someone pastes a 0x contract address or a Solana mint and asks what token it is.
- You need the coin id for that token before asking for its history.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| CoinGecko credential | Yes. Keys are optional. A Demo API key raises the rate limit; a Pro API key uses CoinGecko Pro. See the overview. |
Parameters
| Parameter | Required? | Description |
|---|---|---|
platform |
Yes | The chain id CoinGecko uses, such as ethereum, binance-smart-chain, or solana. |
contract_address |
Yes | The token contract or mint address. |
What you get back
The coin id, ticker, and name, the platform and address you asked about, a short description, homepage and explorer links, and the US dollar price, market cap, and volume.
Example prompts
What token is the Ethereum contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?
Identify this Solana mint and tell me its CoinGecko id.
Look up this contract on binance-smart-chain and give me the current dollar price.
Tips
- The platform is the chain, not the coin name. Ethereum tokens use ethereum.
- Use the returned id with History when you want a chart.