# CoinGecko — Orthogonal API

> Pay-per-use API on Orthogonal. Each call is billed to your Orthogonal balance.
> Base API: `https://api.orthogonal.com/v1/run` · [llms.txt](https://orthogonal.com/llms.txt) · [browse all APIs](https://orthogonal.com/discover)

Crypto market data from CoinGecko: real-time and historical prices, market caps, OHLC charts, coin and token metadata, exchanges, derivatives, NFTs, RWAs, public treasuries, news, and GeckoTerminal on-chain DEX data (pools, tokens, trades, holders, wallets) across 200+ networks.

**Verified:** no

## Access

**Run API:** `POST https://api.orthogonal.com/v1/run`
**Auth:** `Authorization: Bearer $ORTHOGONAL_API_KEY`
Get an API key at https://orthogonal.com/dashboard/settings/api-keys

Every call goes through the unified Run API: send the API `slug`, the endpoint `path`, and the `query`/`body` parameters. The response is `{ "success": true, "price": "<usd>", "data": { ... } }`.

## Endpoints

### Trending Search List

Query trending search coins, NFTs and categories on CoinGecko in the last 24 hours.

`GET /search/trending`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `show_max` | string | No | Show max number of results available for the given type. Available values: coins, nfts, categories e.g. coins or coins,nfts,categories |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/search/trending","method":"GET","query":{"show_max":"<string>"}}'
```

### Search Queries

Search for coins, categories and markets listed on CoinGecko.

`GET /search`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/search","method":"GET","query":{"query":"<string>"}}'
```

### Currencies List

Query all the supported currencies on CoinGecko.

`GET /simple/supported_vs_currencies`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/simple/supported_vs_currencies","method":"GET"}'
```

### Coin Tickers by ID

Query the coin tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular coin ID.

`GET /coins/{id}/tickers`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `exchange_ids` | string | No | Exchange ID. *refers to /exchanges/list |
| `include_exchange_logo` | boolean | No | Include exchange logo. Default: false |
| `page` | integer | No | Page through results |
| `order` | string | No | Sort the order of responses. Default: trust_score_desc |
| `depth` | boolean | No | Include 2% orderbook depth, i.e. cost_to_move_up_usd and cost_to_move_down_usd. Default: false |
| `dex_pair_format` | string | No | Set to symbol to display DEX pair base and target as symbols. Default: contract_address |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/tickers","method":"GET","query":{"exchange_ids":"<string>","include_exchange_logo":"<boolean>","page":"<integer>","order":"<string>","depth":"<boolean>","dex_pair_format":"<string>"}}'
```

### Coin Historical Data by ID

Query the historical data (price, market cap, 24hrs volume, etc.) at a given date for a coin based on a particular coin ID. Historical data is limited to the past 2 years; days=max or older dates return an error.

`GET /coins/{id}/history`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `date` | string | Yes | The date of data snapshot. Format: YYYY-MM-DD |
| `localization` | boolean | No | Include all the localized languages in response. Default: true |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/history","method":"GET","query":{"date":"<string>","localization":"<boolean>"}}'
```

### Derivatives Exchange Data by ID

Query the derivatives exchange's related data (name, open interest, trade volume, ...) based on the exchange's ID.

`GET /derivatives/exchanges/{id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include_tickers` | string | No | Include tickers data. Default: tickers data is not included. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/derivatives/exchanges/{id}","method":"GET","query":{"include_tickers":"<string>"}}'
```

### Coin OHLC Chart by ID

Get the OHLC chart (Open, High, Low, Close) of a coin based on particular coin ID. Historical data is limited to the past 2 years; days=max or older dates return an error.

`GET /coins/{id}/ohlc`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `vs_currency` | string | Yes | Target currency of price data. *refers to /simple/supported_vs_currencies. |
| `days` | string | Yes | Data up to number of days ago. |
| `interval` | string | No | Data interval, leave empty for auto granularity. |
| `precision` | string | No | Decimal place for currency price value. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/ohlc","method":"GET","query":{"vs_currency":"<string>","days":"<string>","interval":"<string>","precision":"<string>"}}'
```

### Coin Data by Token Address

Query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin based on an asset platform and a particular token contract address.

`GET /coins/{id}/contract/{contract_address}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `contract_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {id}, {contract_address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/contract/{contract_address}","method":"GET"}'
```

### Coin Historical Chart Data by ID

Get the historical chart data of a coin including time in UNIX, price, market cap and 24hrs volume based on particular coin ID. Historical data is limited to the past 2 years; days=max or older dates return an error. interval accepts daily or hourly (leave empty for auto granularity); 5m and 1m are not available.

`GET /coins/{id}/market_chart`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `vs_currency` | string | Yes | Target currency of market data. *refers to /simple/supported_vs_currencies. |
| `days` | string | Yes | Data up to number of days ago. Any integer up to 730 (2 years). |
| `interval` | string | No | Data interval: daily or hourly. Leave empty for auto granularity. |
| `precision` | string | No | Decimal place for currency price value. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/market_chart","method":"GET","query":{"vs_currency":"<string>","days":"<string>","interval":"<string>","precision":"<string>"}}'
```

### Coin Historical Chart Data by Token Address

Get the historical chart data including time in UNIX, price, market cap and 24hrs volume based on asset platform and particular token contract address. Historical data is limited to the past 2 years; days=max or older dates return an error. interval accepts daily or hourly (leave empty for auto granularity); 5m and 1m are not available.

`GET /coins/{id}/contract/{contract_address}/market_chart`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `contract_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `vs_currency` | string | Yes | Target currency of market data. *refers to /simple/supported_vs_currencies. |
| `days` | string | Yes | Data up to number of days ago. Any integer up to 730 (2 years). |
| `interval` | string | No | Data interval: daily or hourly. Leave empty for auto granularity. |
| `precision` | string | No | Decimal place for currency price value. |

```bash
# Replace {id}, {contract_address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/contract/{contract_address}/market_chart","method":"GET","query":{"vs_currency":"<string>","days":"<string>","interval":"<string>","precision":"<string>"}}'
```

### Coins List

Query all the supported coins on CoinGecko with coin ID, name and symbol.

`GET /coins/list`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include_platform` | boolean | No | Include platform and token's contract addresses. Default: false |
| `status` | string | No | Filter by status of coins. Default: active |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/list","method":"GET","query":{"include_platform":"<boolean>","status":"<string>"}}'
```

### Asset Platforms List

Query all the supported asset platforms (blockchain networks) on CoinGecko.

`GET /asset_platforms`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filter` | string | No | Apply relevant filters to results. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/asset_platforms","method":"GET","query":{"filter":"<string>"}}'
```

### Token Lists by Asset Platform ID

Get full list of tokens of a blockchain network (asset platform) that is supported by Ethereum token list standard.

`GET /token_lists/{asset_platform_id}/all.json`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_platform_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {asset_platform_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/token_lists/{asset_platform_id}/all.json","method":"GET"}'
```

### Coins Categories List

Query all the supported coins categories on CoinGecko.

`GET /coins/categories/list`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/categories/list","method":"GET"}'
```

### Coins Categories List with Market Data

Query all the coins categories with market data (market cap, volume, etc.) on CoinGecko.

`GET /coins/categories`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order` | string | No | Sort results by field. Default: market_cap_desc |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/categories","method":"GET","query":{"order":"<string>"}}'
```

### RWA List

Query all the supported tokenized real world assets (RWAs) on CoinGecko with RWA ID, name and symbol.

`GET /rwas/list`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_type` | string | No | Filter by RWA asset type. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/rwas/list","method":"GET","query":{"asset_type":"<string>"}}'
```

### RWA Data by ID

Query all the metadata, market data and tokens of a RWA based on a particular RWA ID.

`GET /rwas/{id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `sparkline` | boolean | No | Include sparkline 7-day data. Default: false |
| `tokens` | boolean | No | Include tokens data. Default: false |
| `tokenized_market_data` | boolean | No | Include tokenized market data. Default: false |
| `perps_market_data` | boolean | No | Include perpetuals market data. Default: false |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/rwas/{id}","method":"GET","query":{"sparkline":"<boolean>","tokens":"<boolean>","tokenized_market_data":"<boolean>","perps_market_data":"<boolean>"}}'
```

### Derivatives Exchanges List

Query all the supported derivatives exchanges with ID and name on CoinGecko.

`GET /derivatives/exchanges/list`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/derivatives/exchanges/list","method":"GET"}'
```

### Entities List

Query all the supported entities on CoinGecko with entity ID, name, symbol, and country.

`GET /entities/list`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_type` | string | No | Filter by entity type. |
| `per_page` | integer | No | Total results per page. Default value: 100 Valid values: 1...250 |
| `page` | integer | No | Page through results. Default value: 1 |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/entities/list","method":"GET","query":{"entity_type":"<string>","per_page":"<integer>","page":"<integer>"}}'
```

### RWA Issuers List

Query all the supported RWA issuers on CoinGecko.

`GET /rwas/issuers/list`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/rwas/issuers/list","method":"GET"}'
```

### RWA Issuer Data by ID

Query the market data (market cap, volume, etc.) and tokens of an issuer based on a particular issuer ID.

`GET /rwas/issuers/{id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/rwas/issuers/{id}","method":"GET"}'
```

### Exchanges List with Data

Query all the supported exchanges with exchanges' data (ID, name, country, etc.) that have active trading volumes on CoinGecko.

`GET /exchanges`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `per_page` | number | No | Total results per page. Default: 100. Valid values: 1...250 |
| `page` | number | No | Page through results. Default: 1 |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/exchanges","method":"GET","query":{"per_page":"<number>","page":"<number>"}}'
```

### Exchanges List

Query all the supported exchanges with ID and name.

`GET /exchanges/list`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `status` | string | No | Filter by status of exchanges. Default: active |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/exchanges/list","method":"GET","query":{"status":"<string>"}}'
```

### Exchange Data by ID

Query exchange's data (name, year established, country, etc.), exchange volume in BTC and top 100 tickers based on exchange's ID.

`GET /exchanges/{id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `dex_pair_format` | string | No | Set to symbol to display DEX pair base and target as symbols. Default: contract_address |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/exchanges/{id}","method":"GET","query":{"dex_pair_format":"<string>"}}'
```

### Exchange Tickers by ID

Query exchange's tickers based on exchange's ID.

`GET /exchanges/{id}/tickers`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `coin_ids` | string | No | Filter tickers by coin IDs, comma-separated if querying more than 1 coin. *refers to /coins/list. |
| `include_exchange_logo` | boolean | No | Include exchange logo. Default: false |
| `page` | number | No | Page through results. |
| `depth` | boolean | No | Include 2% orderbook depth (cost_to_move_up_usd and cost_to_move_down_usd). Default: false |
| `order` | string | No | Sort the order of responses. Default: trust_score_desc |
| `dex_pair_format` | string | No | Set to symbol to display DEX pair base and target as symbols. Default: contract_address |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/exchanges/{id}/tickers","method":"GET","query":{"coin_ids":"<string>","include_exchange_logo":"<boolean>","page":"<number>","depth":"<boolean>","order":"<string>","dex_pair_format":"<string>"}}'
```

### Derivatives Tickers List

Query all the tickers from derivatives exchanges on CoinGecko.

`GET /derivatives`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/derivatives","method":"GET"}'
```

### Derivatives Exchanges List with Data

Query all the derivatives exchanges with related data (ID, name, open interest, ...) on CoinGecko.

`GET /derivatives/exchanges`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order` | string | No | Sort order of responses. Default: open_interest_btc_desc |
| `per_page` | integer | No | Total results per page. |
| `page` | integer | No | Page through results. Default value: 1 |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/derivatives/exchanges","method":"GET","query":{"order":"<string>","per_page":"<integer>","page":"<integer>"}}'
```

### RWA Historical Chart Data by ID

Get the historical chart data of a RWA including time in UNIX, price, market cap and 24hrs volume based on a particular RWA ID. Historical data is limited to the past 2 years; days=max or older dates return an error.

`GET /rwas/{id}/market_chart`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `days` | string | No | Data up to number of days ago. Any integer up to 730 (2 years). Default: 1 |
| `interval` | string | No | Data interval, leave empty for auto granularity. |
| `precision` | string | No | Decimal place for currency price value. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/rwas/{id}/market_chart","method":"GET","query":{"days":"<string>","interval":"<string>","precision":"<string>"}}'
```

### Crypto Treasury Holdings by Coin ID

Query public companies' and governments' cryptocurrency holdings by coin ID.

`GET /{entity}/public_treasury/{coin_id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `coin_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `per_page` | integer | No | Total results per page. Default value: 250 Valid values: 1...250 |
| `page` | integer | No | Page through results. Default value: 1 |
| `order` | string | No | Sort order for results. Default: total_holdings_usd_desc |

```bash
# Replace {entity}, {coin_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/{entity}/public_treasury/{coin_id}","method":"GET","query":{"per_page":"<integer>","page":"<integer>","order":"<string>"}}'
```

### Crypto Treasury Holdings by Entity ID

Query public companies' and governments' cryptocurrency holdings by entity ID.

`GET /public_treasury/{entity_id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `holding_amount_change` | string | No | Include holding amount change for specified timeframes, comma-separated if querying more than 1 timeframe. Valid values: 7d, 14d, 30d, 90d, 1y, ytd |
| `holding_change_percentage` | string | No | Include holding change percentage for specified timeframes, comma-separated if querying more than 1 timeframe. Valid values: 7d, 14d, 30d, 90d, 1y, ytd |

```bash
# Replace {entity_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/public_treasury/{entity_id}","method":"GET","query":{"holding_amount_change":"<string>","holding_change_percentage":"<string>"}}'
```

### Crypto Treasury Transaction History by Entity ID

Query public companies' and governments' cryptocurrency transaction history by entity ID.

`GET /public_treasury/{entity_id}/transaction_history`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `per_page` | integer | No | Total results per page. Default value: 100 Valid values: 1...250 |
| `page` | integer | No | Page through results. Default value: 1 |
| `order` | string | No | Sort order of transactions. Default: date_desc |
| `coin_ids` | string | No | Filter transactions by coin IDs, comma-separated if querying more than 1 coin. *refers to /coins/list. |

```bash
# Replace {entity_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/public_treasury/{entity_id}/transaction_history","method":"GET","query":{"per_page":"<integer>","page":"<integer>","order":"<string>","coin_ids":"<string>"}}'
```

### NFTs List

Query all supported NFTs with ID, contract address, name, asset platform ID and symbol on CoinGecko.

`GET /nfts/list`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `order` | string | No | Sort order of responses. |
| `per_page` | integer | No | Total results per page. Valid values: 1...250 |
| `page` | integer | No | Page through results. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/nfts/list","method":"GET","query":{"order":"<string>","per_page":"<integer>","page":"<integer>"}}'
```

### NFTs Collection Data by ID

Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection ID.

`GET /nfts/{id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/nfts/{id}","method":"GET"}'
```

### NFTs Collection Data by Contract Address

Query all the NFT data (name, floor price, 24hr volume, ...) based on the NFT collection contract address and respective asset platform.

`GET /nfts/{asset_platform_id}/contract/{contract_address}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_platform_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `contract_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {asset_platform_id}, {contract_address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/nfts/{asset_platform_id}/contract/{contract_address}","method":"GET"}'
```

### BTC-to-Currency Exchange Rates

Query BTC exchange rates with other currencies.

`GET /exchange_rates`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/exchange_rates","method":"GET"}'
```

### Crypto Treasury Holdings Historical Chart Data by ID

Query historical cryptocurrency holdings chart of public companies and governments by entity ID and coin ID. Historical data is limited to the past 2 years; days=max or older dates return an error.

`GET /public_treasury/{entity_id}/{coin_id}/holding_chart`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `entity_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `coin_id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `days` | string | Yes | Data up to number of days ago. Valid values: 7, 14, 30, 90, 180, 365, 730 |
| `include_empty_intervals` | boolean | No | Include empty intervals with no transaction data. Default: false |

```bash
# Replace {entity_id}, {coin_id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/public_treasury/{entity_id}/{coin_id}/holding_chart","method":"GET","query":{"days":"<string>","include_empty_intervals":"<boolean>"}}'
```

### Crypto Global Market Data

Query cryptocurrency global data including active cryptocurrencies, markets, total crypto market cap and etc.

`GET /global`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/global","method":"GET"}'
```

### Global DeFi Market Data

Query top 100 cryptocurrency global decentralized finance (DeFi) data including DeFi market cap, trading volume.

`GET /global/decentralized_finance_defi`

**Estimated cost:** $0.00042

_No parameters required._

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/global/decentralized_finance_defi","method":"GET"}'
```

### Specific Pool Data by Pool Address

Query the specific pool based on the provided network and pool address.

`GET /onchain/networks/{network}/pools/{address}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `include_volume_breakdown` | boolean | No | Include volume breakdown. Default: false |
| `include_composition` | boolean | No | Include pool composition. Default: false |

```bash
# Replace {network}, {address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/pools/{address}","method":"GET","query":{"include":"<string>","include_volume_breakdown":"<boolean>","include_composition":"<boolean>"}}'
```

### Trending Pools List

Query all the trending pools across all networks on GeckoTerminal.

`GET /onchain/networks/trending_pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex, network |
| `page` | integer | No | Page through results. Default value: 1 |
| `duration` | string | No | Duration to sort trending list by. Default: 24h |
| `include_gt_community_data` | boolean | No | Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/trending_pools","method":"GET","query":{"include":"<string>","page":"<integer>","duration":"<string>","include_gt_community_data":"<boolean>"}}'
```

### Top Pools by Network

Query all the top pools based on the provided network.

`GET /onchain/networks/{network}/pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `page` | integer | No | Page through results. Default value: 1 |
| `sort` | string | No | Sort the pools by field. Default: h24_tx_count_desc |
| `include_gt_community_data` | boolean | No | Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false |

```bash
# Replace {network} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/pools","method":"GET","query":{"include":"<string>","page":"<integer>","sort":"<string>","include_gt_community_data":"<boolean>"}}'
```

### Top Pools by DEX

Query all the top pools based on the provided network and decentralized exchange (DEX).

`GET /onchain/networks/{network}/dexes/{dex}/pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `dex` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `page` | integer | No | Page through results. Default value: 1 |
| `sort` | string | No | Sort the pools by field. Default: h24_tx_count_desc |
| `include_gt_community_data` | boolean | No | Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false |

```bash
# Replace {network}, {dex} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/dexes/{dex}/pools","method":"GET","query":{"include":"<string>","page":"<integer>","sort":"<string>","include_gt_community_data":"<boolean>"}}'
```

### Top Pools by Token Address

Query top pools based on the provided token contract address on a network.

`GET /onchain/networks/{network}/tokens/{token_address}/pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `token_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `include_inactive_source` | boolean | No | Include tokens from inactive pools using the most recent swap. Default: false |
| `page` | integer | No | Page through results. Default value: 1 |
| `sort` | string | No | Sort the pools by field. Default: h24_volume_usd_liquidity_desc |
| `include_gt_community_data` | boolean | No | Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false |

```bash
# Replace {network}, {token_address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/tokens/{token_address}/pools","method":"GET","query":{"include":"<string>","include_inactive_source":"<boolean>","page":"<integer>","sort":"<string>","include_gt_community_data":"<boolean>"}}'
```

### Token Data by Token Address

Query specific token data based on the provided token contract address on a network.

`GET /onchain/networks/{network}/tokens/{address}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include. |
| `include_composition` | boolean | No | Include pool composition. Default: false |
| `include_inactive_source` | boolean | No | Include token data from inactive pools using the most recent swap. Default: false |

```bash
# Replace {network}, {address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/tokens/{address}","method":"GET","query":{"include":"<string>","include_composition":"<boolean>","include_inactive_source":"<boolean>"}}'
```

### Tokens Data by Token Addresses

Query multiple tokens data based on the provided token contract addresses on a network.

`GET /onchain/networks/{network}/tokens/multi/{addresses}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `addresses` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include. |
| `include_composition` | boolean | No | Include pool composition. Default: false |
| `include_inactive_source` | boolean | No | Include tokens from inactive pools using the most recent swap. Default: false |

```bash
# Replace {network}, {addresses} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/tokens/multi/{addresses}","method":"GET","query":{"include":"<string>","include_composition":"<boolean>","include_inactive_source":"<boolean>"}}'
```

### Token Info by Token Address

Query token metadata (name, symbol, CoinGecko ID, image, socials, websites, description, etc.) based on a provided token contract address on a network.

`GET /onchain/networks/{network}/tokens/{address}/info`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |

```bash
# Replace {network}, {address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/tokens/{address}/info","method":"GET"}'
```

### Pool Tokens Info by Pool Address

Query pool metadata (base and quote token details, image, socials, websites, description, contract address, etc.) based on a provided pool contract address on a network.

`GET /onchain/networks/{network}/pools/{pool_address}/info`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `pool_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include. |

```bash
# Replace {network}, {pool_address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/pools/{pool_address}/info","method":"GET","query":{"include":"<string>"}}'
```

### Most Recently Updated Tokens List

Query 100 most recently updated tokens info of a specific network or across all networks on GeckoTerminal.

`GET /onchain/tokens/info_recently_updated`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include` | string | No | Attributes for related resources to include. |
| `network` | string | No | Filter tokens by provided network. *refers to /onchain/networks. |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/tokens/info_recently_updated","method":"GET","query":{"include":"<string>","network":"<string>"}}'
```

### Pool OHLCV Chart by Pool Address

Get the OHLCV chart (Open, High, Low, Close, Volume) of a pool based on the provided pool address on a network. OHLCV history is limited to the past 180 days.

`GET /onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `pool_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `timeframe` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `aggregate` | string | No | Time period to aggregate each OHLCV. Available values (day): 1 Available values (hour): 1, 4, 12 Available values (minute): 1, 5, 15 Available values (second): 1, 15, 30 Default value: 1 |
| `before_timestamp` | integer | No | Return OHLCV data before this timestamp (integer seconds since epoch). |
| `limit` | integer | No | Number of OHLCV results to return, maximum 1000. Default value: 100 |
| `currency` | string | No | Return OHLCV in USD or quote token. Default: usd |
| `token` | string | No | Return OHLCV for token, use this to invert the chart. Available values: base, quote, or token address. Default: base |
| `include_empty_intervals` | boolean | No | Include empty intervals with no trade data. Default: false |

```bash
# Replace {network}, {pool_address}, {timeframe} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/pools/{pool_address}/ohlcv/{timeframe}","method":"GET","query":{"aggregate":"<string>","before_timestamp":"<integer>","limit":"<integer>","currency":"<string>","token":"<string>","include_empty_intervals":"<boolean>"}}'
```

### Trades by Pool Address

Query the trades based on the provided pool address.

`GET /onchain/networks/{network}/pools/{pool_address}/trades`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `pool_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `trade_volume_in_usd_greater_than` | number | No | Filter trades by trade volume in USD greater than this value. Default value: 0 |
| `token` | string | No | Return trades for token, use this to invert the chart. Available values: base, quote, or token address. Default: base |
| `trading_period` | string | No | Lookback period for trades. Default: 1d |
| `cursor` | string | No | Cursor from the previous response, passed back unchanged to fetch the next page. |
| `per_page` | integer | No | Total results per page. Default value: 300 Valid values: 1...300 |

```bash
# Replace {network}, {pool_address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/pools/{pool_address}/trades","method":"GET","query":{"trade_volume_in_usd_greater_than":"<number>","token":"<string>","trading_period":"<string>","cursor":"<string>","per_page":"<integer>"}}'
```

### New Pools List

Query all the latest pools across all networks on GeckoTerminal.

`GET /onchain/networks/new_pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex, network |
| `page` | integer | No | Page through results. Default value: 1 |
| `include_gt_community_data` | boolean | No | Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/new_pools","method":"GET","query":{"include":"<string>","page":"<integer>","include_gt_community_data":"<boolean>"}}'
```

### New Pools by Network

Query all the latest pools based on the provided network.

`GET /onchain/networks/{network}/new_pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `page` | integer | No | Page through results. Default value: 1 |
| `include_gt_community_data` | boolean | No | Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false |

```bash
# Replace {network} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/new_pools","method":"GET","query":{"include":"<string>","page":"<integer>","include_gt_community_data":"<boolean>"}}'
```

### Multiple Pools Data by Pool Addresses

Query multiple pools based on the provided network and pool addresses.

`GET /onchain/networks/{network}/pools/multi/{addresses}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `addresses` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `include_volume_breakdown` | boolean | No | Include volume breakdown. Default: false |
| `include_composition` | boolean | No | Include pool composition. Default: false |

```bash
# Replace {network}, {addresses} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/pools/multi/{addresses}","method":"GET","query":{"include":"<string>","include_volume_breakdown":"<boolean>","include_composition":"<boolean>"}}'
```

### Search Pools & Tokens

Search for pools across all networks by pool address, token name, token symbol, or token contract address.

`GET /onchain/search/pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Search query: pool contract address, token name, token symbol, or token contract address. |
| `network` | string | No | Network ID. *refers to /onchain/networks. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `page` | integer | No | Page through results. Default value: 1 |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/search/pools","method":"GET","query":{"query":"<string>","network":"<string>","include":"<string>","page":"<integer>"}}'
```

### Networks List

Retrieve a list of all supported networks on GeckoTerminal.

`GET /onchain/networks`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page through results. Default value: 1 |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks","method":"GET","query":{"page":"<integer>"}}'
```

### DEXs List by Network

Query all the supported decentralized exchanges (DEXs) based on the provided network on GeckoTerminal.

`GET /onchain/networks/{network}/dexes`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `page` | integer | No | Page through results. Default value: 1 |

```bash
# Replace {network} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/dexes","method":"GET","query":{"page":"<integer>"}}'
```

### Coin Historical Chart Data within Time Range by ID

Get the historical chart data of a coin within certain time range in UNIX along with price, market cap and 24hrs volume based on particular coin ID. Historical data is limited to the past 2 years; days=max or older dates return an error. interval accepts daily or hourly (leave empty for auto granularity); 5m and 1m are not available.

`GET /coins/{id}/market_chart/range`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `vs_currency` | string | Yes | Target currency of market data. *refers to /simple/supported_vs_currencies. |
| `from` | string | Yes | Starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility. |
| `to` | string | Yes | Ending date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility. |
| `interval` | string | No | Data interval: daily or hourly. Leave empty for auto granularity. |
| `precision` | string | No | Decimal place for currency price value. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/market_chart/range","method":"GET","query":{"vs_currency":"<string>","from":"<string>","to":"<string>","interval":"<string>","precision":"<string>"}}'
```

### Coin Price by Token Addresses

Query one or more token prices by using their token contract addresses.

`GET /simple/token_price/{id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `contract_addresses` | string | Yes | Token contract addresses, comma-separated if querying more than 1 token |
| `vs_currencies` | string | Yes | Target currency of coins, comma-separated if querying more than 1 currency. *refers to /simple/supported_vs_currencies |
| `include_market_cap` | boolean | No | Include market capitalization. Default: false |
| `include_24hr_vol` | boolean | No | Include 24-hour trading volume. Default: false |
| `include_24hr_change` | boolean | No | Include 24-hour change percentage. Default: false |
| `include_last_updated_at` | boolean | No | Include last updated price time as a UNIX timestamp. Default: false |
| `precision` | string | No | Decimal places for currency price value |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/simple/token_price/{id}","method":"GET","query":{"contract_addresses":"<string>","vs_currencies":"<string>","include_market_cap":"<boolean>","include_24hr_vol":"<boolean>","include_24hr_change":"<boolean>","include_last_updated_at":"<boolean>","precision":"<string>"}}'
```

### Coins List with Market Data

Query all the supported coins with price, market cap, volume and market related data.

`GET /coins/markets`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vs_currency` | string | Yes | Target currency of coins and market data. *refers to /simple/supported_vs_currencies |
| `ids` | string | No | Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list |
| `names` | string | No | Coins' names, comma-separated if querying more than 1 coin. |
| `symbols` | string | No | Coins' symbols, comma-separated if querying more than 1 coin. |
| `include_tokens` | string | No | For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume. |
| `category` | string | No | Filter based on coins' category. *refers to /coins/categories/list |
| `order` | string | No | Sort result by field. Default: market_cap_desc |
| `per_page` | integer | No | Total results per page. Default: 100 Valid values: 1...250 |
| `page` | integer | No | Page through results. Default: 1 |
| `sparkline` | boolean | No | Include sparkline 7-day data. Default: false |
| `price_change_percentage` | string | No | Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y |
| `locale` | string | No | Language background. Default: en |
| `precision` | string | No | Decimal places for currency price value |
| `include_rehypothecated` | boolean | No | Include rehypothecated tokens in results. When true, returns market_cap_rank_with_rehypothecated field. Default: false |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/markets","method":"GET","query":{"vs_currency":"<string>","ids":"<string>","names":"<string>","symbols":"<string>","include_tokens":"<string>","category":"<string>","order":"<string>","per_page":"<integer>","page":"<integer>","sparkline":"<boolean>","price_change_percentage":"<string>","locale":"<string>","precision":"<string>","include_rehypothecated":"<boolean>"}}'
```

### RWA List with Market Data

Query all the supported RWAs with price, market cap, volume and market related data.

`GET /rwas/markets`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_type` | string | No | Filter by RWA asset type. |
| `ids` | string | No | RWAs' IDs, comma-separated if querying more than 1 RWA. *refers to /rwas/list |
| `names` | string | No | RWAs' names, comma-separated if querying more than 1 RWA. |
| `symbols` | string | No | RWAs' symbols, comma-separated if querying more than 1 RWA. |
| `issuer` | string | No | Filter based on RWAs' issuer. *refers to /rwas/issuers/list |
| `order` | string | No | Sort result by field. Default: market_cap_desc |
| `per_page` | integer | No | Total results per page. Default: 100 Valid values: 1...250 |
| `page` | integer | No | Page through results. Default: 1 |
| `sparkline` | boolean | No | Include sparkline 7-day data. Default: false |
| `price_change_percentage` | string | No | Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y |
| `precision` | string | No | Decimal places for currency price value |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/rwas/markets","method":"GET","query":{"asset_type":"<string>","ids":"<string>","names":"<string>","symbols":"<string>","issuer":"<string>","order":"<string>","per_page":"<integer>","page":"<integer>","sparkline":"<boolean>","price_change_percentage":"<string>","precision":"<string>"}}'
```

### RWA Tickers by ID

Query the RWA tokens tickers on both centralized exchange (CEX) and decentralized exchange (DEX) based on a particular RWA ID.

`GET /rwas/{id}/tickers`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `issuer_ids` | string | No | Issuer ID. *refers to /rwas/issuers/list |
| `exchange_ids` | string | No | Exchange ID. *refers to /exchanges/list |
| `page` | integer | No | Page through results |
| `order` | string | No | Sort the order of responses. Default: last_traded_at_desc |
| `depth` | boolean | No | Include 2% orderbook depth, i.e. cost_to_move_up_usd and cost_to_move_down_usd. Default: false |
| `dex_pair_format` | string | No | Set to symbol to display DEX pair base and target as symbols. Default: contract_address |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/rwas/{id}/tickers","method":"GET","query":{"issuer_ids":"<string>","exchange_ids":"<string>","page":"<integer>","order":"<string>","depth":"<boolean>","dex_pair_format":"<string>"}}'
```

### Exchange Volume Chart by ID

Query the historical volume chart data with time in UNIX and trading volume data in BTC based on exchange's ID. Historical data is limited to the past 2 years; days=max or older dates return an error.

`GET /exchanges/{id}/volume_chart`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `days` | string | Yes | Data up to number of days ago. |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/exchanges/{id}/volume_chart","method":"GET","query":{"days":"<string>"}}'
```

### Coin Price by IDs, Symbols, or Names

Query the prices of one or more coins by using their unique Coin API IDs, symbols, or names.

`GET /simple/price`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vs_currencies` | string | Yes | Target currency of coins, comma-separated if querying more than 1 currency. *refers to /simple/supported_vs_currencies |
| `ids` | string | No | Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list |
| `names` | string | No | Coins' names, comma-separated if querying more than 1 coin. |
| `symbols` | string | No | Coins' symbols, comma-separated if querying more than 1 coin. |
| `include_tokens` | string | No | For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume. |
| `include_market_cap` | boolean | No | Include market capitalization. Default: false |
| `include_24hr_vol` | boolean | No | Include 24-hour trading volume. Default: false |
| `include_24hr_change` | boolean | No | Include 24-hour change percentage. Default: false |
| `include_last_updated_at` | boolean | No | Include last updated price time as a UNIX timestamp. Default: false |
| `precision` | string | No | Decimal places for currency price value |

```bash
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/simple/price","method":"GET","query":{"vs_currencies":"<string>","ids":"<string>","names":"<string>","symbols":"<string>","include_tokens":"<string>","include_market_cap":"<boolean>","include_24hr_vol":"<boolean>","include_24hr_change":"<boolean>","include_last_updated_at":"<boolean>","precision":"<string>"}}'
```

### Coin Data by ID

Query all the metadata (image, websites, socials, description, contract address, etc.) and market data (price, ATH, exchange tickers, etc.) of a coin based on a particular coin ID.

`GET /coins/{id}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `localization` | boolean | No | Include all localized languages in the response. Default: true |
| `tickers` | boolean | No | Include tickers data. Default: true |
| `market_data` | boolean | No | Include market data. Default: true |
| `community_data` | boolean | No | Include community data. Deprecated: has no effect as of 28 August 2026; the community_data object is no longer returned. |
| `developer_data` | boolean | No | Include developer data. Deprecated: has no effect as of 28 August 2026; the developer_data object is no longer returned. |
| `sparkline` | boolean | No | Include sparkline 7-day data. Default: false |
| `include_categories_details` | boolean | No | Include categories details. Default: false |
| `dex_pair_format` | string | No | Set to symbol to display DEX pair base and target as symbols. Default: contract_address |

```bash
# Replace {id} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}","method":"GET","query":{"localization":"<boolean>","tickers":"<boolean>","market_data":"<boolean>","community_data":"<boolean>","developer_data":"<boolean>","sparkline":"<boolean>","include_categories_details":"<boolean>","dex_pair_format":"<string>"}}'
```

### Coin Historical Chart Data within Time Range by Token Address

Get the historical chart data within certain time range in UNIX along with price, market cap and 24hrs volume based on asset platform and particular token contract address. Historical data is limited to the past 2 years; days=max or older dates return an error. interval accepts daily or hourly (leave empty for auto granularity); 5m and 1m are not available.

`GET /coins/{id}/contract/{contract_address}/market_chart/range`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `contract_address` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `vs_currency` | string | Yes | Target currency of market data. *refers to /simple/supported_vs_currencies. |
| `from` | string | Yes | Starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility. |
| `to` | string | Yes | Ending date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility. |
| `interval` | string | No | Data interval: daily or hourly. Leave empty for auto granularity. |
| `precision` | string | No | Decimal place for currency price value. |

```bash
# Replace {id}, {contract_address} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/coins/{id}/contract/{contract_address}/market_chart/range","method":"GET","query":{"vs_currency":"<string>","from":"<string>","to":"<string>","interval":"<string>","precision":"<string>"}}'
```

### Trending Pools by Network

Query the trending pools based on the provided network.

`GET /onchain/networks/{network}/trending_pools`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include` | string | No | Attributes to include, comma-separated if more than one. Available values: base_token, quote_token, dex |
| `page` | integer | No | Page through results. Default value: 1 |
| `duration` | string | No | Duration to sort trending list by. Default: 24h |
| `include_gt_community_data` | boolean | No | Include GeckoTerminal community data (sentiment votes, suspicious reports). Default: false |

```bash
# Replace {network} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/networks/{network}/trending_pools","method":"GET","query":{"include":"<string>","page":"<integer>","duration":"<string>","include_gt_community_data":"<boolean>"}}'
```

### Token Price by Token Addresses

Get token price based on the provided token contract address on a network.

`GET /onchain/simple/networks/{network}/token_price/{addresses}`

**Estimated cost:** $0.00042

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `network` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `addresses` | string | Yes | Path parameter — substitute directly into the endpoint `path`. |
| `include_market_cap` | boolean | No | Include market capitalization. Default: false |
| `mcap_fdv_fallback` | boolean | No | Return FDV if market cap is not available. Default: false |
| `include_24hr_vol` | boolean | No | Include 24hr volume. Default: false |
| `include_24hr_price_change` | boolean | No | Include 24hr price change. Default: false |
| `include_total_reserve_in_usd` | boolean | No | Include total reserve in USD. Default: false |
| `include_inactive_source` | boolean | No | Include token price data from inactive pools using the most recent swap. Default: false |

```bash
# Replace {network}, {addresses} in "path" with real values before sending
curl -X POST 'https://api.orthogonal.com/v1/run' \
  -H 'Authorization: Bearer $ORTHOGONAL_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"api":"coingecko","path":"/onchain/simple/networks/{network}/token_price/{addresses}","method":"GET","query":{"include_market_cap":"<boolean>","mcap_fdv_fallback":"<boolean>","include_24hr_vol":"<boolean>","include_24hr_price_change":"<boolean>","include_total_reserve_in_usd":"<boolean>","include_inactive_source":"<boolean>"}}'
```

---

Full details and an interactive quickstart: https://orthogonal.com/discover/coingecko