Nomics Cryptocurrency API
Agent-ready OpenAPI document · curated by JenticFinanceBankingapiKey13 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For 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.
Use for: Get the current price of Bitcoin in USD from Nomics, Retrieve daily OHLCV candles for ETH over the last 30 days, List all exchanges that trade SOL/USD, I need to pull global crypto market cap history for the past year
Not supported: Does not handle order placement, custody, or wallet operations - use for cryptocurrency market data, prices, and historical aggregates only.
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.
Install Jentic One Beta
Connect the Nomics Cryptocurrency API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nomics Cryptocurrency API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnomics.com%2Fnomics" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fnomics.com%2Fnomics" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Nomics Cryptocurrency API.
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
Patterns agents use Nomics Cryptocurrency API for, with concrete tasks.
★ 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.
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.
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.
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.
Through Jentic, search 'get current cryptocurrency price', load /currencies/ticker, and execute with ids=ETH and convert=USD
Key Endpoints
13 endpoints — jentic publishes the only available openapi specification for nomics cryptocurrency api, keeping it validated and agent-ready.
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
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
Why Jentic?
What agents get from Jentic-routed access to this vendor.
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 isolation
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.
Intent-based discovery
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
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Nomics Cryptocurrency API through Jentic.
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.
GET STARTED