Skip to main content
Coinranking logo
  • Category: analytics
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 14
  • Triggers: 0
  • Slug: COINRANKING
  • Version: 20261101_00

Tools

Slug: COINRANKING_GET_COIN_DETAILSRetrieve comprehensive details for a specific cryptocurrency including current price, market cap, supply metrics, description, social links, sparkline data, and historical performance. Use when you need in-depth information about a specific coin beyond basic list data.

Input Parameters

string
required
UUID of the coin to retrieve details for. Example: ‘Qwsogvtv82FCd’ for Bitcoin.
string
Time period for calculating price change and sparkline data. Valid options: ‘1h’, ‘3h’, ‘12h’, ‘24h’ (default), ‘7d’, ‘30d’, ‘3m’, ‘1y’, ‘3y’, ‘5y’.
string
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: ‘yhjMzLPhuIDl’ for USD.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_COIN_FIAT_PRICESRetrieve the current price of a cryptocurrency across available fiat currencies, including USD, EUR, and GBP. Free, Basic, and Startup plans can test the endpoint with up to five successful requests per account per UTC day.

Input Parameters

string
required
UUID of the coin to retrieve fiat prices for. Example: ‘Qwsogvtv82FCd’ for Bitcoin.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_COIN_HISTORYTool to retrieve historical price data for a specific coin over a time period. Use when you need to analyze past performance of a coin; call after confirming its UUID.

Input Parameters

string
required
UUID of the coin to retrieve history for
string ("24h" | "7d" | "30d" | "1y" | "5y")
Time interval for the history data; one of ‘24h’, ‘7d’, ‘30d’, ‘1y’, ‘5y’ (optional) Longer periods (e.g., ‘5y’) return larger payloads; use narrower intervals when full history is unnecessary.
string
UUID of the currency to show prices in (optional)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_COIN_PRICERetrieve the latest price of a cryptocurrency coin or the nearest available historical price to a specified timestamp. Historical price points are aggregated by minute, hour, or day depending on the age of the request.

Input Parameters

string
required
UUID of the coin to retrieve the price for. Example: ‘Qwsogvtv82FCd’ for Bitcoin.
integer
Unix timestamp (in seconds) for historical price lookup. If not provided, returns the current price. The returned timestamp might differ slightly as it is rounded to the nearest day, hour, or minute.
string
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: ‘yhjMzLPhuIDl’ for USD.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_COIN_PRICE_HISTORYTool to retrieve historical price data points for a specific coin over selectable time periods. Use when you need price history for charting, backtesting, or trend analysis. Call after confirming the coin’s UUID.

Input Parameters

string
required
UUID of the coin to retrieve price history for
string ("1h" | "3h" | "12h" | "24h" | "7d" | "30d" | "3m" | "1y" | "3y" | "5y")
Time period for historical data; one of ‘1h’, ‘3h’, ‘12h’, ‘24h’ (default), ‘7d’, ‘30d’, ‘3m’, ‘1y’, ‘3y’, ‘5y’
string
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl) if not specified

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_COINSRetrieve a page of cryptocurrency coins with market data, including prices, market caps, rankings and sparklines; price, market cap and 24-hour volume are strings. Supports search, tier filtering, sorting and offset pagination; the API defaults to tiers 1 and 2 and limits offsets to 5,000.

Input Parameters

integer
Number of results to return per request. Range: 1-100. Default: 50.
string
Filter by quality tier (comma-separated). ‘1’ = highest quality coins. Example: ‘1’ or ‘1,2’.
integer
Number of results to skip for pagination. Use with limit for pagination. Default: 0.
Search query to filter coins by name or symbol. Supports partial matches. Example: ‘Bitcoin’ or ‘BTC’.
string ("marketCap" | "price" | "change" | "24hVolume" | "listedAt")
Field to sort results by. Options: ‘marketCap’ (default), ‘price’, ‘change’, ‘24hVolume’, ‘listedAt’.
string
Time period for calculating price change and sparkline data. Valid options: ‘1h’, ‘3h’, ‘12h’, ‘24h’ (default), ‘7d’, ‘30d’, ‘3m’, ‘1y’, ‘3y’, ‘5y’.
string ("asc" | "desc")
Sort order: ‘desc’ (descending, default) or ‘asc’ (ascending).
string
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: ‘yhjMzLPhuIDl’ for USD.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_COIN_TRADING_VOLUME_HISTORYRetrieve historical trading volume data for a specific coin to build volume charts and analyze liquidity trends. Free, Basic, and Startup plans can access the endpoint in preview, subject to a daily allowance and plan limits.

Input Parameters

string
required
UUID of the coin to retrieve trading volume history for
integer
Number of history entries to return. Range: 1-5000. Default: 50
string ("hour" | "day" | "week" | "month")
The interval determines the time period over which each volume item is aggregated. Options: ‘hour’, ‘day’ (default), ‘week’, ‘month’
string
UUID of the reference currency for volume expression. Default: yhjMzLPhuIDl (US Dollar)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_REFERENCE_CURRENCIESRetrieve a comprehensive list of reference currencies including cryptocurrencies, fiat currencies (USD, EUR, etc.), denominators (Satoshi, Wei), and assets (Gold, Silver). Use this to get available currencies for price conversions, with support for filtering by type, searching by name/symbol, and pagination.

Input Parameters

integer
Maximum number of reference currencies to return. Default: 20, Max: 100 (free tier).
array
Filter by currency types. Valid values: ‘coin’, ‘fiat’, ‘denominator’, ‘asset’.
string
Cursor for pagination. Use nextCursor from previous response to get next page.
integer
Pagination offset - number of items to skip before starting to collect the result set.
string
Filter results by searching for currency names or symbols (e.g., ‘USD’, ‘Bitcoin’).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_STATSTool to retrieve global cryptocurrency market statistics. Use when you need an overview of the entire crypto market.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_STATS_COINSTool to retrieve aggregate statistics for a selection of coins. Use when you need to calculate combined metrics for custom baskets, watchlists, or index products including market cap, trading volume, price changes, and dominance.

Input Parameters

array
Array of coin UUIDs to include in statistics calculation. Example: [‘Qwsogvtv82FCd’, ‘razxDUgYGNAdQ’].
string
Time period for price change calculations. Valid options: ‘1h’, ‘3h’, ‘12h’, ‘24h’ (default), ‘7d’, ‘30d’, ‘3m’, ‘1y’, ‘3y’, ‘5y’.
string
UUID of the reference currency for values. Defaults to USD (yhjMzLPhuIDl). Example: ‘yhjMzLPhuIDl’ for USD.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_TAG_DETAILSGet detailed information about a specific cryptocurrency tag including market metrics, volume, associated coin count, and dominance data. Use when you need comprehensive information about a tag category (e.g., DeFi, NFT, Stablecoins) including its market performance and statistics.

Input Parameters

string
required
Slug identifier for the tag (e.g., ‘defi’, ‘nft’, ‘stablecoin’). This is a short URL-friendly name that uniquely identifies the tag.
string
Time period for calculating change metrics (e.g., marketCapChange). Valid options: ‘1h’, ‘3h’, ‘12h’, ‘24h’ (default), ‘7d’, ‘30d’, ‘3m’, ‘1y’, ‘3y’, ‘5y’.
string
UUID of the reference currency for pricing and metrics. Defaults to USD (yhjMzLPhuIDl) if not specified. Example: ‘yhjMzLPhuIDl’ for USD.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_GET_TAGSGet the first page of Coinranking cryptocurrency tags, including categories and ecosystems, with descriptive information, coin counts, and available market metrics. No parameters are required; tag slugs can be used to filter coins.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: COINRANKING_SEARCH_SUGGESTIONSTool to search and get suggestions for coins, markets, exchanges, fiat currencies, and categories by name, symbol, or contract address. Use when you need fast search suggestions across multiple entity types in the cryptocurrency space.

Input Parameters

string
required
Search query string to find coins, markets, exchanges, fiat currencies, or categories by name, symbol, or contract address. Example: ‘bitcoin’ or ‘btc’ or ‘0x…’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not