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.
- Tools
- 59
- What they doRead · write · destructive
- 59 · 0 · 059 read0 write0 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Coinranking connection
In AgentKit > Connections, create a Coinranking connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts 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.actionsconst connector = 'coinranking'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'coinranking_assets_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_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.actionsconnection_name = "coinranking"identifier = "user_123"# Generate an authorization link for the userlink_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 callresult = actions.execute_tool(tool_input={},tool_name="coinranking_assets_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Coinranking credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolcoinranking_assets_listList non-crypto and derivative assets in groups: fiat currencies, wrapped and staked tokens, commodities, indices and stocks.Read-onlyList Assets
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.
Inputs
cursorstring- 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.
limitinteger- 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_uuidstring- 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.
typesarray- 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"]
coinranking_bitcoin_dominance_history_getGet Bitcoin's share of the total market cap over a time period.Read-onlyGet Bitcoin Dominance History
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).
Inputs
reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5yall
coinranking_blockchain_getGet one blockchain by name with its total number of coins.Read-onlyGet Blockchain
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).
Inputs
blockchainstringrequired- 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.
coinranking_blockchains_listList the blockchains Coinranking supports.Read-onlyList Blockchains
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).
Inputs
This tool takes no inputs.
coinranking_coin_atr_getGet a coin's 14-period Average True Range, a volatility measure in the reference currency.Read-onlyGet Coin ATR
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- 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
minute5minuteshour8hoursdayweekmonth reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y10yall
coinranking_coin_blockchains_listList the blockchains a coin is issued on, with contract references and block explorer links.Read-onlyList Coin Blockchains
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
cursorstring- 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.
limitinteger- Limit. Used for pagination. Defaults to 50. Example: 50.
coinranking_coin_by_contract_getFind the Coinranking coin for a token contract address on a given blockchain.Read-onlyGet Coin By Contract Address
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).
Inputs
addressstringrequired- 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.
blockchainstringrequired- 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.
coinranking_coin_by_external_id_getLook up a Coinranking coin by its CoinGecko or CoinMarketCap ID and get its full details.Read-onlyGet Coin By CoinGecko Or CMC ID
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).
Inputs
providerstringrequired- The external data provider to resolve the coin from. Example: coingecko.one of
coingeckocoinmarketcap provider_idstringrequired- 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_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y
coinranking_coin_exchanges_listList the exchanges where a coin trades, with volume and price per exchange.Read-onlyList Coin Exchanges
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
cursorstring- 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.
limitinteger- 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_bystring- Index to order by. Default is 24h volume. Example: 24hVolume.one of
24hVolumeprice order_directionstring- Order in ascending or descending order. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Value to search for within results, i.e. exchange names. Example: bitcoin.
coinranking_coin_fiat_prices_getGet a coin's price in many fiat currencies at once.Read-onlyGet Coin Fiat Prices
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
coinranking_coin_gains_losses_getGet a coin's price change per day, week or month.Read-onlyGet Coin Gains And Losses
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- Time interval for the gains and losses calculation. Defaults to day. Example: month.one of
dayweekmonth limitinteger- Number of gains and losses entries to return. Defaults to 50. Example: 50.
reference_currency_uuidstring- 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.
coinranking_coin_getGet one coin by UUID with its price, market cap, supply, all-time high, links and description.Read-onlyGet Coin
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.
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y
coinranking_coin_macd_getGet a coin's MACD line, signal line and histogram (12/26/9).Read-onlyGet Coin MACD
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- 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
minute5minuteshour8hoursdayweekmonth reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y10yall
coinranking_coin_market_cap_history_getGet a coin's market cap history at an hourly, daily, weekly or monthly interval.Read-onlyGet Coin Market Cap History
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- The interval determines the time period over which each market cap item is determined. Defaults to day. Example: month.one of
hourdayweekmonth limitinteger- 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.
coinranking_coin_markets_listList the trading pairs (markets) of a coin across exchanges, with volume, price and market share.Read-onlyList Coin Markets
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
cursorstring- 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.
limitinteger- 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_bystring- Index to sort on. Default is 24h volume. Example: 24hVolume.one of
24hVolumeprice order_directionstring- Order in ascending or descending order. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Value to search for within results, e.g. exchange names, currency names, or currency symbols. Example: bitcoin.
coinranking_coin_moving_averages_getGet 20, 50, 100 and 200-period simple and exponential moving averages plus Bollinger Bands for a coin.Read-onlyGet Coin Moving Averages
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- 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
minute5minuteshour8hoursdayweekmonth reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y10yall
coinranking_coin_ohlcv_getGet open, high, low, close and volume candles for a coin at a chosen interval.Read-onlyGet Coin OHLCV
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
frominteger- 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.
intervalstring- The interval determines the time period over which each OHLC item is determined. Defaults to day. Example: 8hours.one of
minute5minuteshour8hoursdayweekmonth limitinteger- 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_uuidstring- 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.
tointeger- 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.
coinranking_coin_price_getGet a coin's current price, or its price nearest to a given timestamp.Read-onlyGet Coin Price
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.
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
reference_currency_uuidstring- 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.
timestampinteger- 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.
coinranking_coin_price_history_getGet a coin's price history over a time period, for charts and trend analysis.Read-onlyGet Coin Price History
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.
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5yall
coinranking_coin_rank_history_getGet a coin's historical tier and market cap, volume and price ranks.Read-onlyGet Coin Rank History
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- The interval determines the time period over which each rank item is determined. Defaults to day. Example: month.one of
hourdayweekmonth limitinteger- 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.
coinranking_coin_rsi_getGet a coin's 14-period Relative Strength Index and its 14-candle average.Read-onlyGet Coin RSI
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- 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
minute5minuteshour8hoursdayweekmonth reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y10yall
coinranking_coin_supertrend_getGet a coin's Supertrend (10, 3) line and trend direction.Read-onlyGet Coin Supertrend
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- 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
minute5minuteshour8hoursdayweekmonth reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y10yall
coinranking_coin_supply_history_getGet a coin's circulating and total supply history.Read-onlyGet Coin Supply History
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- The interval determines the time period over which each supply item is determined. Defaults to day. Example: month.one of
hourdayweekmonth limitinteger- 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.
coinranking_coin_supply_modifiers_listList the addresses whose balances are excluded from a coin's circulating supply (supply modifiers).Read-onlyList Coin Supply Modifiers
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
limitinteger- Limit. Used for pagination. Defaults to 50. Example: 50.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
order_bystring- Order of the modifiers can be either when they were added (createdAt) or by amount. Defaults to createdAt. Example: amount.one of
amountcreatedAt order_directionstring- Applies direction to the orderBy query, which can be in ascending or descending order. Defaults to desc. Example: desc.one of
descasc
coinranking_coin_volume_history_getGet a coin's trading volume history at an hourly, daily, weekly or monthly interval.Read-onlyGet Coin Volume History
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).
Inputs
uuidstringrequired- Coin UUID, from coinranking_search_suggestions or coinranking_coins_list (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- The interval determines the time period over which each volume item is aggregated. Defaults to day. Example: month.one of
hourdayweekmonth limitinteger- 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_uuidstring- 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.
coinranking_coins_listList 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.Read-onlyList Coins
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.
Inputs
blockchainsarray- 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_idsarray- 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_idsarray- 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_addressesarray- 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"]
cursorstring- 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.
limitinteger- 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_bystring- 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
pricemarketCap24hVolumechangelistedAt order_directionstring- Applies direction to the orderBy query, which can be in ascending or descending order. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
symbolsarray- 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"]
tagsarray- Tags to filter the list on. Example: ["defi"]
tiersarray- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y uuidsarray- 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"]
coinranking_coins_trending_listList the coins currently trending on Coinranking.Read-onlyList Trending Coins
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.
Inputs
limitinteger- 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.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
reference_currency_uuidstring- 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.
tiersarray- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y
coinranking_dex_coins_listList the coins traded on a DEX, with price and volume.Read-onlyList DEX Coins
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).
Inputs
uuidstringrequired- DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
cursorstring- 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.
limitinteger- 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_bystring- Index to sort on. Default is 24h volume. Example: 24hVolume.one of
24hVolumepricenumberOfMarkets order_directionstring- order in ascending or descending order. Defaults to desc. Example: asc.one of
ascdesc reference_currency_uuidstring- 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.
coinranking_dex_getGet one decentralized exchange by UUID with volume, rank and links.Read-onlyGet DEX
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).
Inputs
uuidstringrequired- DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
reference_currency_uuidstring- 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.
coinranking_dex_markets_listList the trading pairs on a DEX, with volume, price and market share.Read-onlyList DEX Markets
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).
Inputs
uuidstringrequired- DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
limitinteger- 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.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
order_bystring- Index to sort on. Default is 24h volume. Example: 24hVolume.one of
24hVolumeprice order_directionstring- Order in ascending or descending order. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Value to search for within results, e.g. exchange names, currency names, or currency symbols. Example: bitcoin.
coinranking_dex_new_coins_listList the coins most recently listed on a DEX.Read-onlyList DEX New Coins
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).
Inputs
uuidstringrequired- DEX UUID, from coinranking_dexs_list. Example: 5Sfs67ZcuOWm.
limitinteger- 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.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
reference_currency_uuidstring- 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.
coinranking_dex_protocols_listList DEX protocols (such as Uniswap) with their aggregated volume and markets.Read-onlyList DEX Protocols
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).
Inputs
countriesarray- 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_uuidsarray- 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"]
limitinteger- 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.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
order_bystring- 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
24hVolumenumberOfMarketslastTickerCreatedAt order_directionstring- 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
descasc reference_currency_uuidstring- 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.
searchstring- Value to search for within results, e.g. protocol names. Example: bitcoin.
uuidsarray- DEX Protocol UUIDs to filter the protocols on. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]
coinranking_dexs_listList decentralized exchanges ranked by volume.Read-onlyList DEXs
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).
Inputs
countriesarray- 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_uuidsarray- 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"]
limitinteger- 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.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
order_bystring- 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
24hVolumenumberOfMarketslastTickerCreatedAt order_directionstring- 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
descasc reference_currency_uuidstring- 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.
searchstring- Value to search for within results, e.g. exchange names. Example: bitcoin.
uuidsarray- DEX Exchange UUIDs to filter the exchanges on. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]
coinranking_exchange_coins_listList the coins traded on a centralized exchange, with price and volume.Read-onlyList Exchange Coins
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).
Inputs
uuidstringrequired- Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
cursorstring- 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.
limitinteger- 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_bystring- Index to sort on. Default is 24h volume. Example: 24hVolume.one of
24hVolumepricenumberOfMarkets order_directionstring- order in ascending or descending order. Defaults to desc. Example: asc.one of
ascdesc reference_currency_uuidstring- 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.
searchstring- Filter the results by searching for coin names or symbols. Example: bitcoin.
coinranking_exchange_getGet one centralized exchange by UUID with its volume, rank, links and description.Read-onlyGet Exchange
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).
Inputs
uuidstringrequired- Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
reference_currency_uuidstring- 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.
coinranking_exchange_markets_listList the trading pairs on a centralized exchange, with volume, price and market share.Read-onlyList Exchange Markets
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).
Inputs
uuidstringrequired- Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
cursorstring- 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.
limitinteger- 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_bystring- Index to sort on. Default is 24h volume. Example: 24hVolume.one of
24hVolumeprice order_directionstring- Order in ascending or descending order. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Value to search for within results, e.g. exchange names, currency names, or currency symbols. Example: bitcoin.
coinranking_exchange_new_coins_listList the coins most recently listed on a centralized exchange.Read-onlyList Exchange New Coins
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).
Inputs
uuidstringrequired- Exchange UUID, from coinranking_exchanges_list. Example: -zdvbieRdZ.
limitinteger- 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.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
reference_currency_uuidstring- 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.
coinranking_exchanges_listList centralized exchanges ranked by volume, with markets and coins counts.Read-onlyList Exchanges
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).
Inputs
countriesarray- 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"]
cursorstring- 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_uuidsarray- 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"]
limitinteger- 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_bystring- 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
24hVolumenumberOfMarketslastTickerCreatedAt order_directionstring- 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
descasc reference_currency_uuidstring- 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.
searchstring- Value to search for within results, e.g. exchange names. Example: bitcoin.
uuidsarray- Exchange UUIDs to filter the exchanges on. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]
coinranking_fear_greed_index_getGet the crypto market Fear and Greed Index over a time period.Read-onlyGet Fear And Greed Index
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).
Inputs
intervalstring- 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
minute5minuteshour8hoursdayweekmonth time_periodstring- 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
24h7d30d3m1y3y5y10yall
coinranking_futures_coin_exchanges_listList the futures exchanges trading one coin.Read-onlyList Futures Coin Exchanges
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
cursorstring- 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.
limitinteger- 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_bystring- Index to order the list by. Defaults to openInterest. Example: openInterest.one of
openInterest24hVolumenumberOfMarketsnumberOfCoinslastTickerCreatedAt order_directionstring- Applies direction to the orderBy query. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter exchanges by name prefix. Example: bitcoin.
uuidsarray- 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"]
coinranking_futures_coin_getGet futures metrics for one coin: price, open interest, volume and funding rate.Read-onlyGet Futures Coin
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
reference_currency_uuidstring- 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.
coinranking_futures_coin_markets_listList the futures markets of one coin with mark and index price, open interest and funding.Read-onlyList Futures Coin Markets
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
cursorstring- 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.
limitinteger- 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_bystring- Index to order the list by. Defaults to openInterest. Example: openInterest.one of
openInterest24hVolumepricelastTickerCreatedAt order_directionstring- Applies direction to the orderBy query. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter markets by exchange name, base currency name or symbol. Example: bitcoin.
coinranking_futures_coin_ohlcv_getGet futures candles for one coin with open interest and funding rate per interval.Read-onlyGet Futures Coin OHLCV
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).
Inputs
uuidstringrequired- Coin UUID (Bitcoin is Qwsogvtv82FCd). Example: Qwsogvtv82FCd.
intervalstring- The time interval for each OHLCV candle. Defaults to day. Example: day.one of
minutehourday limitinteger- 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.
offsetinteger- Offset. Used for pagination. Defaults to 0. Example: 0.
reference_currency_uuidstring- 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.
coinranking_futures_coins_listList coins ranked by futures open interest, volume, price or funding rate.Read-onlyList Futures Coins
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).
Inputs
cursorstring- 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.
limitinteger- 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_bystring- Index to order the list by. Defaults to openInterest. Example: openInterest.one of
openInterest24hVolumepricefundingRate order_directionstring- Applies direction to the orderBy query. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter coins by name or symbol prefix. Example: bitcoin.
symbolsarray- 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"]
uuidsarray- 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"]
coinranking_futures_exchange_coins_listList the futures coins listed on one exchange.Read-onlyList Futures Exchange Coins
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).
Inputs
uuidstringrequired- Futures exchange UUID, from coinranking_futures_exchanges_list. Example: -zdvbieRdZ.
cursorstring- 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.
limitinteger- 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_bystring- Index to order the list by. Defaults to openInterest. Example: openInterest.one of
openInterest24hVolumepricefundingRate order_directionstring- Applies direction to the orderBy query. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter coins by name or symbol prefix. Example: bitcoin.
coinranking_futures_exchange_markets_listList the futures markets on one exchange.Read-onlyList Futures Exchange Markets
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).
Inputs
uuidstringrequired- Futures exchange UUID, from coinranking_futures_exchanges_list. Example: -zdvbieRdZ.
cursorstring- 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.
limitinteger- 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_bystring- Index to order the list by. Defaults to openInterest. Example: openInterest.one of
openInterest24hVolumepricelastTickerCreatedAt order_directionstring- Applies direction to the orderBy query. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter markets by base currency name, base currency symbol, quote currency name, or quote currency symbol. Example: bitcoin.
coinranking_futures_exchanges_listList futures exchanges ranked by open interest or volume.Read-onlyList Futures Exchanges
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).
Inputs
cursorstring- 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.
limitinteger- 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_bystring- Index to order the list by. Defaults to openInterest. Example: openInterest.one of
openInterest24hVolumenumberOfMarketsnumberOfCoinslastTickerCreatedAt order_directionstring- Applies direction to the orderBy query. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter exchanges by name prefix. Example: bitcoin.
uuidsarray- UUIDs to filter the list on. If you know which exchanges you want, use this filter to return only those entries. Example: ["Qwsogvtv82FCd", "razxDUgYGNAdQ"]
coinranking_futures_market_getGet one futures market by UUID with latest ticker, funding, volume and open interest.Read-onlyGet Futures Market
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).
Inputs
uuidstringrequired- Futures market UUID, from coinranking_futures_markets_list. Example: 9mm7u0M2fkO9R.
reference_currency_uuidstring- 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.
coinranking_futures_markets_listList futures markets across exchanges ranked by open interest, volume or price.Read-onlyList Futures Markets
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).
Inputs
cursorstring- 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.
limitinteger- 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_bystring- Index to order the list by. Defaults to openInterest. Example: openInterest.one of
openInterest24hVolumeprice order_directionstring- Applies direction to the orderBy query. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter markets by exchange name, base currency name, base currency symbol, quote currency name, or quote currency symbol. Example: bitcoin.
coinranking_global_market_cap_history_getGet the total crypto market cap history over a time period.Read-onlyGet Global Market Cap History
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).
Inputs
reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5yall
coinranking_global_volume_history_getGet the total crypto trading volume history at a daily, weekly or monthly interval.Read-onlyGet Global Volume History
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).
Inputs
cursorstring- 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.
intervalstring- 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
dayweekmonth limitinteger- 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_uuidstring- 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.
coinranking_market_getGet one trading pair (market) by UUID with price, volume, rank and exchange.Read-onlyGet Market
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).
Inputs
uuidstringrequired- Market UUID, from coinranking_markets_list. Example: MP77r-vKf4.
reference_currency_uuidstring- 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.
coinranking_markets_listList trading pairs across all exchanges, ranked by volume or price.Read-onlyList Markets
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).
Inputs
cursorstring- 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.
limitinteger- Limit. Used for pagination. Only usable when no filters are applied. Defaults to 50. Example: 50.
order_bystring- Sort by either 24h volume or price. Only usable when no filters are applied. Defaults to 24hVolume. Example: 24hVolume.one of
24hVolumeprice order_directionstring- Sort in ascending or descending order. Only usable when no filters are applied. Defaults to desc. Example: desc.one of
descasc reference_currency_uuidstring- 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.
searchstring- Filter the results by searching for coin names, symbols or exchange names. Example: bitcoin.
coinranking_reference_currencies_listList the currencies (coins, fiat, commodities, indices, stocks) that prices can be quoted in.Read-onlyList Reference Currencies
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.
Inputs
cursorstring- 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.
limitinteger- 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.
searchstring- Filter the results by searching for currency names or symbols. Example: bitcoin.
typesarray- 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"]
coinranking_search_suggestionsSearch coins, exchanges, markets, fiat currencies and categories by name, symbol or contract address.Read-onlySearch Suggestions
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.
Inputs
querystring- Value to search on. Can be a part of a name or symbol, or a complete smart contract address. Example: bitcoin.
reference_currency_uuidstring- 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.
typesarray- 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"]
coinranking_stats_coins_getGet aggregate stats (market cap, volume, positive and negative changes) for a selection of coins or one tag.Read-onlyGet Stats For Coins
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.
Inputs
reference_currency_uuidstring- 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.
tagstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y uuidsarray- 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"]
coinranking_stats_getGet global crypto market stats: total coins, markets, exchanges, market cap, 24h volume and Bitcoin dominance, plus best and newest coins.Read-onlyGet Global Stats
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.
Inputs
reference_currency_uuidstring- 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.
coinranking_tag_getGet one tag by slug with its description, number of coins, market cap and volume.Read-onlyGet Tag
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.
Inputs
slugstringrequired- Slug of the tag you want to request. Consult the tags endpoint for possible slug values. Example: defi.
reference_currency_uuidstring- 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_periodstring- 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
1h3h12h24h7d30d3m1y3y5y
No tools match.