加密货币数据接口服务器

Coinranking1 MCP Server

English |Simplified Chinese| Traditional Chinese

MCP server used to access Coinranking1 API.

🚀 Quickly experience using the EMCP platform

EMCP It is a powerful MCP server management platform that allows you to quickly use various MCP servers without manual configuration!

Quick Start:

1. 🌐 visit EMCP platform
2. 📝 Register and log in to your account
3. 🎯 enter MCP SquareBrowse all available MCP servers
4. 🔍 Search or find this server（bach-coinranking1）
5. 🎉 click Install MCP button
6. ✅ Done! Can be used in your application

Advantages of the EMCP platform:

• ✨ Zero configurationNo need to manually edit configuration files
• 🎨 Visual managementEasily manage all MCP servers through a graphical interface
• 🔐 safe and reliableUnified management of API keys and authentication information
• 🚀 One-click installationMCP Square offers a wide range of server options
• 📊 Use statisticsReal time viewing of service invocation status

Visit Now EMCP platform Start your MCP journey!

Introduction

This is an MCP server used to access the Coinranking1 API.

• PyPI package name: bach-coinranking1
• version: 1.0.0
• transmission protocol: stdio

install

Install from PyPI:

pip install bach-coinranking1

Install from source code:

pip install -e .

run

Method 1: Use UVX (recommended, no installation required)

# 运行（uvx 会自动安装并运行）
uvx --from bach-coinranking1 bach_coinranking1

# 或指定版本
uvx --from bach-coinranking1@latest bach_coinranking1

Method 2: Direct Run (Development Mode)

python server.py

Method 3: Run as a command after installation

# 安装
pip install bach-coinranking1

# 运行（命令名使用下划线）
bach_coinranking1

configuration

API certification

This API requires authentication. Please set environment variables:

export API_KEY="your_api_key_here"

environment variable

Use in cursor

Edit cursor MCP configuration file ~/.cursor/mcp.json:

{
  "mcpServers": {
    "bach-coinranking1": {
      "command": "uvx",
      "args": ["--from", "bach-coinranking1", "bach_coinranking1"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Using Claude Desktop

Edit Claude Desktop configuration file claude_desktop_config.json:

{
  "mcpServers": {
    "bach-coinranking1": {
      "command": "uvx",
      "args": ["--from", "bach-coinranking1", "bach_coinranking1"],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

This server provides the following tools:

get_trending_coins

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.

endpoint: GET /coins/trending

parameter:

• referenceCurrencyUuid (string): 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

• timePeriod (string): 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

• tiers (array): 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.

• limit (number): Limit. Used for pagination. Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination. Default value: 0

get_blockchain_uuid_by_contract_address

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.

endpoint: GET /blockchain/{blockchain}/{address}

parameter:

• blockchain (string) necessary: 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.

• address (string) necessary: 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.

get_blockchain_details

Find a blockchain

endpoint: GET /blockchain/{name}

parameter:

• name (string) necessary: Name of the blockchain you want to request. You can find a list of all possible values by making a request to blockchains endpoint.

get_blockchains

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.

endpoint: GET /blockchains

get_bulk_data_of_all_coins

$237

endpoint: GET /bulk/coins

get_search_suggestions

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.

endpoint: GET /search-suggestions

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which the coin prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl

• query (string): Value to search on

get_list_of_tags

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.

endpoint: GET /tags

parameter:

• referenceCurrencyUuid (string): 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

• timePeriod (string): 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

get_tag_details

Find information about a specific tag. On Coinranking, we use this data on our coin categories page.

endpoint: GET /tag/{slug}

parameter:

• referenceCurrencyUuid (string): 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

• timePeriod (string): 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

• slug (string) necessary: Slug of the tag you want to request. Consult the tags endpoint for possible slug values.

get_bitcoin_dominance_history

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. On Coinranking, we use this endpoint on our global trading volume chart. On Coinranking, we use this endpoint on our global market cap chart.

endpoint: GET /stats/bitcoin-dominance-history

parameter:

• referenceCurrencyUuid (string): 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

• timePeriod (string): 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

get_global_trading_volume_history

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. On Coinranking, we use this endpoint on our global market cap chart.

endpoint: GET /stats/global-trading-volumes

parameter:

• referenceCurrencyUuid (string): 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

• interval (string): 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

• limit (number): 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

get_global_market_cap_history

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.

endpoint: GET /stats/global-market-caps

parameter:

• referenceCurrencyUuid (string): 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

• timePeriod (string): Timeperiod where the marketCap are based on Default value: 24h Allowed values: 1h 3h 12h 24h 7d 30d 3m 1y 3y 5y

get_global_stats

These global statistics tell about the data available on coinranking.

endpoint: GET /stats

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl

get_stats_for_selection_of_coins

Get stats for a selection of coins.

endpoint: GET /stats/coins

parameter:

• referenceCurrencyUuid (string): 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

• timePeriod (string): 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

• uuids (array): 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.

• tags (string): Example value: defi

get_exchange_markets

Find markets on a specific exchange. On Coinranking, we use this endpoint on our exchange markets page. This endpoint requires the ultra plan or higher.

endpoint: GET /exchange/{uuid}/markets

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl

• limit (number): Limit. Used for pagination Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination Default value: 0

• orderBy (string): Index to sort on. Default is 24h volume. Default value: 24hVolume Allowed values: 24hVolume price

• orderDirection (string): Order in ascending or descending order Default value: desc Allowed values: desc asc

• uuid (string) necessary: UUID of the exchange you want to request markets for

get_exchange_coins

Find coins listed on a specific exchange. This endpoint requires the ultra plan or higher.

endpoint: GET /exchange/{uuid}/coins

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl

• limit (number): Limit. Used for pagination Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination Default value: 0

• orderBy (string): Index to sort on. Default is 24h volume Default value: 24hVolume Allowed values: 24hVolume price numberOfMarkets

• orderDirection (string): Order in ascending or descending order Default value: desc Allowed values: asc desc

• uuid (string) necessary: UUID of the exchange you want to request

get_exchanges

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.

endpoint: GET /exchanges

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl

• uuids (array): Exchange UUIDs to filter the exchanges on. Array parameters should be suffixed with brackets. Example: ? uuids[]=-zdvbieRdZ&uuids[]=8FXHCkosV.

• limit (number): Limit. Used for pagination. Only usable when no filters are applied Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination. Only usable when no filters are applied Default value: 0

• orderBy (string): 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

• orderDirection (string): 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

get_exchange

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.

endpoint: GET /exchange/{uuid}

parameter:

• uuid (string) necessary: UUID of the exchange you want to request

• referenceCurrencyUuid (string): UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl

• referenceCurrencyUuid (string): UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl

get_exchange_new_coins

Retrieve the latest coin listings on a specific exchange. On Coinranking, we use this endpoint on our exchange new coin listings page.

endpoint: GET /exchange/{uuid}/coins/new

parameter:

• referenceCurrencyUuid (string): 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.

• uuid (string) necessary: UUID of the exchange you want to request

• referenceCurrencyUuid (string): UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl

get_coin_rank_history

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 (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.

endpoint: GET /coin/{uuid}/rank-history

parameter:

• interval (string): The interval determines the time period over which each rank item is determined. Default value: day Allowed values: hour day week month

• limit (number): 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

• uuid (string) necessary: 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.

get_coin_markets

Find markets on different exchanges that trade a specific coin. This endpoint requires the ultra plan or higher.

endpoint: GET /coin/{uuid}/markets

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl

• limit (number): Limit. Used for pagination Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination Default value: 0

• orderBy (string): Index to sort on. Default is 24h volume. Default value: 24hVolume Allowed values: 24hVolume price

• orderDirection (string): Order in ascending or descending order Default value: desc Allowed values: desc asc

• uuid (string) necessary: UUID of the coin you want to request markets for

get_coin_ohlc_data

Get OHLCV (Open High Low Close Volume) data for the coin throughout time. This endpoint requires the ultra plan or higher.

endpoint: GET /coin/{uuid}/ohlc

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar. Default value: yhjMzLPhuIDl

• interval (string): 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

• limit (number): 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

• uuid (string) necessary: 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.

get_coin_market_cap_history

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.

endpoint: GET /coin/{uuid}/market-cap-history

parameter:

• interval (string): The interval determines the time period over which each market cap item is determined. Default value: day Allowed values: hour day week month

• limit (number): 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

• uuid (string) necessary: 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.

get_coin_gains_and_losses

Find gains and losses data for a specific coin over different time intervals. On Coinranking we use this endpoint on our coin detail page.

endpoint: GET /coin/{uuid}/gains-and-losses

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar. Default value: yhjMzLPhuIDl

• interval (string): Time interval for the gains and losses calculation. Default value: day Allowed values: day week month

• limit (number): Number of gains and losses entries to return. Default value: 50 Size range: 0-100

• uuid (string) necessary: 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.

get_coin_price

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.

endpoint: GET /coin/{uuid}/price

parameter:

• referenceCurrencyUuid (string): UUID of reference currency. This is the currency the price is shown in, which defaults to US Dollar Default value: yhjMzLPhuIDl

• timestamp (number): Timestamp. Epoch timestamp in seconds. If it is not provided this endpoint will get the latest price

• uuid (string) necessary: UUID of the coin you need the price

get_coin_price_history

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.

endpoint: GET /coin/{uuid}/history

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl

• timePeriod (string): Timeperiod where the change and history are based on Default value: 24h Allowed values: 3h 24h 7d 30d 3m 1y 3y 5y

• uuid (string) necessary: UUID of the coin you want to request

get_coins

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.

endpoint: GET /coins

parameter:

• referenceCurrencyUuid (string): 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

• timePeriod (string): 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

• symbols (array): Symbols to filter the list on. Array parameters should be suffixed with brackets. Example: ? symbols[]=BTC&symbols[]=ETH.

• uuids (array): 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.

• tiers (array): 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.

• tags (array): 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.

• orderBy (string): 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

• orderDirection (string): Applies direction to the orderBy query, which can be in ascending or descending order. Default value: desc Allowed values: desc asc

• limit (number): Limit. Used for pagination. Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination. Default value: 0

get_coin

Find information about a specific coin.

endpoint: GET /coin/{uuid}

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl

• timePeriod (string): Time period where the change and sparkline are based on Default value: 24h Allowed values: 24h 7d 30d

• uuid (string) necessary: 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.

get_coin_fiat_price

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.

endpoint: GET /coin/{uuid}/fiat-prices

parameter:

• uuid (string) necessary: UUID of the coin you need the price

get_coin_modifiers

Get the modifiers of a coin's supply and their balance. This endpoint requires the ultra plan or higher.

endpoint: GET /coin/{uuid}/modifiers

parameter:

• limit (number): Limit. Used for pagination Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination Default value: 0

• uuid (string) necessary: UUID of the coin you want to request the modifiers for

get_coin_supply_history

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.

endpoint: GET /coin/{uuid}/supply-history

parameter:

• interval (string): The interval determines the time period over which each supply item is determined. Default value: day Allowed values: hour day week month

• limit (string): 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

• uuid (string) necessary: UUID of the coin you want to request the supply for

get_coin_issuance_blockchains

Get the issuance blockchains on which the coin is issued. This endpoint requires the ultra plan or higher.

endpoint: GET /coin/{uuid}/issuance-blockchains

parameter:

• limit (number): Limit. Used for pagination Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination Default value: 0

• uuid (string) necessary: UUID of the coin you want to request the blockchains for

get_coin_exchanges

Find exchanges where a specific coin can be traded. This endpoint requires the ultra plan or higher.

endpoint: GET /coin/{uuid}/exchanges

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, which rate is used to calculate the volume. Defaults to US Dollar Default value: yhjMzLPhuIDl

• limit (number): Limit. Used for pagination Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination Default value: 0

• orderBy (string): Index to order by. Default is 24h volume. Default value: 24hVolume Allowed values: 24hVolume price

• orderDirection (string): Order in ascending or descending order Default value: desc Allowed values: desc asc

• uuid (string) necessary: UUID of the coin you want to request exchanges for

get_exchanges_index

List of all exchanges currently available on Coinranking, for indexing purposes. This endpoint requires the ultra plan or higher.

endpoint: GET /indexes/exchanges

get_coins_index

List of all coins currently available on coinranking, for indexing purposes. This endpoint requires the ultra plan or higher.

endpoint: GET /indexes/coins

get_market

Find information on a specific market listed on Coinranking. This endpoint requires the ultra plan or higher.

endpoint: GET /market/{uuid}

parameter:

• referenceCurrencyUuid (string): Uuid of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl

• uuid (string) necessary: Uuid of the market you want to request

get_reference_currencies

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. $).

endpoint: GET /reference-currencies

parameter:

• types (array): 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.

• limit (number): Limit. Used for pagination Default value: 20 Size range: 0-100

• offset (number): Offset. Used for pagination Default value: 0

get_markets

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.

endpoint: GET /markets

parameter:

• referenceCurrencyUuid (string): UUID of reference currency, in which all the prices are calculated. Defaults to US Dollar Default value: yhjMzLPhuIDl

• currencyUuid (string): 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

• toCurrencyUuid (string): 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.

• baseCurrencyUuid (string): Filter markets with specific currency as base

• quoteCurrencyUuid (string): Filter markets with specific currency as quote

• limit (number): Limit. Used for pagination. Only usable when no filters are applied Default value: 50 Size range: 0-100

• offset (number): Offset. Used for pagination only usable when no filters are applied Default value: 0

• orderBy (string): Sort by either 24h volume or price. Only usable when no filters are applied Default value: 24hVolume Allowed values: 24hVolume price

• orderDirection (string): Sort in ascending or descending order. Only usable when no filters are applied. Default value: desc Allowed values: desc asc

tech stack

• transmission protocol: stdio
• HTTP client: httpx

license

MIT License - see details LICENSE Document.

development

This server is composed of API-to-MCP Tool generation.

Version: 1.0.0