> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Coinranking

The Coinranking connector lets your AI agent act in each user's Coinranking account. Each user connects their own Coinranking API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 59 tools.

**Authentication:** API Key
**Categories:** Accounting & Finance, Analytics
**Tools:** 59: 59 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=COINRANKING)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Coinranking connection

   In **AgentKit > Connections**, create a Coinranking connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'coinranking'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Coinranking:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'coinranking_assets_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "coinranking"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Coinranking:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="coinranking_assets_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Coinranking credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'coinranking_assets_list',
  toolInput: {},
  connector: 'coinranking',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="coinranking_assets_list",
    tool_input={},
    connection_name="coinranking",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `coinranking_assets_list`

List Assets · Read-only

List non-crypto and derivative assets in groups: fiat currencies, wrapped and staked tokens, commodities, indices and stocks.
Returns status and data with fiat, wrapped, staked, commodities, indices, stocks.
Use types to pick groups.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next grouped page, or previousCursor to navigate back. One cursor advances every selected asset-type array. Use it with the same types and limit values as the request that created it. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit used for pagination. It applies separately to every selected asset-type array. For example, a limit of 10 can return up to 10 fiat currencies and 10 stocks in the same response. The maximum is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `reference_currency_uuid` (`string`, optional): UUID of the currency in which all prices, market caps, volumes, sparklines, and all-time-high prices are calculated. Defaults to US Dollar, but you can use any supported reference currency. You can find UUIDs in the dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `types` (`array`, optional): Asset types to include. By default, all asset types are selected. The response always includes every asset-type array; arrays that were not requested are returned empty. Example: ["fiat", "wrapped"]

Example input: `{}`

### `coinranking_bitcoin_dominance_history_get`

Get Bitcoin Dominance History · Read-only

Get Bitcoin's share of the total market cap over a time period.
Returns status and data with timestamp, percentage, marketCap.
Use this to track BTC dominance. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): Timeperiod where the percentage and marketCap are based on The maximum timePeriod is 1y for Free, 5y for Basic, and all for Startup and higher plans. These historical windows apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `all`.

Example input: `{}`

### `coinranking_blockchain_get`

Get Blockchain · Read-only

Get one blockchain by name with its total number of coins.
Returns status and data with blockchain; items include name, totalCoins.
Use coinranking_blockchains_list for valid names. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `blockchain` (`string`, required): Name of the blockchain you want to request. You can find a list of all possible values by making a request to blockchains endpoint. Example: ethereum.

Example input: `{"blockchain":"<blockchain>"}`

### `coinranking_blockchains_list`

List Blockchains · Read-only

List the blockchains Coinranking supports.
Returns status and data with blockchains.
Use the names with coinranking_blockchain_get or coinranking_coin_by_contract_get. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `coinranking_coin_atr_get`

Get Coin ATR · Read-only

Get a coin's 14-period Average True Range, a volatility measure in the reference currency.
Returns status and data with startingAt, atr.
Choose interval to set the candle size. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): Candle size each data point is based on. If omitted, a default is picked from time_period. Allowed intervals depend on time_period: 1h minute or 5minutes; 3h and 12h up to hour; 24h up to 8hours; 7d hour to day; 30d hour to week; 3m hour to month; 1y and longer day to month. Example: 8hours. One of: `minute`, `5minutes`, `hour`, `8hours`, `day`, `week`, `month`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in whose terms the price is measured before the ATR is calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint The returned atr is a price in this currency, so this choice sets both the calculation and the units it comes back in. The conversion happens before the calculation, so the ATR of a coin priced in Bitcoin is a genuinely different series from its ATR priced in US Dollars — not a rescaling of it. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): The time period for which the ATR data is returned. The number of data points and the default interval are determined by the time period. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `10y`, `all`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_blockchains_list`

List Coin Blockchains · Read-only

List the blockchains a coin is issued on, with contract references and block explorer links.
Returns status and data with total, issuanceBlockchains; items include name, referenceName, reference, blockExplorerUrl, migratedToReference, migrationDate.
Use this to find a token's contract on each chain. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. Defaults to 50. Example: 50.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_by_contract_get`

Get Coin By Contract Address · Read-only

Find the Coinranking coin for a token contract address on a given blockchain.
Returns status and data with coin; items include UUID, name, symbol, contractAddresses, coinrankingUrl.
Use this to turn a contract address into a coin UUID. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `address` (`string`, required): Address of the token you want to request. This is the same address as is used on the blockchain the token is minted on. For example, the Tether (USDT) contract address on Ethereum is 0xdac17f958d2ee523a2206206994597c13d831ec7. In our case, the address is case-insensitive. Example: 0xdac17f958d2ee523a2206206994597c13d831ec7.
- `blockchain` (`string`, required): Name of the blockchain you want to request. You can find a list of all possible values by making a request to our blockchains endpoint. Example: ethereum.

Example input: `{"address":"<address>","blockchain":"<blockchain>"}`

### `coinranking_coin_by_external_id_get`

Get Coin By CoinGecko Or CMC ID · Read-only

Look up a Coinranking coin by its CoinGecko or CoinMarketCap ID and get its full details.
Returns status and data with coin; items include uuid, symbol, name, description, color, iconUrl, websiteUrl, links, supply.
Use this to map IDs from other data providers to Coinranking. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `provider` (`string`, required): The external data provider to resolve the coin from. Example: coingecko. One of: `coingecko`, `coinmarketcap`.
- `provider_id` (`string`, required): The ID of the coin on the external provider's platform. Example (CoinGecko): bitcoin, ethereum, tether Example (CoinMarketCap): 1 (Bitcoin), 1027 (Ethereum). Example: bitcoin.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): Time period where the change and sparkline are based on The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`.

Example input: `{"provider":"coingecko","provider_id":"<provider_id>"}`

### `coinranking_coin_exchanges_list`

List Coin Exchanges · Read-only

List the exchanges where a coin trades, with volume and price per exchange.
Returns status and data with stats, exchanges; items include 24hVolume, total, coinrankingUrl, uuid, name, exchangeType, iconUrl, verified, recommended.
Use coinranking_coin_markets_list for individual trading pairs. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order by. Default is 24h volume. Example: 24hVolume. One of: `24hVolume`, `price`.
- `order_direction` (`string`, optional): Order in ascending or descending order. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Value to search for within results, i.e. exchange names. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_fiat_prices_get`

Get Coin Fiat Prices · Read-only

Get a coin's price in many fiat currencies at once.
Returns status and data with prices; items include referenceCurrencyUuid, referenceCurrencySymbol, referenceCurrencyName, referenceCurrencyIconUrl, price.
Use this for multi-currency displays. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_gains_losses_get`

Get Coin Gains And Losses · Read-only

Get a coin's price change per day, week or month.
Returns status and data with gainsAndLosses; items include timestamp, price, change.
Use this to see a coin's period-over-period performance. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): Time interval for the gains and losses calculation. Defaults to day. Example: month. One of: `day`, `week`, `month`.
- `limit` (`integer`, optional): Number of gains and losses entries to return. Defaults to 50. Example: 50.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_get`

Get Coin · Read-only

Get one coin by UUID with its price, market cap, supply, all-time high, links and description.
Returns status and data with coin; items include uuid, symbol, name, description, color, iconUrl, websiteUrl, links, supply.
Find a UUID with coinranking_search_suggestions. Use coinranking_coin_price_get for just the price.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): Time period where the change and sparkline are based on The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_macd_get`

Get Coin MACD · Read-only

Get a coin's MACD line, signal line and histogram (12/26/9).
Returns status and data with startingAt, macd, macdSignal, macdHistogram.
Choose interval to set the candle size. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): Candle size each data point is based on. If omitted, a default is picked from time_period. Allowed intervals depend on time_period: 1h minute or 5minutes; 3h and 12h up to hour; 24h up to 8hours; 7d hour to day; 30d hour to week; 3m hour to month; 1y and longer day to month. Example: 8hours. One of: `minute`, `5minutes`, `hour`, `8hours`, `day`, `week`, `month`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in whose terms the price is measured before the MACD is calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint All three values are expressed in the reference currency, and the conversion happens before the calculation rather than after — so a MACD priced in Bitcoin is a genuinely different series from one priced in US Dollars, not the same numbers rescaled. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): The time period for which the MACD data is returned. The number of data points and the default interval are determined by the time period. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `10y`, `all`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_market_cap_history_get`

Get Coin Market Cap History · Read-only

Get a coin's market cap history at an hourly, daily, weekly or monthly interval.
Returns status and data with history; items include timestamp, marketCap.
Use this for valuation charts. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): The interval determines the time period over which each market cap item is determined. Defaults to day. Example: month. One of: `hour`, `day`, `week`, `month`.
- `limit` (`integer`, optional): Limit. Limit the amount of time periods for which the marketCaps are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_markets_list`

List Coin Markets · Read-only

List the trading pairs (markets) of a coin across exchanges, with volume, price and market share.
Returns status and data with stats, markets; items include 24hVolume, total, uuid, base, quote, exchange, price, btcPrice, rank.
Use coinranking_coin_exchanges_list for an exchange-level view. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to sort on. Default is 24h volume. Example: 24hVolume. One of: `24hVolume`, `price`.
- `order_direction` (`string`, optional): Order in ascending or descending order. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Value to search for within results, e.g. exchange names, currency names, or currency symbols. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_moving_averages_get`

Get Coin Moving Averages · Read-only

Get 20, 50, 100 and 200-period simple and exponential moving averages plus Bollinger Bands for a coin.
Returns status and data with startingAt, ma20, ma50, ma100, ma200, ema20, ema50, ema100, ema200, bbUpper20.
Choose interval to set the candle size. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): Candle size each data point is based on. If omitted, a default is picked from time_period. Allowed intervals depend on time_period: 1h minute or 5minutes; 3h and 12h up to hour; 24h up to 8hours; 7d hour to day; 30d hour to week; 3m hour to month; 1y and longer day to month. Example: 8hours. One of: `minute`, `5minutes`, `hour`, `8hours`, `day`, `week`, `month`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the moving average values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): The time period for which the moving average data is returned. The number of data points and the default interval are determined by the time period. Growth and higher plans can use every time period up to all. Preview requests follow your plan’s historical window: Free is limited to one year, Basic to five years, and Startup can use all available history. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `10y`, `all`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_ohlcv_get`

Get Coin OHLCV · Read-only

Get open, high, low, close and volume candles for a coin at a chosen interval.
Returns status and data with ohlc, paging; items include startingAt, endingAt, open, high, low, close, avg, 24hVolume, intervalVolume.
Use coinranking_coin_price_history_get for a simple price line. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `from` (`integer`, optional): Start of the historical window as a Unix timestamp in seconds. Supplying from switches the endpoint into historical window mode: instead of the latest limit candles, it returns candles for the requested time range. from is snapped down to the start of its interval, so the bucket containing from is included. Minute-resolution history is available back to December 2018. When omitted, the endpoint stays in the default latest-candles mode. Size range: 0-4102444800. Example: 1735689600.
- `interval` (`string`, optional): The interval determines the time period over which each OHLC item is determined. Defaults to day. Example: 8hours. One of: `minute`, `5minutes`, `hour`, `8hours`, `day`, `week`, `month`.
- `limit` (`integer`, optional): Limit. Limit the amount of time periods for which the OHLCV data is retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. Production access requires the Growth plan or higher. Free previews are limited to 100 results per response. All other plans can receive up to 5000 results per response, including previews. Ignored in historical window mode (when from is supplied); windows are instead capped at 1440 candles per response and paged with data.paging.next — see Fetching historical ranges. Defaults to 50. Example: 50.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint Note: When using a reference currency, the OHLC values are converted from USD-based calculations rather than recalculated from raw trading data. Since reference currency exchange rates fluctuate during the time period this means: The Open or Close values might be higher than the High or lower than the Low For true OHLC data in a specific currency pair, use USD as the reference currency or subscribe to the realtime rates for both the coin and the intended reference currency and calculate the OHLC values yourself. Example: 5k-_VTxqtCEI.
- `to` (`integer`, optional): End of the historical window as a Unix timestamp in seconds. The window is half-open: candles are returned for every interval bucket that starts before to. Unlike from, to is not snapped, so if it falls mid-interval the bucket it lands in is still returned (effectively rounding to up to the next boundary); only a candle starting exactly at to is excluded. Requires from, and must be greater than from. When omitted, the window runs up to the present moment. Defaults to now. Example: 1738367999.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_price_get`

Get Coin Price · Read-only

Get a coin's current price, or its price nearest to a given timestamp.
Returns status and data with price, timestamp.
Use coinranking_coin_price_history_get for a series of prices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `timestamp` (`integer`, optional): The timestamp parameter accepts an epoch timestamp in seconds. This timestamp is used to find the nearest available price point, selecting the data's granularity based on the age of the request: Minute-level data for timestamps within the last 24 hours. Hourly data for timestamps older than 24 hours but less than 30 days. Daily data for timestamps older than 30 days. If no timestamp is provided, this endpoint will default to the latest price. Example: 1735689600.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_price_history_get`

Get Coin Price History · Read-only

Get a coin's price history over a time period, for charts and trend analysis.
Returns status and data with change, history; items include price, timestamp.
Use coinranking_coin_ohlcv_get for candles.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): Timeperiod where the change and history are based on The maximum timePeriod is 1y for Free, 5y for Basic, and all for Startup and higher plans. These historical windows apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `all`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_rank_history_get`

Get Coin Rank History · Read-only

Get a coin's historical tier and market cap, volume and price ranks.
Returns status and data with history; items include startingAt, tier, marketCapRank, fullyDilutedMarketCapRank, volumeRank, priceRank.
Use this to track how a coin's ranking changed. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): The interval determines the time period over which each rank item is determined. Defaults to day. Example: month. One of: `hour`, `day`, `week`, `month`.
- `limit` (`integer`, optional): Limit. Limit the amount of time periods for which the ranks are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. Free is limited to 100 results per response. Basic, Startup, Growth, and Professional can receive up to 5000 results per response, including previews. Defaults to 50. Example: 50.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_rsi_get`

Get Coin RSI · Read-only

Get a coin's 14-period Relative Strength Index and its 14-candle average.
Returns status and data with startingAt, rsi, rsiMa.
Choose interval to set the candle size. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): Candle size each data point is based on. If omitted, a default is picked from time_period. Allowed intervals depend on time_period: 1h minute or 5minutes; 3h and 12h up to hour; 24h up to 8hours; 7d hour to day; 30d hour to week; 3m hour to month; 1y and longer day to month. Example: 8hours. One of: `minute`, `5minutes`, `hour`, `8hours`, `day`, `week`, `month`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in whose terms the price is measured before the RSI is calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint The RSI itself is a dimensionless 0-100 reading, but it is not independent of this choice: the conversion happens before the calculation, so the RSI of a coin priced in Bitcoin is a genuinely different series from its RSI priced in US Dollars. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): The time period for which the RSI data is returned. The number of data points and the default interval are determined by the time period. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `10y`, `all`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_supertrend_get`

Get Coin Supertrend · Read-only

Get a coin's Supertrend (10, 3) line and trend direction.
Returns status and data with startingAt, supertrend, direction.
Choose interval to set the candle size. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): Candle size each data point is based on. If omitted, a default is picked from time_period. Allowed intervals depend on time_period: 1h minute or 5minutes; 3h and 12h up to hour; 24h up to 8hours; 7d hour to day; 30d hour to week; 3m hour to month; 1y and longer day to month. Example: 8hours. One of: `minute`, `5minutes`, `hour`, `8hours`, `day`, `week`, `month`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in whose terms the price is measured before the Supertrend is calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint The returned supertrend is a price in this currency, and the conversion happens before the calculation — so this choice can change direction too, not just the units. A coin trending up against the US Dollar may be trending down against Bitcoin, and this endpoint will say so. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): The time period for which the Supertrend data is returned. The number of data points and the default interval are determined by the time period. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `10y`, `all`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_supply_history_get`

Get Coin Supply History · Read-only

Get a coin's circulating and total supply history.
Returns status and data with history; items include timestamp, circulating, total.
Use this to track inflation or burns. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): The interval determines the time period over which each supply item is determined. Defaults to day. Example: month. One of: `hour`, `day`, `week`, `month`.
- `limit` (`integer`, optional): Limit. Limit the amount of time periods for which the supplies are retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_supply_modifiers_list`

List Coin Supply Modifiers · Read-only

List the addresses whose balances are excluded from a coin's circulating supply (supply modifiers).
Returns status and data with total, modifiers; items include blockchainName, blockExplorerUrl, name, reference, syncedAt, amount.
Use this to understand how circulating supply is computed. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `limit` (`integer`, optional): Limit. Used for pagination. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `order_by` (`string`, optional): Order of the modifiers can be either when they were added (createdAt) or by amount. Defaults to createdAt. Example: amount. One of: `amount`, `createdAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query, which can be in ascending or descending order. Defaults to desc. Example: desc. One of: `desc`, `asc`.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coin_volume_history_get`

Get Coin Volume History · Read-only

Get a coin's trading volume history at an hourly, daily, weekly or monthly interval.
Returns status and data with history; items include timestamp, volume.
Use this for volume charts. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): The interval determines the time period over which each volume item is aggregated. Defaults to day. Example: month. One of: `hour`, `day`, `week`, `month`.
- `limit` (`integer`, optional): Maximum number of history entries to return. For example, when interval=day and limit=30, data is returned for the last 30 days. Free is limited to 100 results per response. All other plans can receive up to 5000 results per response, including previews. Defaults to 50. Example: 50.
- `reference_currency_uuid` (`string`, optional): UUID of the reference currency (fiat or crypto) in which volumes are expressed. You can find UUIDs in our coin endpoints or the reference currencies endpoint. Defaults to yhjMzLPhuIDl. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_coins_list`

List Coins · Read-only

List coins with price, market cap, volume and change, filtered by symbols, UUIDs, contract addresses, blockchains, tags or tiers and sorted by market cap, price, volume, change or listing date.
Returns status and data with stats, coins; items include total, totalCoins, totalMarkets, totalExchanges, totalMarketCap, total24hVolume, uuid, symbol, name.
Use this to rank or filter coins. Only tier 1 and 2 coins are returned unless tiers includes 3. Use coinranking_coin_get for one coin's full details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `blockchains` (`array`, optional): Blockchains to filter the list on. With this filter you can for example fetch only coins that are minted on the Ethereum blockchain. You can filter on multiple blockchains at once. Example: ["ethereum"]
- `coingecko_ids` (`array`, optional): CoinGecko IDs to filter the list on. Useful if you already work with CoinGecko IDs and want to fetch the matching coins. The same ID is returned per coin as coinGeckoId. IDs without a match are ignored. Example: ["bitcoin"]
- `coinmarketcap_ids` (`array`, optional): CoinMarketCap IDs to filter the list on. Useful if you already work with CoinMarketCap IDs and want to fetch the matching coins. The same ID is returned per coin as coinMarketCapId. IDs without a match are ignored. Example: ["1"]
- `contract_addresses` (`array`, optional): Contract Addresses to filter the list on. These are the addresses currencies get on their respective blockchains. Smart Contract Addresses are a common name for addresses on blockchains, but some chains might call them AssetID, Token Address or something else. We use the term Contract Address to cover all these cases. Note that tokens might be issued on several blockchains, so the same token might have several addresses. Example: ["0xdac17f958d2ee523a2206206994597c13d831ec7"]
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order by. All sortings excluding listedAt still take our different tiers of coins into account, read more about it in our ranking methodology. Defaults to marketCap. Example: price. One of: `price`, `marketCap`, `24hVolume`, `change`, `listedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query, which can be in ascending or descending order. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `symbols` (`array`, optional): Symbols to filter the list on. Do note that symbols are not unique. Should you need a specific coin, then you should use the UUIDs filter. Example: ["BTC", "ETH"]
- `tags` (`array`, optional): Tags to filter the list on. Example: ["defi"]
- `tiers` (`array`, optional): We separate coins into three tiers. With this parameter you can filter coins on the tiers you need. Read more about our tiers in our ranking methodology. By default, only tier 1 and 2 coins are returned. To retrieve all coins, pass all tiers explicitly: tiers[]=1&tiers[]=2&tiers[]=3. Tier 3 coins are available on all API plans, subject to your plan's result limit. Example: ["1", "2"]
- `time_period` (`string`, optional): By setting the timePeriod the change percentage and sparkline in the response will be calculated accordingly. The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`.
- `uuids` (`array`, optional): UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{}`

### `coinranking_coins_trending_list`

List Trending Coins · Read-only

List the coins currently trending on Coinranking.
Returns status and data with coins; items include uuid, symbol, name, color, iconUrl, marketCap, price, listedAt, tier.
Use coinranking_coins_list to rank coins by market data instead.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `tiers` (`array`, optional): We separate coins into three tiers. With this parameter you can filter coins on the tiers you need. Read more about our tiers in our ranking methodology. Example: ["1", "2"]
- `time_period` (`string`, optional): By setting the timePeriod the change percentage and sparkline in the response will be calculated accordingly. The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`.

Example input: `{}`

### `coinranking_dex_coins_list`

List DEX Coins · Read-only

List the coins traded on a DEX, with price and volume.
Returns status and data with stats, coins; items include total, rank, uuid, symbol, name, iconUrl, price, btcPrice, 24hVolume.
Use coinranking_dex_new_coins_list for recent listings. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to sort on. Default is 24h volume. Example: 24hVolume. One of: `24hVolume`, `price`, `numberOfMarkets`.
- `order_direction` (`string`, optional): order in ascending or descending order. Defaults to desc. Example: asc. One of: `asc`, `desc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_dex_get`

Get DEX · Read-only

Get one decentralized exchange by UUID with volume, rank and links.
Returns status and data with exchange; items include uuid, name, description, iconUrl, websiteUrl, verified, recommended, numberOfMarkets, numberOfCoins.
Use coinranking_dexs_list to find UUIDs. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_dex_markets_list`

List DEX Markets · Read-only

List the trading pairs on a DEX, with volume, price and market share.
Returns status and data with stats, markets; items include 24hVolume, total, uuid, active, base, quote, exchange, price, btcPrice.
Use coinranking_market_get for one pair. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `order_by` (`string`, optional): Index to sort on. Default is 24h volume. Example: 24hVolume. One of: `24hVolume`, `price`.
- `order_direction` (`string`, optional): Order in ascending or descending order. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Value to search for within results, e.g. exchange names, currency names, or currency symbols. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_dex_new_coins_list`

List DEX New Coins · Read-only

List the coins most recently listed on a DEX.
Returns status and data with coins; items include listedAt, uuid, symbol, name, iconUrl, price, 24hVolume.
Use this to watch new token launches. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_dex_protocols_list`

List DEX Protocols · Read-only

List DEX protocols (such as Uniswap) with their aggregated volume and markets.
Returns status and data with stats, exchanges; items include 24hVolume, total, uuid, name, iconUrl, verified, recommended, numberOfMarkets, numberOfCoins.
Use coinranking_dexs_list for individual DEX deployments. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `countries` (`array`, optional): Filter DEX protocols by supported countries using ISO 3166-1 alpha-2 country codes. Returns only protocols that support trading in at least one of the specified countries. See the country codes reference for a full list of supported codes. Example: ["US", "GB"]
- `fiat_currency_uuids` (`array`, optional): Filter DEX protocols by fiat currencies they support for trading pairs, using each currency's UUID. Returns only protocols that support at least one of the specified fiat currencies. You can find fiat currency UUIDs in the reference currencies endpoint using ?types[]=fiat. Single value example: https://api.coinranking.com/v2/dex-protocols?fiatCurrencyUuids[]=yhjMzLPhuIDl Multiple values example: https://api.coinranking.com/v2/dex-protocols?fiatCurrencyUuids[]=yhjMzLPhuIDl&fiatCurrencyUuids[]=5k-_VTxqtCEI. Example: ["yhjMzLPhuIDl"]
- `limit` (`integer`, optional): Limit. Used for pagination. Only usable when no filters are applied. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `order_by` (`string`, optional): Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied. Defaults to 24hVolume. Example: 24hVolume. One of: `24hVolume`, `numberOfMarkets`, `lastTickerCreatedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Value to search for within results, e.g. protocol names. Example: bitcoin.
- `uuids` (`array`, optional): DEX Protocol UUIDs to filter the protocols on. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{}`

### `coinranking_dexs_list`

List DEXs · Read-only

List decentralized exchanges ranked by volume.
Returns status and data with stats, exchanges; items include 24hVolume, total, uuid, name, iconUrl, verified, recommended, numberOfMarkets, numberOfCoins.
Use coinranking_dex_get for one DEX and coinranking_dex_protocols_list for protocol-level grouping. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `countries` (`array`, optional): Filter exchanges by supported countries using ISO 3166-1 alpha-2 country codes. Returns only exchanges that support trading in at least one of the specified countries. See the country codes reference for a full list of supported codes. Example: ["US", "GB"]
- `fiat_currency_uuids` (`array`, optional): Filter exchanges by fiat currencies they support for trading pairs, using each currency's UUID. Returns only exchanges that support at least one of the specified fiat currencies. You can find fiat currency UUIDs in the reference currencies endpoint using ?types[]=fiat. Single value example: https://api.coinranking.com/v2/dexs?fiatCurrencyUuids[]=yhjMzLPhuIDl Multiple values example: https://api.coinranking.com/v2/dexs?fiatCurrencyUuids[]=yhjMzLPhuIDl&fiatCurrencyUuids[]=5k-_VTxqtCEI. Example: ["yhjMzLPhuIDl"]
- `limit` (`integer`, optional): Limit. Used for pagination. Only usable when no filters are applied. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `order_by` (`string`, optional): Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied. Defaults to 24hVolume. Example: 24hVolume. One of: `24hVolume`, `numberOfMarkets`, `lastTickerCreatedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Value to search for within results, e.g. exchange names. Example: bitcoin.
- `uuids` (`array`, optional): DEX Exchange UUIDs to filter the exchanges on. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{}`

### `coinranking_exchange_coins_list`

List Exchange Coins · Read-only

List the coins traded on a centralized exchange, with price and volume.
Returns status and data with stats, coins; items include total, rank, uuid, symbol, name, iconUrl, price, btcPrice, 24hVolume.
Use coinranking_exchange_new_coins_list for recent listings. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to sort on. Default is 24h volume. Example: 24hVolume. One of: `24hVolume`, `price`, `numberOfMarkets`.
- `order_direction` (`string`, optional): order in ascending or descending order. Defaults to desc. Example: asc. One of: `asc`, `desc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter the results by searching for coin names or symbols. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_exchange_get`

Get Exchange · Read-only

Get one centralized exchange by UUID with its volume, rank, links and description.
Returns status and data with exchange; items include uuid, name, description, iconUrl, websiteUrl, verified, recommended, numberOfMarkets, numberOfCoins.
Use coinranking_exchanges_list to find UUIDs. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_exchange_markets_list`

List Exchange Markets · Read-only

List the trading pairs on a centralized exchange, with volume, price and market share.
Returns status and data with stats, markets; items include 24hVolume, total, uuid, active, base, quote, exchange, price, btcPrice.
Use coinranking_market_get for one pair. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to sort on. Default is 24h volume. Example: 24hVolume. One of: `24hVolume`, `price`.
- `order_direction` (`string`, optional): Order in ascending or descending order. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Value to search for within results, e.g. exchange names, currency names, or currency symbols. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_exchange_new_coins_list`

List Exchange New Coins · Read-only

List the coins most recently listed on a centralized exchange.
Returns status and data with coins; items include listedAt, uuid, symbol, name, iconUrl, price, 24hVolume.
Use this to watch new listings. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_exchanges_list`

List Exchanges · Read-only

List centralized exchanges ranked by volume, with markets and coins counts.
Returns status and data with stats, exchanges; items include 24hVolume, total, uuid, name, iconUrl, verified, recommended, numberOfMarkets, numberOfCoins.
Use coinranking_exchange_get for one exchange. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `countries` (`array`, optional): Filter exchanges by supported countries using ISO 3166-1 alpha-2 country codes. Returns only exchanges that support trading in at least one of the specified countries. See the country codes reference for a full list of supported codes. Example: ["US", "GB"]
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `fiat_currency_uuids` (`array`, optional): Filter exchanges by fiat currencies they support for trading pairs, using each currency's UUID. Returns only exchanges that support at least one of the specified fiat currencies. You can find fiat currency UUIDs in the reference currencies endpoint using ?types[]=fiat. Single value example: https://api.coinranking.com/v2/exchanges?fiatCurrencyUuids[]=yhjMzLPhuIDl Multiple values example: https://api.coinranking.com/v2/exchanges?fiatCurrencyUuids[]=yhjMzLPhuIDl&fiatCurrencyUuids[]=5k-_VTxqtCEI. Example: ["yhjMzLPhuIDl"]
- `limit` (`integer`, optional): Limit. Used for pagination. Only usable when no filters are applied. Free is limited to 100 results per response. All paid plans can receive up to 5000 results per response, including previews. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied. Defaults to 24hVolume. Example: 24hVolume. One of: `24hVolume`, `numberOfMarkets`, `lastTickerCreatedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Value to search for within results, e.g. exchange names. Example: bitcoin.
- `uuids` (`array`, optional): Exchange UUIDs to filter the exchanges on. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{}`

### `coinranking_fear_greed_index_get`

Get Fear And Greed Index · Read-only

Get the crypto market Fear and Greed Index over a time period.
Returns status and data with timestamp, value.
Use this for market sentiment. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `interval` (`string`, optional): Candle size each data point is based on. If omitted, a default is picked from time_period. Allowed intervals depend on time_period: 1h minute or 5minutes; 3h and 12h up to hour; 24h up to 8hours; 7d hour to day; 30d hour to week; 3m hour to month; 1y and longer day to month. Example: 8hours. One of: `minute`, `5minutes`, `hour`, `8hours`, `day`, `week`, `month`.
- `time_period` (`string`, optional): The time period for which the Fear and Greed Index data is returned. The number of data points and the default interval are determined by the time period. Every time period up to all is available. Your plan’s historical window applies to both preview and production requests. Example: 3m. One of: `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `10y`, `all`.

Example input: `{}`

### `coinranking_futures_coin_exchanges_list`

List Futures Coin Exchanges · Read-only

List the futures exchanges trading one coin.
Returns status and data with stats, exchanges; items include total, 24hVolume, openInterest, uuid, rank, name, iconUrl, exchangeType, coinrankingUrl.
Use coinranking_futures_exchanges_list for all futures exchanges. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order the list by. Defaults to openInterest. Example: openInterest. One of: `openInterest`, `24hVolume`, `numberOfMarkets`, `numberOfCoins`, `lastTickerCreatedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter exchanges by name prefix. Example: bitcoin.
- `uuids` (`array`, optional): UUIDs to filter the list on. If you know the UUIDs of the exchanges you want to fetch, you can use this filter to get specific exchanges. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{"uuid":"<uuid>"}`

### `coinranking_futures_coin_get`

Get Futures Coin · Read-only

Get futures metrics for one coin: price, open interest, volume and funding rate.
Returns status and data with coin; items include id, uuid, symbol, name, description, links, color, iconUrl, coinrankingUrl.
Use coinranking_futures_coin_markets_list for its markets. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_futures_coin_markets_list`

List Futures Coin Markets · Read-only

List the futures markets of one coin with mark and index price, open interest and funding.
Returns status and data with stats, markets; items include total, 24hVolume, openInterest, uuid, rank, base, quote, exchange, marketShare.
Use coinranking_futures_market_get for one market. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order the list by. Defaults to openInterest. Example: openInterest. One of: `openInterest`, `24hVolume`, `price`, `lastTickerCreatedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter markets by exchange name, base currency name or symbol. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_futures_coin_ohlcv_get`

Get Futures Coin OHLCV · Read-only

Get futures candles for one coin with open interest and funding rate per interval.
Returns status and data with ohlc; items include startingAt, endingAt, open, high, low, close, avg, 24hVolume, intervalVolume.
Use coinranking_coin_ohlcv_get for spot candles. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
- `interval` (`string`, optional): The time interval for each OHLCV candle. Defaults to day. Example: day. One of: `minute`, `hour`, `day`.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `offset` (`integer`, optional): Offset. Used for pagination. Defaults to 0. Example: 0.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_futures_coins_list`

List Futures Coins · Read-only

List coins ranked by futures open interest, volume, price or funding rate.
Returns status and data with stats, coins; items include total, totalCoins, totalMarkets, totalExchanges, totalOpenInterest, total24hVolume, fundingRate, uuid, symbol.
Use coinranking_futures_coin_get for one coin. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order the list by. Defaults to openInterest. Example: openInterest. One of: `openInterest`, `24hVolume`, `price`, `fundingRate`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter coins by name or symbol prefix. Example: bitcoin.
- `symbols` (`array`, optional): Symbols to filter the list on. Note that symbols are not unique. Should you need a specific coin, use the UUIDs filter instead. Example: ["BTC", "ETH"]
- `uuids` (`array`, optional): UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get specific coins. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{}`

### `coinranking_futures_exchange_coins_list`

List Futures Exchange Coins · Read-only

List the futures coins listed on one exchange.
Returns status and data with stats, coins; items include total, rank, uuid, symbol, name, color, iconUrl, coinrankingUrl, price.
Use coinranking_futures_exchange_markets_list for its markets. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Futures exchange UUID, from coinranking_futures_exchanges_list. Example: -zdvbieRdZ.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order the list by. Defaults to openInterest. Example: openInterest. One of: `openInterest`, `24hVolume`, `price`, `fundingRate`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter coins by name or symbol prefix. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_futures_exchange_markets_list`

List Futures Exchange Markets · Read-only

List the futures markets on one exchange.
Returns status and data with stats, markets; items include total, 24hVolume, openInterest, uuid, rank, base, quote, exchange, marketShare.
Use coinranking_futures_market_get for one market. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Futures exchange UUID, from coinranking_futures_exchanges_list. Example: -zdvbieRdZ.
- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order the list by. Defaults to openInterest. Example: openInterest. One of: `openInterest`, `24hVolume`, `price`, `lastTickerCreatedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter markets by base currency name, base currency symbol, quote currency name, or quote currency symbol. Example: bitcoin.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_futures_exchanges_list`

List Futures Exchanges · Read-only

List futures exchanges ranked by open interest or volume.
Returns status and data with stats, exchanges; items include total, 24hVolume, openInterest, uuid, rank, name, iconUrl, lastTickerCreatedAt, marketShare.
Use coinranking_futures_exchange_coins_list for one exchange's coins. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. Free is limited to 100 results per response. All paid plans can receive up to 5000 results per response, including previews. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order the list by. Defaults to openInterest. Example: openInterest. One of: `openInterest`, `24hVolume`, `numberOfMarkets`, `numberOfCoins`, `lastTickerCreatedAt`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter exchanges by name prefix. Example: bitcoin.
- `uuids` (`array`, optional): UUIDs to filter the list on. If you know which exchanges you want, use this filter to return only those entries. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{}`

### `coinranking_futures_market_get`

Get Futures Market · Read-only

Get one futures market by UUID with latest ticker, funding, volume and open interest.
Returns status and data with market; items include uuid, base, quote, exchange, latestTicker, marketShare, price, markPrice, indexPrice.
Use coinranking_futures_markets_list to find UUIDs. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Futures market UUID, from coinranking_futures_markets_list. Example: 9mm7u0M2fkO9R.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_futures_markets_list`

List Futures Markets · Read-only

List futures markets across exchanges ranked by open interest, volume or price.
Returns status and data with stats, markets; items include total, 24hVolume, openInterest, uuid, rank, base, quote, exchange, marketShare.
Use coinranking_futures_market_get for one market. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Index to order the list by. Defaults to openInterest. Example: openInterest. One of: `openInterest`, `24hVolume`, `price`.
- `order_direction` (`string`, optional): Applies direction to the orderBy query. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all prices, volume, and open interest values are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter markets by exchange name, base currency name, base currency symbol, quote currency name, or quote currency symbol. Example: bitcoin.

Example input: `{}`

### `coinranking_global_market_cap_history_get`

Get Global Market Cap History · Read-only

Get the total crypto market cap history over a time period.
Returns status and data with timestamp, marketCap.
Use this for macro market charts. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the market caps are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): Timeperiod where the marketCap are based on The maximum timePeriod is 1y for Free, 5y for Basic, and all for Startup, Growth, and Professional. These historical windows apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`, `all`.

Example input: `{}`

### `coinranking_global_volume_history_get`

Get Global Volume History · Read-only

Get the total crypto trading volume history at a daily, weekly or monthly interval.
Returns status and data with volumes; items include timestamp, intervalVolume.
Use this for market-wide liquidity trends. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `interval` (`string`, optional): The interval determines the time period over which each trading volume item is calculated. day: the total volume traded in a single day week: the total volume traded over a week month: the total volume traded over an entire month. Defaults to day. Example: month. One of: `day`, `week`, `month`.
- `limit` (`integer`, optional): Limit. Limit the amount of time periods for which the intervalVolume are retrieved. For example, when interval=day and limit is 10, data will be returned for the last 10 days. The maximum amount of results you can fetch in one request is 100 for Free and 1000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the trading volumes are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{}`

### `coinranking_market_get`

Get Market · Read-only

Get one trading pair (market) by UUID with price, volume, rank and exchange.
Returns status and data with market; items include uuid, base, quote, exchange, 24hVolume, price, btcPrice, rank, marketShare.
Use coinranking_markets_list to find UUIDs. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `uuid` (`string`, required): Market UUID, from coinranking_markets_list. Example: MP77r-vKf4.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used to calculate the volume. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{"uuid":"<uuid>"}`

### `coinranking_markets_list`

List Markets · Read-only

List trading pairs across all exchanges, ranked by volume or price.
Returns status and data with stats, markets; items include 24hVolume, total, uuid, base, quote, exchange, price, btcPrice, rank.
Use coinranking_market_get for one pair. Needs the Growth plan or higher (other plans get 5 preview calls per day; otherwise 403).

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. Only usable when no filters are applied. Defaults to 50. Example: 50.
- `order_by` (`string`, optional): Sort by either 24h volume or price. Only usable when no filters are applied. Defaults to 24hVolume. Example: 24hVolume. One of: `24hVolume`, `price`.
- `order_direction` (`string`, optional): Sort in ascending or descending order. Only usable when no filters are applied. Defaults to desc. Example: desc. One of: `desc`, `asc`.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `search` (`string`, optional): Filter the results by searching for coin names, symbols or exchange names. Example: bitcoin.

Example input: `{}`

### `coinranking_reference_currencies_list`

List Reference Currencies · Read-only

List the currencies (coins, fiat, commodities, indices, stocks) that prices can be quoted in.
Returns status and data with stats, currencies; items include total, uuid, type, symbol, name, iconUrl, sign.
Use a UUID from here as reference_currency_uuid in other tools.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 20. Example: 50.
- `search` (`string`, optional): Filter the results by searching for currency names or symbols. Example: bitcoin.
- `types` (`array`, optional): A currency is one of six types: coin (e.g. Bitcoin, Ethereum, etc.), fiat (US Dollar, Euro, Yen, etc.), denominator (e.g. Satoshi), commodities (e.g. Gold, Silver, etc.), indices (e.g. S&P 500, NASDAQ, etc.), or stocks (e.g. Tesla, Apple, etc.). Filter the response by providing one or more types. Example: ["coin", "fiat"]

Example input: `{}`

### `coinranking_search_suggestions`

Search Suggestions · Read-only

Search coins, exchanges, markets, fiat currencies and categories by name, symbol or contract address.
Returns status and data with coins, exchanges, markets, fiat; items include uuid, iconUrl, name, symbol, price, recommended, baseSymbol, quoteSymbol, baseUuid.
Use this first to find the UUID other tools need. Symbols are not unique; prefer UUIDs.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `query` (`string`, optional): Value to search on. Can be a part of a name or symbol, or a complete smart contract address. Example: bitcoin.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `types` (`array`, optional): Suggestion buckets to search. Defaults to all buckets. You can provide a single value, repeated array values, or comma-separated values. The response includes every bucket; buckets that were not requested are returned as empty arrays. Example: ["coins", "exchanges"]

Example input: `{}`

### `coinranking_stats_coins_get`

Get Stats For Coins · Read-only

Get aggregate stats (market cap, volume, positive and negative changes) for a selection of coins or one tag.
Returns status and data with stats; items include positiveChanges, negativeChanges, numberOfCoins, volume, volumeShare, marketCap, marketCapChange, marketCapShare, topCurrencySymbol.
Use this for baskets and watchlists. Use coinranking_stats_get for the whole market.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `tag` (`string`, optional): Tag to filter the list on. If you provide a tag, this takes precedence over the uuids filter. We have many tags you can check out. Example: defi.
- `time_period` (`string`, optional): Negative changes, positive changes and the change in market cap are influenced by the time period. The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`.
- `uuids` (`array`, optional): UUIDs to filter the list on. If you know the UUIDs of the coins you want to fetch, you can use this filter to get the specific coins. Uuids does not work in combination with tag. If you use both filters, the tag filter takes precedence. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]

Example input: `{}`

### `coinranking_stats_get`

Get Global Stats · Read-only

Get global crypto market stats: total coins, markets, exchanges, market cap, 24h volume and Bitcoin dominance, plus best and newest coins.
Returns status and data with totalCoins, totalMarkets, totalExchanges, totalMarketCap; items include uuid, symbol, name, iconUrl, coinrankingUrl.
Use coinranking_stats_coins_get for a custom selection of coins.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), in which all the prices are calculated. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.

Example input: `{}`

### `coinranking_tag_get`

Get Tag · Read-only

Get one tag by slug with its description, number of coins, market cap and volume.
Returns status and data with tag; items include slug, shortname, name, type, description, iconUrl, hasContent, numberOfCoins, 24hVolume.
Use coinranking_tags_list to find slugs, and the tags filter of coinranking_coins_list for its coins.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `slug` (`string`, required): Slug of the tag you want to request. Consult the tags endpoint for possible slug values. Example: defi.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used in all the values that represent a price, e.g. 24hVolume and marketCap. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): Time period where the change and sparkline are based on The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`.

Example input: `{"slug":"<slug>"}`

### `coinranking_tags_list`

List Tags · Read-only

List tags (categories such as DeFi or meme, and blockchain ecosystems) with their market cap and volume.
Returns status and data with stats, tags; items include total, slug, shortname, name, type, iconUrl, hasContent, numberOfCoins, 24hVolume.
Use coinranking_tag_get for one tag.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `cursor` (`string`, optional): Cursor for pagination. Use the nextCursor value from the previous response to get the next page of results, or the previousCursor value to navigate back to the previous page. See Pagination for more information. Example: eyJ0IjoxLCJvIjo1MH0.
- `limit` (`integer`, optional): Limit. Used for pagination. The maximum amount of results you can fetch in one request is 100 for Free and 5000 for all paid plans, including previews where available. Defaults to 50. Example: 50.
- `reference_currency_uuid` (`string`, optional): UUID of coin (either fiat or crypto), the price of the reference currency is used in all the values that represent a price, e.g. 24hVolume and marketCap. Defaults to US Dollar, but you can use any coin. You can find UUIDs for reference currencies in any coin endpoint, including a convenient dedicated reference currency endpoint. Example: 5k-_VTxqtCEI.
- `time_period` (`string`, optional): Time period where the change and sparkline are based on The maximum timePeriod is 1y for Free and 5y for all paid plans. This endpoint supports up to five years of data. These limits apply to both preview and production requests. Defaults to 24h. Example: 24h. One of: `1h`, `3h`, `12h`, `24h`, `7d`, `30d`, `3m`, `1y`, `3y`, `5y`.
- `type` (`string`, optional): Filter tags by type. Use this to get only categories or only ecosystems. Example: category. One of: `category`, `ecosystem`.

Example input: `{}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
