Coinranking provides a comprehensive API for accessing cryptocurrency market data, including coin prices, market caps, and historical data.
Coinranking provides a comprehensive API for accessing cryptocurrency market data, including coin prices, market caps, and historical data. On Nagent, Coinranking is exposed as a fully-configurable analytics integration that any agent can call — 14 actions, and API key authentication. No code is required to wire Coinranking into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Coinranking to automate the kinds of tasks analytics teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Coinranking into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Coinranking, with input parameters and output schema. Drop these into any step of an agent built in Helix.
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
UUID of the coin to retrieve details for. Example: 'Qwsogvtv82FCd' for Bitcoin.
Time period for calculating price change and sparkline data. Valid options: '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y'.
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: 'yhjMzLPhuIDl' for USD.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINRANKING_GET_COIN_FIAT_PRICESTool 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
UUID of the coin to retrieve fiat prices for. Example: 'Qwsogvtv82FCd' for Bitcoin.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
UUID of the coin to retrieve history for
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.
UUID of the currency to show prices in (optional)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINRANKING_GET_COIN_PRICETool 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
UUID of the coin to retrieve the price for. Example: 'Qwsogvtv82FCd' for Bitcoin.
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.
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: 'yhjMzLPhuIDl' for USD.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
UUID of the coin to retrieve price history for
Time period for historical data; one of '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y'
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl) if not specified
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINRANKING_GET_COINSRetrieve 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
Number of results to return per request. Range: 1-100. Default: 50.
Filter by quality tier (comma-separated). '1' = highest quality coins. Example: '1' or '1,2'.
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'.
Field to sort results by. Options: 'marketCap' (default), 'price', 'change', '24hVolume', 'listedAt'.
Time period for calculating price change and sparkline data. Valid options: '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y'.
Sort order: 'desc' (descending, default) or 'asc' (ascending).
UUID of the reference currency for pricing. Defaults to USD (yhjMzLPhuIDl). Example: 'yhjMzLPhuIDl' for USD.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINRANKING_GET_COIN_TRADING_VOLUME_HISTORYTool 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
UUID of the coin to retrieve trading volume history for
Number of history entries to return. Range: 1-5000. Default: 50
The interval determines the time period over which each volume item is aggregated. Options: 'hour', 'day' (default), 'week', 'month'
UUID of the reference currency for volume expression. Default: yhjMzLPhuIDl (US Dollar)
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Maximum number of reference currencies to return. Default: 20, Max: 100 (free tier).
Filter by currency types. Valid values: 'coin', 'fiat', 'denominator', 'asset'.
Cursor for pagination. Use nextCursor from previous response to get next page.
Pagination offset - number of items to skip before starting to collect the result set.
Filter results by searching for currency names or symbols (e.g., 'USD', 'Bitcoin').
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINRANKING_GET_STATSTool to retrieve global cryptocurrency market statistics. Use when you need an overview of the entire crypto market.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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 of coin UUIDs to include in statistics calculation. Example: \['Qwsogvtv82FCd', 'razxDUgYGNAdQ'\].
Time period for price change calculations. Valid options: '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y'.
UUID of the reference currency for values. Defaults to USD (yhjMzLPhuIDl). Example: 'yhjMzLPhuIDl' for USD.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Slug identifier for the tag (e.g., 'defi', 'nft', 'stablecoin'). This is a short URL-friendly name that uniquely identifies the tag.
Time period for calculating change metrics (e.g., marketCapChange). Valid options: '1h', '3h', '12h', '24h' (default), '7d', '30d', '3m', '1y', '3y', '5y'.
UUID of the reference currency for pricing and metrics. Defaults to USD (yhjMzLPhuIDl) if not specified. Example: 'yhjMzLPhuIDl' for USD.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINRANKING_GET_TAGSGet 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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
COINRANKING_GET_TRENDING_COINSRetrieve 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
Number of results per request. Default: 50. Maximum: 5000.
Comma-separated list of coin tiers to filter by (1, 2, or 3). Example: '1,2' for tier 1 and 2 coins.
Pagination offset for results. Default: 0.
Time range for calculations. Options: 1h, 3h, 12h, 24h, 7d, 30d, 3m, 1y, 3y, 5y. Defaults to 24h.
UUID of the reference currency for price calculation. Defaults to USD (yhjMzLPhuIDl) if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
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
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 47 agents privately built on Nagent that already use Coinranking.
Build on Nagent
Connect Coinranking to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Coinranking, and click "Connect Now." You'll authenticate with an API key — Nagent handles credential storage and refresh automatically. Once connected, Coinranking is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Coinranking is connected, you configure its 14 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Coinranking steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Coinranking event fires, the agent kicks off automatically.
Every Coinranking action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Coinranking ships with 14 pre-built analytics actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Coinranking together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Coinranking-based workflows tailored to your business.