Get Coin by Contract Address
Get detailed coin information by contract address on a specific blockchain (Ethereum, Polygon, Base, etc.). Returns CoinGecko ID, symbol, name, description, website links, social links, market data, and community stats. Use to resolve contract addresses to full coin metadata. Ideal for: token lookups by contract, cross-referencing on-chain tokens with CoinGecko data, enriching wallet holdings with metadata.
Catalog action Blockchain Data
Get detailed coin information by contract address on a specific blockchain (Ethereum, Polygon, Base, etc.). Returns CoinGecko ID, symbol, name, description, website links, social links, market data, and community stats. Use to resolve contract addresses to full coin metadata. Ideal for: token lookups by contract, cross-referencing on-chain tokens with CoinGecko data, enriching wallet holdings with metadata.
At a Glance
| Field | Value |
|---|---|
| Action ID | coingecko-get-coin-by-contract |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coingecko, coin, contract, token, address, lookup, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
platform | string | Yes | Asset platform ID (e.g., 'ethereum', 'polygon-pos', 'arbitrum-one', 'base'). See /asset_platforms endpoint for full list. |
contractAddress | string | Yes | Token contract address on the specified platform. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
coin | object | Yes | - |
Examples
json{ "type": "coingecko-get-coin-by-contract", "payload": { "platform": "example-platform", "contractAddress": "0x0000000000000000000000000000000000000000" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/coingecko-get-coin-by-contract/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "platform": "example-platform", "contractAddress": "0x0000000000000000000000000000000000000000" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.