canonical: https://jentic.com/apis/nomics.com/nomics # Nomics Cryptocurrency API Jentic publishes the only available OpenAPI specification for Nomics Cryptocurrency API, keeping it validated and agent-ready. Nomics provides cryptocurrency market data covering thousands of coins and exchanges, with current and historical prices, volumes, market caps, OHLCV candles, and exchange-rate conversions. The API is built around currency tickers, exchange tickers, market data, supply intervals, and aggregated candles, with sparkline series for chart rendering. Trading platforms, portfolio dashboards, and data analysts use it as a price feed and historical reference for crypto assets. ## For AI agents Pull cryptocurrency prices, volumes, market caps, and OHLCV candle data across thousands of coins and exchanges from Nomics on behalf of trading and analytics tools. ## Scope Does not handle order placement, custody, or wallet operations - use for cryptocurrency market data, prices, and historical aggregates only. ## Capabilities - Pull current ticker data for any supported cryptocurrency including price, volume, and market cap - Retrieve historical exchange rates and exchange-rate history between currencies - Read aggregated OHLCV candles at configurable intervals for charting and backtesting - List exchanges and pull per-exchange ticker and volume history - Fetch global market metrics: total volume history and total market cap history - Get markets traded on a specific exchange with their base and quote currencies - Pull currency supply data over an interval to track circulating supply changes ## Use cases ### Crypto portfolio valuation Portfolio dashboards displaying live crypto holdings need current prices for each held asset, denominated in the user's fiat currency. The Nomics `/currencies/ticker` endpoint returns price, 1h, 1d, 7d, and 30d change for a list of currency IDs in a single call, and /exchange-rates converts between fiats. An agent can refresh a portfolio's USD value with two requests rather than per-coin lookups. Example prompt: Call `/currencies/ticker` with ids=BTC,ETH,SOL,LINK and convert=USD, then sum holdings * price for the user's portfolio ### Backtesting trading strategies Quants backtesting strategies need clean OHLCV candles at a specific interval over a long history. Nomics /candles returns aggregated candles synthesised across exchanges, removing the need to merge per-exchange data manually. An agent can pull years of 1h or 1d candles for any supported pair and feed them straight into a backtest. Example prompt: Call /candles with currency=BTC, interval=1d, and start of 2024-01-01 to retrieve daily candles for backtest input ### Market sentiment dashboard Analyst dashboards combining global market metrics with per-exchange flows can pull `/market-cap/history` and `/volume/history` for the macro view, then drill into `/exchanges/volume/history` for individual venues. This produces the 'where is the volume going' view that crypto reporters and fund managers use to spot rotations between exchanges. Example prompt: Pull `/market-cap/history` and `/volume/history` for the past 90 days and chart total market cap against total volume ### AI agent for crypto price queries An AI assistant answering 'what's the price of ETH right now' can use Jentic to find the matching Nomics operation, call `/currencies/ticker` for ETH, and return the current price plus 24h change. Through Jentic the agent never holds the API key and the operation is discoverable by intent rather than by reading Nomics documentation. Example prompt: Through Jentic, search 'get current cryptocurrency price', load `/currencies/ticker`, and execute with ids=ETH and convert=USD ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/currencies/ticker` | Current ticker data for one or more currencies | | GET | `/currencies/sparkline` | Sparkline price series for charting | | GET | `/exchange-rates` | Current exchange rates between currencies | | GET | `/exchange-rates/history` | Historical exchange rates | | GET | `/candles` | Aggregated OHLCV candles at a chosen interval | | GET | `/exchanges/ticker` | Per-exchange ticker data | | GET | `/markets` | Trading pairs across exchanges | | GET | `/market-cap/history` | Global market cap history | ## Key resources - **Currencies** — Ticker, sparkline, and metadata for individual cryptocurrencies - **Exchange Rates** — Current and historical rates between currencies and fiats - **Exchanges** — Per-exchange ticker, metadata, and volume history - **Markets** — Listing of trading pairs across exchanges - **Candles** — Aggregated OHLCV candles at configurable intervals - **Market Cap and Volume** — Global market cap and volume history series - **Supply** — Circulating supply over time intervals ## Why Jentic - **Setup:** Wiring Nomics by hand means appending your API key to the 'key' query parameter on every request to api.nomics.com/v1 and managing that yourself across ticker, candle, and exchange-rate calls. Through Jentic you install once, import the Nomics Cryptocurrency API from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** Nomics is read-only market data with parameters in the query string rather than a resource id in the URL path, so scope the agent to the operations it needs, such as reading a currency ticker or fetching candles. You choose that set, so an operation like the market-cap history read is not included unless you add it. - **Credential handling:** Your Nomics API key is stored once, encrypted, by your own Jentic One instance and injected at execution time as the query key. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'get the current crypto price' or 'fetch daily candles', and Jentic returns the matching Nomics operation with its input schema so the agent calls `/currencies/ticker` without browsing the reference docs. ## Related APIs - **CoinGecko API** — CoinGecko offers a free tier with broader coverage and community metrics. - **CoinMarketCap API** — CoinMarketCap is the most widely-cited crypto price source with strong brand recognition. - **Kraken API** — Use Kraken's exchange API to actually trade based on Nomics market data. - **Binance API** — Binance provides live trading and a broader set of altcoin pairs. ## FAQ ### Why is there no official OpenAPI spec for Nomics Cryptocurrency API? Nomics does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Nomics Cryptocurrency API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer. ### What authentication does the Nomics API use? Nomics uses an API key passed as the 'key' query parameter on every request. Through Jentic, the key is stored in the encrypted vault and appended to the request URL by the runtime - agents never see the raw key in their context. ### Can I get OHLCV candles for any cryptocurrency from Nomics? Yes. /candles returns aggregated OHLCV bars for a given currency and interval. Supported intervals are typically 1d and longer; for sub-daily data, check the parameter documentation on the spec since not all coins have full history. ### What are the rate limits for the Nomics API? Nomics rate limits depend on your subscription tier and are not encoded in the OpenAPI spec. Free keys typically allow about 1 request per second; paid plans raise that ceiling. Cache ticker data for 30-60 seconds and historical /candles results indefinitely to stay well under the limit. ### How do I get the current Bitcoin price through Jentic? Install with pip install jentic, then search 'get current cryptocurrency price', load `/currencies/ticker`, and execute with ids=BTC and convert=USD. The response includes current price, percent changes over standard windows, and 24h volume. ### Does the Nomics API support trading or order placement? No. Nomics is a market data provider only - it does not place trades, hold balances, or execute orders. Pair it with an exchange API such as Kraken or Binance when you need to act on the data. ### Can I limit what my agent is allowed to do with the Nomics API? Yes. Because you run Jentic One yourself, you decide which Nomics operations your agent can call, so you can allow only what a task needs, such as reading a currency ticker from `/currencies/ticker` or fetching /candles, while leaving operations like the global `/market-cap/history` read out of scope. The Nomics API is read-only market data with all parameters passed in the query string rather than a resource id in the path, so your rules govern which reads the agent may perform. Your stored API key is injected at execution time and never enters the agent's context.