# Coinranking

Coinranking provides a comprehensive API for accessing cryptocurrency market data, including coin prices, market caps, and historical data.

- **Category:** analytics
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 14
- **Triggers:** 0
- **Slug:** `COINRANKING`
- **Version:** 20260316_00

## Tools

### Get Coin Details

**Slug:** `COINRANKING_GET_COIN_DETAILS`

Retrieve 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the coin to retrieve details for. Example: 'Qwsogvtv82FCd' for Bitcoin. |
| `timePeriod` | string | No | Time period for calculating price change and sparkline data. Valid options: '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y'. |
| `referenceCurrencyUuid` | string | No | UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: 'yhjMzLPhuIDl' for USD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Fiat Prices

**Slug:** `COINRANKING_GET_COIN_FIAT_PRICES`

Tool to retrieve the current price of a cryptocurrency in all available fiat currencies including USD, EUR, GBP, and more. Use when you need to see how much a coin is worth across multiple fiat currencies simultaneously. Note: This endpoint requires a Professional plan or higher.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the coin to retrieve fiat prices for. Example: 'Qwsogvtv82FCd' for Bitcoin. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin History

**Slug:** `COINRANKING_GET_COIN_HISTORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | UUID of the coin to retrieve history for |
| `timePeriod` | string ("24h" | "7d" | "30d" | "1y" | "5y") | No | 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. |
| `referenceCurrencyUuid` | string | No | UUID of the currency to show prices in (optional) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Price

**Slug:** `COINRANKING_GET_COIN_PRICE`

Tool to retrieve the current price or historical price at a specific timestamp for a cryptocurrency coin. Use when you need to get the current valuation of a coin or look up its price at a historical point in time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the coin to retrieve the price for. Example: 'Qwsogvtv82FCd' for Bitcoin. |
| `timestamp` | integer | No | 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. |
| `referenceCurrencyUuid` | string | No | UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: 'yhjMzLPhuIDl' for USD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Price History

**Slug:** `COINRANKING_GET_COIN_PRICE_HISTORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the coin to retrieve price history for |
| `timePeriod` | string ("1h" | "3h" | "12h" | "24h" | "7d" | "30d" | "3m" | "1y" | "3y" | "5y") | No | Time period for historical data; one of '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y' |
| `referenceCurrencyUuid` | string | No | UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl) if not specified |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coins

**Slug:** `COINRANKING_GET_COINS`

Retrieve a comprehensive list of cryptocurrency coins with detailed market data including prices, market caps, rankings, and price history. Supports filtering by search terms, quality tiers, and sorting by various metrics like market cap, price, or volume. Ideal for: - Getting top cryptocurrencies by market cap - Searching for specific coins by name or symbol - Filtering high-quality coins (tier 1) - Analyzing price changes over different time periods - Paginating through large result sets Returns detailed coin information including current price, market cap, 24h volume, price change percentages, sparkline data, and all-time high values. Note: numeric fields in responses (price, marketCap, 24hVolume) are returned as strings — cast to numeric types before arithmetic or comparisons.

#### Input Parameters

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Coin Trading Volume History

**Slug:** `COINRANKING_GET_COIN_TRADING_VOLUME_HISTORY`

Tool to retrieve historical trading volume data for a specific coin to build volume charts and analyze liquidity trends. Use when you need to analyze trading volume patterns over time; requires a professional plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuid` | string | Yes | UUID of the coin to retrieve trading volume history for |
| `limit` | integer | No | Number of history entries to return. Range: 1-5000. Default: 50 |
| `interval` | string ("hour" | "day" | "week" | "month") | No | The interval determines the time period over which each volume item is aggregated. Options: 'hour', 'day' (default), 'week', 'month' |
| `referenceCurrencyUuid` | string | No | UUID of the reference currency for volume expression. Default: yhjMzLPhuIDl (US Dollar) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Reference Currencies

**Slug:** `COINRANKING_GET_REFERENCE_CURRENCIES`

Retrieve 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Global Crypto Market Stats

**Slug:** `COINRANKING_GET_STATS`

Tool to retrieve global cryptocurrency market statistics. Use when you need an overview of the entire crypto market.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Stats for Selected Coins

**Slug:** `COINRANKING_GET_STATS_COINS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `uuids` | array | No | Array of coin UUIDs to include in statistics calculation. Example: ['Qwsogvtv82FCd', 'razxDUgYGNAdQ']. |
| `timePeriod` | string | No | Time period for price change calculations. Valid options: '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y'. |
| `referenceCurrencyUuid` | string | No | UUID of the reference currency for values. Defaults to USD (yhjMzLPhuIDl). Example: 'yhjMzLPhuIDl' for USD. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tag Details

**Slug:** `COINRANKING_GET_TAG_DETAILS`

Get 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tags

**Slug:** `COINRANKING_GET_TAGS`

Get all available cryptocurrency tags/categories from Coinranking. Tags are used to categorize cryptocurrencies (e.g., DeFi, NFT, Stablecoins, Meme coins, etc.). This endpoint returns comprehensive information about each tag including market metrics, number of coins, and descriptive information. Tags can be used to filter coins in other endpoints. No parameters required - returns all available tags with their current statistics.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Trending Coins

**Slug:** `COINRANKING_GET_TRENDING_COINS`

Retrieve a list of trending cryptocurrency coins ranked by user engagement and popularity on Coinranking. Supports optional filtering by reference currency, time period, coin tiers, and pagination. Returns detailed coin information including prices, market cap, 24h volume, sparklines, and contract addresses. Ideal for displaying trending coins in dashboards, market analysis, or tracking popular cryptocurrencies.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of results per request. Default: 50. Maximum: 5000. |
| `tiers` | string | No | Comma-separated list of coin tiers to filter by (1, 2, or 3). Example: '1,2' for tier 1 and 2 coins. |
| `offset` | integer | No | Pagination offset for results. Default: 0. |
| `timePeriod` | string | No | Time range for calculations. Options: 1h, 3h, 12h, 24h, 7d, 30d, 3m, 1y, 3y, 5y. Defaults to 24h. |
| `referenceCurrencyUuid` | string | No | UUID of the reference currency for price calculation. Defaults to USD (yhjMzLPhuIDl) if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Suggestions

**Slug:** `COINRANKING_SEARCH_SUGGESTIONS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `query` | string | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |