> ## Documentation Index
> Fetch the complete documentation index at: https://docs.b3os.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

![Get Coin by Contract Address logo](https://ai-icon.b3.fun/logo/coingecko)
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

**Workflow node**

```json
{
  "type": "coingecko-get-coin-by-contract",
  "payload": {
    "platform": "example-platform",
    "contractAddress": "0x0000000000000000000000000000000000000000"
  },
  "children": []
}
```
  **Test with API**

```bash
curl -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"
  }
}'
```

**Use expressions for dynamic values**

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.