Coinranking1 MCP Server

{ "openapi": "3.0.0", "info": { "title": "Coinranking1", "version": "1.0.0", "description": "RapidAPI: Coinranking/coinranking1" }, "servers": [ { "url": "https://coinranking1.p.rapidapi.com" } ], "paths": { "/coins/trending": { "get": { "summary": "Get trending coins", "description": "Get a list of trending coins. Trending coins are ranked dynamically based on user engagement and popularity. By default, the API returns the top 50 trending coins along with the price of each trending coin in USD. The response not only returns a list of coins, but also statistics regarding the requested list, such as the volume in the last 24 hours.", "operationId": "get_trending_coins", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. This includes the price, the change and the sparkline. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "By setting the timeperiod the change percentage and sparkline in the response will be calculated accordingly Default value: 24h Allowed values: 3h 24h 7d 30d 3m 1y 3y 5y", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "tiers", "in": "query", "required": false, "description": "We seperate coins into three tiers. With this parameter you can filter coins on the tiers you need. Read more about out our tiers in our methodology Array parameters should be suffixed with brackets. Example: ?tiers[]=1&tiers[]=2.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination. Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination. Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/blockchain/{blockchain}/{address}": { "get": { "summary": "Get Blockchain UUID by contract address", "description": "Find a specific coin by the contract address on its blockchain. We use the term contract address, but the name differs per ecosystem. For example, in Ethereum, it's called a smart contract address, others call it a token address, assetID, or something else.", "operationId": "get_blockchain_uuid_by_contract_address", "parameters": [ { "name": "blockchain", "in": "query", "required": true, "description": "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.", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "address", "in": "query", "required": true, "description": "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.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/blockchain/{name}": { "get": { "summary": "Get blockchain details", "description": "Find a blockchain", "operationId": "get_blockchain_details", "parameters": [ { "name": "name", "in": "query", "required": true, "description": "Name of the blockchain you want to request. You can find a list of all possible values by making a request to blockchains endpoint.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/blockchains": { "get": { "summary": "Get blockchains", "description": "Get a list of all blockchains. You can use the names in the list to request more details about a specific blockchain in our blockchain details endpoint, and you can use our Get UUID by contract address endpoint to find out if we have listed a specific token on one of these chains.", "operationId": "get_blockchains", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/bulk/coins": { "get": { "summary": "Get bulk data of all coins", "description": "$237", "operationId": "get_bulk_data_of_all_coins", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/search-suggestions": { "get": { "summary": "Get search suggestions", "description": "Search suggestions are a quick and easy way to find data on coinranking. The endpoint only accepts one parameter; a query. With this query you can find currencies (including fiat), exchanges and markets, by their symbol or name. The response always returns a set of the most prominent coins, exchanges and markets matching your query.", "operationId": "get_search_suggestions", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which the coin prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "query", "in": "query", "required": false, "description": "Value to search on", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/tags": { "get": { "summary": "Get list of tags", "description": "Get a list of all our tags. Each tag provides insights into the number of coins it encompasses, along with market-specific statistics like volume and market capitalization. The tags can also be used in the coins endpoint as a filter.", "operationId": "get_list_of_tags", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "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 Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "Time period where the change and sparkline are based on Default value: 24h Allowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/tag/{slug}": { "get": { "summary": "Get tag details", "description": "Find information about a specific tag. On Coinranking, we use this data on our [coin categories page.](https://coinranking.com/categories)", "operationId": "get_tag_details", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "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 Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "Time period where the change and sparkline are based on Default value: 24h Allowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "slug", "in": "query", "required": true, "description": "Slug of the tag you want to request. Consult the tags endpoint for possible slug values.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/stats/bitcoin-dominance-history": { "get": { "summary": "Get bitcoin dominance history", "description": "Get a list of bitcoin dominance history along with the bitcoin market capitalization data. On Coinranking, we use this endpoint on our [bitcoin dominance chart. ](https://coinranking.com/#bitcoin-dominance) On Coinranking, we use this endpoint on our [global trading volume chart.](https://coinranking.com/#global-trading-volume) On Coinranking, we use this endpoint on our [global market cap chart](https://coinranking.com/#global-market-cap).", "operationId": "get_bitcoin_dominance_history", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "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 Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "Timeperiod where the percentage and marketCap are based on Default value: 24h Allowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y Default value: day Allowed values: day week month", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/stats/global-trading-volumes": { "get": { "summary": "Get global trading volume history", "description": "With the global trading volume history endpoint, you can retrieve historical cryptocurrency trading data, enabling you to analyze market trends and track cryptocurrency trading activity over time. On Coinranking, we use this endpoint on our [global trading volume chart.](https://coinranking.com/#global-trading-volume) On Coinranking, we use this endpoint on our [global market cap chart](https://coinranking.com/#global-market-cap).", "operationId": "get_global_trading_volume_history", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "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 Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "interval", "in": "query", "required": false, "description": "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 Default value: day Allowed values: day week month", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "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. Default value: 50 Size range: 1-1000", "schema": { "type": "number", "default": "50", "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/stats/global-market-caps": { "get": { "summary": "Get global market cap history", "description": "With the global market caps history endpoint, you can retrieve historical cryptocurrency market capitalization data, enabling you to analyze trends and track market performance over time. On Coinranking, we use this endpoint on our [global market cap chart](https://coinranking.com/#global-market-cap).", "operationId": "get_global_market_cap_history", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "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 Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "Timeperiod where the marketCap are based on Default value: 24h Allowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/stats": { "get": { "summary": "Get global stats", "description": "These global statistics tell about the data available on coinranking.", "operationId": "get_global_stats", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/stats/coins": { "get": { "summary": "Get stats for selection of coins", "description": "Get stats for a selection of coins.", "operationId": "get_stats_for_selection_of_coins", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "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. Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "Negative changes, positive changes and the change in market cap are influenced by the time period. Default value: 24h Allowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuids", "in": "query", "required": false, "description": "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 tags. If you use both filters, the tag filter takes precedence. Array parameters should be suffixed with brackets. Example: ?uuids[]=razxDUgYGNAdQ&uuids[]=Qwsogvtv82FCd.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "tags", "in": "query", "required": false, "description": "Example value: defi", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/exchange/{uuid}/markets": { "get": { "summary": "Get exchange markets", "description": "Find markets on a specific exchange. On Coinranking, we use this endpoint on our [exchange markets page](https://coinranking.com/exchange/-zdvbieRdZ+binance/markets). This endpoint requires the **ultra** plan or higher.", "operationId": "get_exchange_markets", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "orderBy", "in": "query", "required": false, "description": "Index to sort on. Default is 24h volume. Default value: 24hVolume Allowed values: 24hVolume price", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "orderDirection", "in": "query", "required": false, "description": "Order in ascending or descending order Default value: desc Allowed values: desc asc", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the exchange you want to request markets for", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/exchange/{uuid}/coins": { "get": { "summary": "Get exchange coins", "description": "Find coins listed on a specific exchange. This endpoint requires the **ultra** plan or higher.", "operationId": "get_exchange_coins", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "orderBy", "in": "query", "required": false, "description": "Index to sort on. Default is 24h volume Default value: 24hVolume Allowed values: 24hVolume price numberOfMarkets", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "orderDirection", "in": "query", "required": false, "description": "Order in ascending or descending order Default value: desc Allowed values: asc desc", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the exchange you want to request", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/exchanges": { "get": { "summary": "Get exchanges", "description": "Get a list of exchanges. Exchanges are ranked based on their trading volume in the last 24 hours. This endpoint requires the **ultra** plan or higher.", "operationId": "get_exchanges", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuids", "in": "query", "required": false, "description": "Exchange UUIDs to filter the exchanges on. Array parameters should be suffixed with brackets. Example: ?uuids[]=-zdvbieRdZ&uuids[]=8FXHCkosV.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination. Only usable when no filters are applied Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination. Only usable when no filters are applied Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "orderBy", "in": "query", "required": false, "description": "Order by either 24h volume, number of markets or latest ticker. Ordering can only be done when no filters are applied Default value: 24hVolume Allowed values: 24hVolume numberOfMarkets lastTickerCreatedAt", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "orderDirection", "in": "query", "required": false, "description": "Applies direction to the orderBy query, which can be in ascending or descending order. Only usable when no filters are applied Default value: desc Allowed values: desc asc", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/exchange/{uuid}": { "get": { "summary": "Get exchange", "description": "Find information on a specific exchange listed on coinranking. An exchange is a place where cryptocurrencies are traded. This endpoint requires the **ultra** plan or higher.", "operationId": "get_exchange", "parameters": [ { "name": "uuid", "in": "query", "required": true, "description": "UUID of the exchange you want to request", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/exchange/{uuid}/coins/new": { "get": { "summary": "Get exchange new coins", "description": "Retrieve the latest coin listings on a specific exchange. On Coinranking, we use this endpoint on our [exchange new coin listings page](https://coinranking.com/exchange/-zdvbieRdZ+binance/new-coins).", "operationId": "get_exchange_new_coins", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "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.", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the exchange you want to request", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/rank-history": { "get": { "summary": "Get coin rank history", "description": "With the coin ranks endpoint you can check out how a coin was ranked throughout its existence. We have different rankings available for coins; by [market cap](https://support.coinranking.com/article/104-why-do-we-rank-on-market-cap) (which is also the default ranking on coinranking.com), but also by 24 hour volume moving sum, by their sheer price in USD or in the [fully diluted market cap](https://support.coinranking.com/article/27-coinranking-terminology).", "operationId": "get_coin_rank_history", "parameters": [ { "name": "interval", "in": "query", "required": false, "description": "The interval determines the time period over which each rank item is determined. Default value: day Allowed values: hour day week month", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "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. Default value: 50 Size range: 0-5000", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request the market cap data for. A UUID is our unique identifier for each coin. You can find them in all our coin endpoints, or look them up in the find UUID page.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/markets": { "get": { "summary": "Get coin markets", "description": "Find markets on different exchanges that trade a specific coin. This endpoint requires the **ultra** plan or higher.", "operationId": "get_coin_markets", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "orderBy", "in": "query", "required": false, "description": "Index to sort on. Default is 24h volume. Default value: 24hVolume Allowed values: 24hVolume price", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "orderDirection", "in": "query", "required": false, "description": "Order in ascending or descending order Default value: desc Allowed values: desc asc", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request markets for", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/ohlc": { "get": { "summary": "Get coin OHLC data", "description": "Get OHLCV (Open High Low Close Volume) data for the coin throughout time. This endpoint requires the **ultra** plan or higher.", "operationId": "get_coin_ohlc_data", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar. Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "interval", "in": "query", "required": false, "description": "The interval determines the time period over which each OHLC item is determined. Default value: day Allowed values: minute 5minutes hour 8hours day week month", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit the amount of time periods for which the OHLC data is retrieved. For example, when interval=hour and limit is 10, data will be returned for the last 10 hours. Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request. UUIDs of coins can be found using the Get coins endpoint or by checking the URL on coinranking.com, e.g. https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc is the URL for Bitcoin, and the part before the + (Qwsogvtv82FCd) is the UUID.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/market-cap-history": { "get": { "summary": "Get coin market cap history", "description": "With the coin market-caps endpoint you can check out a coin's historical market cap. The market cap for each coin is determined by the latest price for one coin, multiplied by the amount of coins in circulation.", "operationId": "get_coin_market_cap_history", "parameters": [ { "name": "interval", "in": "query", "required": false, "description": "The interval determines the time period over which each market cap item is determined. Default value: day Allowed values: hour day week month", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "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. Default value: 50 Size range: 0-5000", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request the market cap data for. A UUID is our unique identifier for each coin. You can find them in all our coin endpoints, or look them up in the find UUID page.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/gains-and-losses": { "get": { "summary": "Get coin gains and losses", "description": "Find gains and losses data for a specific coin over different time intervals. On Coinranking we use this endpoint on our coin detail page.", "operationId": "get_coin_gains_and_losses", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar. Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "interval", "in": "query", "required": false, "description": "Time interval for the gains and losses calculation. Default value: day Allowed values: day week month", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Number of gains and losses entries to return. Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request. UUIDs of coins can be found using the Get coins endpoint or by checking the URL on coinranking.com, e.g. https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc is the URL for Bitcoin, and the part before the + (Qwsogvtv82FCd) is the UUID.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/price": { "get": { "summary": "Get coin price", "description": "With the price endpoint the price can be requested for a specific coin on a specific time. The response is just a single price nearest to the requested time, including its timestamp.", "operationId": "get_coin_price", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency. This is the currency the price is shown in, which defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timestamp", "in": "query", "required": false, "description": "Timestamp. Epoch timestamp in seconds. If it is not provided this endpoint will get the latest price", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you need the price", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/history": { "get": { "summary": "Get coin price history", "description": "Coinranking keeps track of prices on all listed assets. The history endpoint lists prices and their timestamp for the requested time period, useful for making a chart.", "operationId": "get_coin_price_history", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "Timeperiod where the change and history are based on Default value: 24h Allowed values: 3h 24h 7d 30d 3m 1y 3y 5y", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coins": { "get": { "summary": "Get coins", "description": "Get a list of coins. Coins are by default ordered by their rank, which - somewhat simplified - means that they are ordered on marketcap. The response not only returns a list of coins, but also statistics regarding the requested list, such as the volume in the last 24 hours.", "operationId": "get_coins", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. This includes the price, the change and the sparkline. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "By setting the timeperiod the change percentage and sparkline in the response will be calculated accordingly Default value: 24h Allowed values: 3h 24h 7d 30d 3m 1y 3y 5y", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "symbols", "in": "query", "required": false, "description": "Symbols to filter the list on. Array parameters should be suffixed with brackets. Example: ?symbols[]=BTC&symbols[]=ETH.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "uuids", "in": "query", "required": false, "description": "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. Array parameters should be suffixed with brackets. Example: ?uuids[]=razxDUgYGNAdQ&uuids[]=Qwsogvtv82FCd.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "tiers", "in": "query", "required": false, "description": "We seperate coins into three tiers. With this parameter you can filter coins on the tiers you need. Read more about out our tiers in our methodology Array parameters should be suffixed with brackets. Example: ?tiers[]=1&tiers[]=2.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "tags", "in": "query", "required": false, "description": "Tags to filter the list on. Allowed values: defi, stablecoin, nft, dex, exchange, staking, dao, meme, privacy Array parameters should be suffixed with brackets. Example: ?tags[]=defi&tags[]=nft.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "orderBy", "in": "query", "required": false, "description": "Index to order by. All sortings excluding listedAt still take our different tiers of coins into account, read more about it in our methodology. Default value: marketCap Allowed values: price marketCap 24hVolume change listedAt", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "orderDirection", "in": "query", "required": false, "description": "Applies direction to the orderBy query, which can be in ascending or descending order. Default value: desc Allowed values: desc asc", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination. Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination. Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}": { "get": { "summary": "Get coin", "description": "Find information about a specific coin.", "operationId": "get_coin", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "timePeriod", "in": "query", "required": false, "description": "Time period where the change and sparkline are based on Default value: 24h Allowed values: 24h 7d 30d", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request. UUIDs of coins can be found using the Get coins endpoint or by checking the URL on coinranking.com, e.g. https://coinranking.com/coin/Qwsogvtv82FCd+bitcoin-btc is the URL for Bitcoin, and the part before the + (Qwsogvtv82FCd) is the UUID.", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/fiat-prices": { "get": { "summary": "Get coin fiat price", "description": "The coin fiat prices endpoint provides real-time cryptocurrency prices in all available fiat currencies, including USD, EUR, GBP, and more. These fiat currencies act as reference currencies in our system, forming the basis for conversions. To learn more about how reference currencies work, see our [reference currencies endpoint.](https://developers.coinranking.com/api/documentation/reference-currencies)", "operationId": "get_coin_fiat_price", "parameters": [ { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you need the price", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/modifiers": { "get": { "summary": "Get coin modifiers", "description": "Get the modifiers of a coin's supply and their balance. This endpoint requires the **ultra** plan or higher.", "operationId": "get_coin_modifiers", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request the modifiers for", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/supply-history": { "get": { "summary": "Get coin supply history", "description": "With the coin supplies endpoint you can check out a coin's historical amount of supplies. You can [read more about supplies in our FAQ.](https://support.coinranking.com/article/108-what-is-the-coin-supply)", "operationId": "get_coin_supply_history", "parameters": [ { "name": "interval", "in": "query", "required": false, "description": "The interval determines the time period over which each supply item is determined. Default value: day Allowed values: hour day week month", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "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. Default value: 50 Size range: 0-5000", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request the supply for", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/issuance-blockchains": { "get": { "summary": "Get coin issuance blockchains", "description": "Get the issuance blockchains on which the coin is issued. This endpoint requires the **ultra** plan or higher.", "operationId": "get_coin_issuance_blockchains", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request the blockchains for", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/coin/{uuid}/exchanges": { "get": { "summary": "Get coin exchanges", "description": "Find exchanges where a specific coin can be traded. This endpoint requires the **ultra** plan or higher.", "operationId": "get_coin_exchanges", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "orderBy", "in": "query", "required": false, "description": "Index to order by. Default is 24h volume. Default value: 24hVolume Allowed values: 24hVolume price", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "orderDirection", "in": "query", "required": false, "description": "Order in ascending or descending order Default value: desc Allowed values: desc asc", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "UUID of the coin you want to request exchanges for", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/indexes/exchanges": { "get": { "summary": "Get exchanges index", "description": "List of all exchanges currently available on Coinranking, for indexing purposes. This endpoint requires the **ultra** plan or higher.", "operationId": "get_exchanges_index", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/indexes/coins": { "get": { "summary": "Get coins index", "description": "List of all coins currently available on coinranking, for indexing purposes. This endpoint requires the **ultra** plan or higher.", "operationId": "get_coins_index", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/market/{uuid}": { "get": { "summary": "Get market", "description": "Find information on a specific market listed on Coinranking. This endpoint requires the **ultra** plan or higher.", "operationId": "get_market", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "Uuid of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "uuid", "in": "query", "required": true, "description": "Uuid of the market you want to request", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/reference-currencies": { "get": { "summary": "Get reference currencies", "description": "Get a list of reference currencies, which can be used as reference for coins. The response includes all the essentials for this use-case, such as the symbol (e.g. USD) and - if available - the sign (e.g. $).", "operationId": "get_reference_currencies", "parameters": [ { "name": "types", "in": "query", "required": false, "description": "A currency is one of three types: coin (e.g. Bitcoin, Ethereum, etc.), fiat (US Dollar, Euro, Yen, etc.) or a denominator (e.g. Satoshi). Filter the response by providing one or more types Allowed values: coin, fiat, denominator Array parameters should be suffixed with brackets. Example: ?types[]=coin&types[]=fiat.", "schema": { "type": "array", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination Default value: 20 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } }, "/markets": { "get": { "summary": "Get markets", "description": "Get a list of markets. Markets are ranked by their volume over the last 24 hours. Use our filters to get a subset of the markets. This endpoint requires the **ultra** plan or higher.", "operationId": "get_markets", "parameters": [ { "name": "referenceCurrencyUuid", "in": "query", "required": false, "description": "UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "currencyUuid", "in": "query", "required": false, "description": "Filter markets with specific currency as either base or quote. Specifying a currencyUuid will also alter how prices are shown: By default all the markets will show the price of the base in the reference currency (e.g. an ETH/BTC market will show the price of ETH). By specifying a currencyUuid the prices of this currency will always be shown, disregarding whether or not this currency represents the base or the quote in the market (e.g. by specifying BTC as currency, both ETH/BTC as BTC/USD market", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "toCurrencyUuid", "in": "query", "required": false, "description": "Filter markets with specific currency as either base or quote. The toCurrencyUuid will not alter how the prices will be shown, but will keep the base price. This can be combined with the currencyUuid variable to get specific markets.", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "baseCurrencyUuid", "in": "query", "required": false, "description": "Filter markets with specific currency as base", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "quoteCurrencyUuid", "in": "query", "required": false, "description": "Filter markets with specific currency as quote", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "limit", "in": "query", "required": false, "description": "Limit. Used for pagination. Only usable when no filters are applied Default value: 50 Size range: 0-100", "schema": { "type": "number", "default": "50", "enum": null } }, { "name": "offset", "in": "query", "required": false, "description": "Offset. Used for pagination only usable when no filters are applied Default value: 0", "schema": { "type": "number", "default": "0", "enum": null } }, { "name": "orderBy", "in": "query", "required": false, "description": "Sort by either 24h volume or price. Only usable when no filters are applied Default value: 24hVolume Allowed values: 24hVolume price", "schema": { "type": "string", "default": null, "enum": null } }, { "name": "orderDirection", "in": "query", "required": false, "description": "Sort in ascending or descending order. Only usable when no filters are applied. Default value: desc Allowed values: desc asc", "schema": { "type": "string", "default": null, "enum": null } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": {} } } } } } } }, "components": { "securitySchemes": { "ApiAuth": { "type": "apiKey", "in": "header", "name": "X-RapidAPI-Key" } } }, "security": [ { "ApiAuth": [] } ] }