NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
Coinranking connects to a Nagent workspace with an API key. Once it is connected, agents can call 14 Coinranking actions, such as "Get Coin Details", "Get Coin Fiat Prices" and "Get Coin History". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against Coinranking, with input parameters and output schema.
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
Agents can call 14 Coinranking actions on Nagent, including "Get Coin Details", "Get Coin Fiat Prices" and "Get Coin History". 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. Each action is listed on this page with its input parameters and its output.
Coinranking connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Get Coin Details takes 1 required input: uuid. It also takes 2 optional inputs: timePeriod and referenceCurrencyUuid. It returns data, error and successful.