---
canonical_url: "https://docs.composio.dev/toolkits/coingecko"
markdown_url: "https://docs.composio.dev/toolkits/coingecko.md"
product: "platform"
version: null
last_updated: null
---

# CoinGecko

CoinGecko provides cryptocurrency prices, market data, metadata, exchange data, NFTs, and onchain data through its Demo and paid Pro REST APIs.

- **Category:** market data
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 60
- **Triggers:** 0
- **Slug:** `COINGECKO`
- **Version:** 20261014_01
- **Instant:** Supported on the latest version. Support varies by tool.

## Tools

### Get Coin by Contract

**Slug:** `COINGECKO_GET_COIN_BY_CONTRACT`

Get CoinGecko coin metadata for a token contract on an asset platform.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contract_address` | string | Yes | Token contract address. |
| `asset_platform_id` | string | Yes | CoinGecko asset-platform ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Details

**Slug:** `COINGECKO_GET_COIN_DETAILS`

Get metadata and optionally selected market, ticker, community, and developer sections for one CoinGecko coin ID.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `coin_id` | string | Yes | CoinGecko coin ID returned by Search Assets. |
| `include_tickers` | boolean | No | Include exchange tickers. Leave false unless venue-level quotes are needed. |
| `include_sparkline` | boolean | No | Include seven-day sparkline data within market data. |
| `include_market_data` | boolean | No | Include prices, supply, market capitalization, and related market data. |
| `include_localizations` | boolean | No | Include descriptions and names in all available languages. |
| `include_community_data` | boolean | No | Include community activity metrics. |
| `include_developer_data` | boolean | No | Include repository and developer activity metrics. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin History

**Slug:** `COINGECKO_GET_COIN_HISTORY`

Get a CoinGecko coin metadata and market snapshot for one calendar date.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `date` | string | Yes | Historical snapshot date. |
| `coin_id` | string | Yes | CoinGecko coin ID. |
| `include_localization` | boolean | No | Include localized coin names. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Market Chart

**Slug:** `COINGECKO_GET_COIN_MARKET_CHART`

Get price, market-cap, and volume time series for a coin over either a relative day window or an exact Unix time range.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | string | No | Relative history window from 1 through 365 days. Use this or both timestamps, not both. |
| `coin_id` | string | Yes | CoinGecko coin ID. |
| `interval` | string ("hourly" | "daily") | No | Requested data interval when CoinGecko permits it for the selected range. |
| `precision` | string ("full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17" | "18") | No | Decimal precision for returned values. |
| `vs_currency` | string | No | Currency in which to quote the time series. |
| `to_timestamp` | integer | No | Exclusive Unix end time in seconds; required with from_timestamp when days is omitted. |
| `from_timestamp` | integer | No | Inclusive Unix start time in seconds; required with to_timestamp when days is omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin OHLC

**Slug:** `COINGECKO_GET_COIN_OHLC`

Get open, high, low, and close price candles for a CoinGecko coin over a supported day window.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | string ("1" | "7" | "14" | "30" | "90" | "180" | "365") | No | Historical day window. |
| `coin_id` | string | Yes | CoinGecko coin ID, such as bitcoin or ethereum. |
| `precision` | string ("full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17" | "18") | No | Decimal precision for candle prices. |
| `vs_currency` | string | No | Currency in which to quote candle prices. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Prices

**Slug:** `COINGECKO_GET_COIN_PRICES`

Get current prices for one or more CoinGecko coin IDs in one or more currencies, with optional market metrics.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `coin_ids` | array | Yes | CoinGecko coin IDs, such as bitcoin or ethereum. |
| `precision` | string ("full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17" | "18") | No | Decimal precision for returned prices. |
| `vs_currencies` | array | No | Currencies in which to quote each coin. |
| `include_24h_change` | boolean | No | Include 24-hour price change percentage in each requested currency. |
| `include_24h_volume` | boolean | No | Include 24-hour trading volume in each requested currency. |
| `include_market_cap` | boolean | No | Include market capitalization in each requested currency. |
| `include_last_updated_at` | boolean | No | Include the last update time as a Unix timestamp. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Tickers

**Slug:** `COINGECKO_GET_COIN_TICKERS`

Get one page of exchange tickers for a CoinGecko coin ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("trust_score_desc" | "trust_score_asc" | "volume_desc" | "volume_asc") | No | Ticker sort order. |
| `coin_id` | string | Yes | CoinGecko coin ID. |
| `page_size` | integer | No | CoinGecko's fixed number of tickers per page. |
| `next_cursor` | string | No | Opaque continuation cursor from a previous call with the same filters. |
| `exchange_ids` | string | No | Comma-separated exchange IDs. |
| `include_depth` | boolean | No | Include two-percent order-book depth. |
| `dex_pair_format` | string ("contract_address" | "symbol") | No | Format for DEX pair base and target values. |
| `include_exchange_logo` | boolean | No | Include exchange logos. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Derivative Exchange

**Slug:** `COINGECKO_GET_DERIVATIVE_EXCHANGE`

Get open interest, volume, metadata, and optional tickers for one derivative exchange.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `exchange_id` | string | Yes | Derivative exchange ID. |
| `include_tickers` | string ("all" | "unexpired") | No | Optionally include all tickers or only unexpired tickers. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Exchange

**Slug:** `COINGECKO_GET_EXCHANGE`

Get metadata, volume, top tickers, and status updates for one exchange.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `exchange_id` | string | Yes | CoinGecko exchange ID. |
| `dex_pair_format` | string ("contract_address" | "symbol") | No | Represent DEX pair assets as contract addresses or symbols. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Exchange Rates

**Slug:** `COINGECKO_GET_EXCHANGE_RATES`

Get BTC exchange rates for supported crypto, fiat, and commodity units.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Exchange Volume Chart

**Slug:** `COINGECKO_GET_EXCHANGE_VOLUME_CHART`

Get historical BTC trading-volume points for a spot or derivative exchange.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | string ("1" | "7" | "14" | "30" | "90" | "180" | "365") | Yes | Required historical day window. |
| `exchange_id` | string | Yes | Spot or derivative exchange ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Global Market Data

**Slug:** `COINGECKO_GET_GLOBAL_MARKET_DATA`

Get an aggregate snapshot for either the overall crypto market or the decentralized-finance market.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `market_scope` | string ("crypto" | "defi") | No | Aggregate market snapshot to return: crypto for the overall cryptocurrency market or defi for decentralized finance. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT by Contract

**Slug:** `COINGECKO_GET_NFT_BY_CONTRACT`

Get collection metadata and market statistics by platform and contract address.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `contract_address` | string | Yes | NFT collection contract address. |
| `asset_platform_id` | string | Yes | CoinGecko asset-platform ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get NFT by ID

**Slug:** `COINGECKO_GET_NFT_BY_ID`

Get collection metadata and market statistics by CoinGecko NFT ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `nft_id` | string | Yes | NFT collection ID from List NFTs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Pool

**Slug:** `COINGECKO_GET_ONCHAIN_POOL`

Get market and liquidity data for one pool contract on a network.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | array | No | Related base_token, quote_token, and/or dex resources to include. |
| `network_id` | string | Yes | Onchain network ID. |
| `pool_address` | string | Yes | Pool contract address. |
| `include_composition` | boolean | No | Whether to include pool composition. |
| `include_volume_breakdown` | boolean | No | Whether to include detailed pool-volume breakdowns. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Pool Info

**Slug:** `COINGECKO_GET_ONCHAIN_POOL_INFO`

Get metadata for the tokens in a pool, optionally including pool metadata.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | string | No | Set to pool to include the related pool resource. |
| `network_id` | string | Yes | Onchain network ID. |
| `pool_address` | string | Yes | Pool contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Pool OHLCV

**Slug:** `COINGECKO_GET_ONCHAIN_POOL_OHLCV`

Get bounded open, high, low, close, and volume candles for a DEX pool, with timeframe, aggregation, currency, and cutoff controls.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum number of candles to return. |
| `token` | string | No | Token to quote when currency is token: base, quote, or a token contract address. Omit to use the provider's default base-token orientation. |
| `currency` | string ("usd" | "token") | No | Quote candle prices and volume in USD or in a pool token. |
| `aggregate` | integer | No | Number of timeframe units per candle. Valid values are 1 for day; 1, 4, or 12 for hour; and 1, 5, or 15 for minute. |
| `timeframe` | string ("day" | "hour" | "minute") | No | Base candle timeframe. |
| `network_id` | string | Yes | Onchain network ID, such as eth. |
| `pool_address` | string | Yes | DEX pool contract address on the selected network. |
| `before_timestamp` | integer | No | Return candles before this Unix timestamp in seconds; omit to return the latest candles. |
| `include_empty_intervals` | boolean | No | Include intervals without trades, using the previous close for OHLC and zero volume. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Pools by Address

**Slug:** `COINGECKO_GET_ONCHAIN_POOLS_BY_ADDRESS`

Get data for one or more pool contract addresses on the same CoinGecko onchain network in a single call.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | array | No | Related resources to include: base_token, quote_token, and/or dex. |
| `network_id` | string | Yes | Onchain network ID, such as eth. |
| `pool_addresses` | array | Yes | One to 30 pool contract addresses on the selected network. |
| `include_composition` | boolean | No | Whether to include pool composition details. |
| `include_volume_breakdown` | boolean | No | Whether to include detailed pool volume breakdown fields. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Token

**Slug:** `COINGECKO_GET_ONCHAIN_TOKEN`

Get market data for one token contract on an onchain network.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | string | No | Set to top_pools to include related top-pool resources. |
| `network_id` | string | Yes | Onchain network ID. |
| `token_address` | string | Yes | Token contract address. |
| `include_composition` | boolean | No | Whether to include token composition. |
| `include_inactive_source` | boolean | No | Whether to use recent swaps from inactive pools as token data sources. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Token Info

**Slug:** `COINGECKO_GET_ONCHAIN_TOKEN_INFO`

Get metadata, links, trust data, and holder data for one token contract.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `network_id` | string | Yes | Onchain network ID. |
| `token_address` | string | Yes | Token contract address. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Token Prices

**Slug:** `COINGECKO_GET_ONCHAIN_TOKEN_PRICES`

Get current USD prices for one or more token contracts on a CoinGecko onchain network, with optional market metrics.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `network_id` | string | Yes | Onchain network ID, such as eth. |
| `token_addresses` | array | Yes | One to 30 token contract addresses on the selected network. |
| `include_24h_volume` | boolean | No | Whether to include 24-hour volume in USD by contract address. |
| `include_market_cap` | boolean | No | Whether to include market capitalization in USD by contract address. |
| `include_inactive_source` | boolean | No | Whether to include prices from inactive pools using their most recent swap. |
| `include_24h_price_change` | boolean | No | Whether to include 24-hour price change percentage by contract address. |
| `include_total_reserve_usd` | boolean | No | Whether to include total pool reserve in USD by contract address. |
| `market_cap_fallback_to_fdv` | boolean | No | Whether to use fully diluted valuation when market cap is unavailable. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Onchain Tokens by Address

**Slug:** `COINGECKO_GET_ONCHAIN_TOKENS_BY_ADDRESS`

Get market data for one or more token contract addresses on the same CoinGecko onchain network in a single call.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `network_id` | string | Yes | Onchain network ID, such as eth or solana. |
| `token_addresses` | array | Yes | One to 30 token contract addresses on the selected network. |
| `include_top_pools` | boolean | No | Whether to include each token's top pools as related resources. |
| `include_composition` | boolean | No | Whether to include token composition details. |
| `include_inactive_sources` | boolean | No | Whether to include market data from inactive liquidity sources. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Treasury Entity

**Slug:** `COINGECKO_GET_PUBLIC_TREASURY_ENTITY`

Get cryptocurrency treasury holdings and valuation data for one public company or government.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `entity_id` | string | Yes | Public company or government entity ID. |
| `holding_amount_change` | array | No | Timeframes for which to include holding amount changes. |
| `holding_change_percentage` | array | No | Timeframes for which to include holding percentage changes. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Treasury Holding Chart

**Slug:** `COINGECKO_GET_PUBLIC_TREASURY_HOLDING_CHART`

Get historical cryptocurrency holding amounts and USD values for one entity and coin.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | string ("7" | "14" | "30" | "90" | "180" | "365") | Yes | Required historical day window. |
| `coin_id` | string | Yes | CoinGecko coin ID. |
| `entity_id` | string | Yes | Entity ID. |
| `include_empty_intervals` | boolean | No | Include intervals with no transaction data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get RWA

**Slug:** `COINGECKO_GET_RWA`

Get metadata, optional token data, and optional market data for one real-world asset.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | RWA ID. |
| `tokens` | boolean | No | Include token data. |
| `sparkline` | boolean | No | Include seven-day sparkline data. |
| `perps_market_data` | boolean | No | Include aggregated perpetuals market data. |
| `tokenized_market_data` | boolean | No | Include aggregated tokenized market data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get RWA Issuer

**Slug:** `COINGECKO_GET_RWA_ISSUER`

Get market data and tokens for one real-world-asset issuer.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | RWA issuer ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token List

**Slug:** `COINGECKO_GET_TOKEN_LIST`

Get CoinGecko's token list for one asset platform.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `asset_platform_id` | string | Yes | CoinGecko asset-platform ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Market Chart

**Slug:** `COINGECKO_GET_TOKEN_MARKET_CHART`

Get price, market-cap, and volume history for a token contract.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `days` | string | Yes | Required history window as an integer or max. |
| `interval` | string ("hourly" | "daily") | No | Requested data interval. |
| `precision` | string ("full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17" | "18") | No | Decimal precision for returned values. |
| `vs_currency` | string | Yes | Required quote currency. |
| `contract_address` | string | Yes | Token contract address. |
| `asset_platform_id` | string | Yes | CoinGecko asset-platform ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Market Chart Range

**Slug:** `COINGECKO_GET_TOKEN_MARKET_CHART_RANGE`

Get token price, market-cap, and volume history for an exact Unix range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `precision` | string ("full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17" | "18") | No | Decimal precision for returned values. |
| `vs_currency` | string | Yes | Required quote currency. |
| `to_timestamp` | integer | Yes | End time in Unix seconds. |
| `from_timestamp` | integer | Yes | Inclusive start time in Unix seconds. |
| `contract_address` | string | Yes | Token contract address. |
| `asset_platform_id` | string | Yes | CoinGecko asset-platform ID. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Token Prices

**Slug:** `COINGECKO_GET_TOKEN_PRICES`

Get token prices by contract address on one CoinGecko asset platform.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `precision` | string ("full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17" | "18") | No | Decimal precision for returned prices. |
| `vs_currencies` | array | Yes | Required quote currencies. |
| `asset_platform_id` | string | Yes | CoinGecko asset-platform ID. |
| `contract_addresses` | array | Yes | Token contract addresses. |
| `include_24h_change` | boolean | No | Include 24-hour price change. |
| `include_24h_volume` | boolean | No | Include 24-hour trading volume. |
| `include_market_cap` | boolean | No | Include market capitalization. |
| `include_last_updated_at` | boolean | No | Include the last update as Unix seconds. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Trending Assets

**Slug:** `COINGECKO_GET_TRENDING_ASSETS`

Get CoinGecko's currently trending coins, NFT collections, and categories from search activity.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Asset Platforms

**Slug:** `COINGECKO_LIST_ASSET_PLATFORMS`

List CoinGecko asset platforms and their chain identifiers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filter` | string | No | Return only asset platforms relevant to NFTs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Coin Categories

**Slug:** `COINGECKO_LIST_COIN_CATEGORIES`

List CoinGecko coin categories with aggregate market data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("market_cap_desc" | "market_cap_asc" | "name_desc" | "name_asc" | "market_cap_change_24h_desc" | "market_cap_change_24h_asc") | No | Sort order for categories. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Coin Category IDs

**Slug:** `COINGECKO_LIST_COIN_CATEGORY_IDS`

List CoinGecko coin category IDs for use in category filters.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Coin Markets

**Slug:** `COINGECKO_LIST_COIN_MARKETS`

Return one ranked page of CoinGecko market data, optionally filtered by coin IDs, symbols, or category. Use next_cursor to continue.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("market_cap_asc" | "market_cap_desc" | "volume_asc" | "volume_desc" | "id_asc" | "id_desc") | No | Sort order for the returned market page. |
| `symbols` | array | No | Optional coin symbols to include. Prefer coin_ids when possible. |
| `coin_ids` | array | No | Optional CoinGecko coin IDs to include. Coin IDs are less ambiguous than symbols. |
| `page_size` | integer | No | Maximum number of coins to return in this page (1-250). |
| `category_id` | string | No | Optional CoinGecko category ID to restrict the market. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. Omit for the first page and reuse the same filters. |
| `vs_currency` | string | No | Currency in which to quote prices and market values. |
| `include_sparkline` | boolean | No | Whether to include seven-day sparkline price values. |
| `price_change_periods` | array | No | Price-change periods to include, such as 1h, 24h, 7d, 30d, or 1y. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Coins

**Slug:** `COINGECKO_LIST_COINS`

List CoinGecko coin IDs, symbols, names, and optional platform contracts.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("active" | "inactive") | No | Filter coins by listing status. |
| `include_platform` | boolean | No | Include platform IDs and token contract addresses. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Derivative Exchange IDs

**Slug:** `COINGECKO_LIST_DERIVATIVE_EXCHANGE_IDS`

List CoinGecko derivative exchange IDs and names.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Derivative Exchanges

**Slug:** `COINGECKO_LIST_DERIVATIVE_EXCHANGES`

List derivative exchanges with open interest and trading data. Use next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("name_asc" | "name_desc" | "open_interest_btc_asc" | "open_interest_btc_desc" | "trade_volume_24h_btc_asc" | "trade_volume_24h_btc_desc") | No | Sort order for derivative exchanges. |
| `page_size` | integer | No | Results per page. |
| `next_cursor` | string | No | Opaque continuation cursor from a previous call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Derivative Tickers

**Slug:** `COINGECKO_LIST_DERIVATIVE_TICKERS`

List all derivative tickers tracked by CoinGecko.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Entities

**Slug:** `COINGECKO_LIST_ENTITIES`

List one page of public companies and governments tracked for crypto treasury holdings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Maximum entities to return in this page (1-250). |
| `entity_type` | string ("company" | "government") | No | Filter entities by company or government type. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a previous call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Exchange IDs

**Slug:** `COINGECKO_LIST_EXCHANGE_IDS`

List CoinGecko exchange IDs and names, filtered by active or inactive status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("active" | "inactive") | No | Exchange status to return. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Exchanges

**Slug:** `COINGECKO_LIST_EXCHANGES`

List active exchanges with metadata, trust scores, and volume. Use next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page_size` | integer | No | Results per page, from 1 through 250. |
| `next_cursor` | string | No | Opaque continuation cursor from a previous call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Exchange Tickers

**Slug:** `COINGECKO_LIST_EXCHANGE_TICKERS`

List tickers for one exchange with optional filters, depth, and ordering. Use next_cursor to continue.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `depth` | boolean | No | Include the cost to move the order book by two percent. |
| `order` | string ("market_cap_asc" | "market_cap_desc" | "trust_score_desc" | "trust_score_asc" | "volume_desc" | "volume_asc" | "base_target") | No | Ticker sort order. |
| `coin_ids` | string | No | Comma-separated CoinGecko coin IDs to include. |
| `page_size` | integer | No | CoinGecko's fixed number of tickers per page. |
| `exchange_id` | string | Yes | CoinGecko exchange ID. |
| `next_cursor` | string | No | Opaque continuation cursor from a previous call. |
| `dex_pair_format` | string ("contract_address" | "symbol") | No | Represent DEX pair assets as contract addresses or symbols. |
| `include_exchange_logo` | boolean | No | Include the exchange logo in market data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List New Onchain Pools

**Slug:** `COINGECKO_LIST_NEW_ONCHAIN_POOLS`

Return one page of newly created DEX pools across all networks or within one network. Use next_cursor to continue through numbered pages available on the CoinGecko Demo plan. This is a rapidly changing newest-first feed, so continuation pages can overlap or omit pools and are not a stable snapshot.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | array | No | Related resources to include: base_token, quote_token, and/or dex. |
| `network_id` | string | No | Optional onchain network ID, such as eth. Omit to return new pools across all networks. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a prior call. Omit for the first page and reuse the same network and include options when continuing. Because this newest-first feed changes continuously, later pages may overlap or omit pools seen during the same traversal. |
| `include_community_data` | boolean | No | Include GeckoTerminal community vote and suspicious-report data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List NFTs

**Slug:** `COINGECKO_LIST_NFTS`

Return one page of NFT collections supported by CoinGecko.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("h24_volume_usd_asc" | "h24_volume_usd_desc" | "h24_volume_native_asc" | "h24_volume_native_desc" | "floor_price_native_asc" | "floor_price_native_desc" | "market_cap_native_asc" | "market_cap_native_desc" | "market_cap_usd_asc" | "market_cap_usd_desc") | No | Sort order. |
| `page_size` | integer | No | Results per page. CoinGecko accepts 1 through 250. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a prior call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Onchain DEXes

**Slug:** `COINGECKO_LIST_ONCHAIN_DEXES`

Return one page of decentralized exchanges supported on a network.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `network_id` | string | Yes | Onchain network ID from List Onchain Networks. |
| `next_cursor` | string | No | Opaque continuation cursor returned by a prior call. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Onchain Networks

**Slug:** `COINGECKO_LIST_ONCHAIN_NETWORKS`

Return one page of supported onchain network IDs and their CoinGecko asset-platform mappings.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `next_cursor` | string | No | Opaque continuation cursor returned by a prior call. Omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Onchain Pools

**Slug:** `COINGECKO_LIST_ONCHAIN_POOLS`

Return one ranked page of pools for a network, optionally restricted to one DEX or one token contract. Use next_cursor to continue through the pages available on the CoinGecko Demo plan.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | string ("h24_volume_usd_desc" | "h24_tx_count_desc") | No | Rank pools by 24-hour USD volume or transaction count. |
| `dex_id` | string | No | Restrict results to this DEX ID. Mutually exclusive with token_address. |
| `include` | array | No | Related resources to include: base_token, quote_token, and/or dex. |
| `network_id` | string | Yes | Onchain network ID, such as eth. |
| `next_cursor` | string | No | Continuation cursor returned by a prior call. Omit for the first page and reuse the same filters when continuing. |
| `token_address` | string | No | Restrict results to pools containing this token contract. Mutually exclusive with dex_id. |
| `include_community_data` | boolean | No | Include GeckoTerminal community vote and suspicious-report data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Onchain Pool Trades

**Slug:** `COINGECKO_LIST_ONCHAIN_POOL_TRADES`

List up to 300 of a CoinGecko onchain pool's trades from the past 24 hours, optionally filtered by minimum USD volume or token side.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `token` | string | No | Return trades for base, quote, or a non-empty token contract address. |
| `network_id` | string | Yes | Onchain network ID, such as eth. |
| `pool_address` | string | Yes | DEX pool contract address. |
| `minimum_trade_volume_usd` | number | No | Only include trades above this USD volume. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Treasury Holders

**Slug:** `COINGECKO_LIST_PUBLIC_TREASURY_HOLDERS`

List one page of companies or governments holding a specified cryptocurrency.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("total_holdings_usd_desc" | "total_holdings_usd_asc") | No | Holder sort order. |
| `entity` | string ("companies" | "governments") | Yes | Entity collection to return. |
| `coin_id` | string | Yes | CoinGecko coin ID. |
| `page_size` | integer | No | Maximum holders in this page (1-250). |
| `next_cursor` | string | No | Opaque continuation cursor. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Public Treasury Transactions

**Slug:** `COINGECKO_LIST_PUBLIC_TREASURY_TRANSACTIONS`

List one page of cryptocurrency treasury transactions for a public company or government.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order` | string ("date_desc" | "date_asc" | "holding_net_change_desc" | "holding_net_change_asc" | "transaction_value_usd_desc" | "transaction_value_usd_asc" | "average_cost_desc" | "average_cost_asc") | No | Transaction sort order. |
| `coin_ids` | array | No | Coin IDs by which to filter transactions. |
| `entity_id` | string | Yes | Entity ID. |
| `page_size` | integer | No | Maximum transactions in this page (1-250). |
| `next_cursor` | string | No | Opaque continuation cursor. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Recently Updated Onchain Tokens

**Slug:** `COINGECKO_LIST_RECENTLY_UPDATED_ONCHAIN_TOKENS`

Return the 100 token metadata records most recently updated by GeckoTerminal.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | string | No | Set to network to include related network resources. |
| `network` | string | No | Optional onchain network ID filter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List RWA Issuers

**Slug:** `COINGECKO_LIST_RWA_ISSUERS`

List real-world-asset issuers supported by CoinGecko.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List RWA Markets

**Slug:** `COINGECKO_LIST_RWA_MARKETS`

List one page of tokenized real-world assets with aggregated market data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ids` | array | No | RWA IDs to include. |
| `names` | array | No | RWA names to include. |
| `order` | string ("market_cap_asc" | "market_cap_desc" | "volume_asc" | "volume_desc" | "id_asc" | "id_desc") | No | Market result sort order. |
| `issuer` | string | No | Issuer ID by which to filter. |
| `symbols` | array | No | RWA symbols to include. |
| `page_size` | integer | No | Maximum RWAs in this page (1-250). |
| `precision` | string ("full" | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "10" | "11" | "12" | "13" | "14" | "15" | "16" | "17" | "18") | No | Decimal precision for currency prices. |
| `sparkline` | boolean | No | Include seven-day sparkline data. |
| `asset_type` | string ("stock" | "commodity" | "etf") | No | Filter by RWA asset type. |
| `next_cursor` | string | No | Opaque continuation cursor. |
| `price_change_percentage` | array | No | Price-change periods to include. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List RWAs

**Slug:** `COINGECKO_LIST_RWAS`

List tokenized real-world assets supported by CoinGecko.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `asset_type` | string ("stock" | "commodity" | "etf") | No | Filter by RWA asset type. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Supported Currencies

**Slug:** `COINGECKO_LIST_SUPPORTED_CURRENCIES`

List currencies accepted as quote currencies by CoinGecko price endpoints.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Trending Onchain Pools

**Slug:** `COINGECKO_LIST_TRENDING_ONCHAIN_POOLS`

Return one page of currently trending DEX pools across all networks or within one network and duration window. Use next_cursor to continue through the pages available on the CoinGecko Demo plan.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include` | array | No | Related resources to include: base_token, quote_token, and/or dex. |
| `duration` | string ("5m" | "1h" | "6h" | "24h") | No | Trend window used to rank pools. |
| `network_id` | string | No | Optional onchain network ID. Omit to rank pools across all networks. |
| `next_cursor` | string | No | Continuation cursor returned by a prior call. Omit for the first page and reuse the same network and filters when continuing. |
| `include_community_data` | boolean | No | Include GeckoTerminal community vote and suspicious-report data. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Ping CoinGecko Server

**Slug:** `COINGECKO_PING_SERVER`

Check whether the CoinGecko Demo API server is responding.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Assets

**Slug:** `COINGECKO_SEARCH_ASSETS`

Search CoinGecko for matching coins, exchanges, categories, and NFT collections. Use returned coin IDs with coin detail and market tools, and category IDs with List Coin Markets.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Name, symbol, or phrase to search for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Onchain Pools

**Slug:** `COINGECKO_SEARCH_ONCHAIN_POOLS`

Search decentralized-exchange pools and tokens by name, symbol, or contract address, optionally within one network. Returns one page and related token or DEX resources; use next_cursor to continue.

**Instant:** Supported on the latest version.

**Instant pricing:** $0.003 per 10 successful requests

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | Pool name, token symbol, token name, or contract address to search. |
| `include` | array | No | Related resources to include: base_token, quote_token, and/or dex. |
| `network_id` | string | No | Optional CoinGecko onchain network ID, such as eth. |
| `next_cursor` | string | No | Continuation cursor returned by a prior call. Omit for the first page and reuse the same search filters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |