CoinAPI Market Data REST API
★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey50 EndpointsREST
For Agents
Query unified cryptocurrency market data — assets, exchanges, OHLCV, trades, quotes, and conversion rates — across hundreds of crypto venues from a single API.
Use for: Get the current exchange rate from BTC to USD, Retrieve historical OHLCV candles for ETH-USD on Coinbase, List all supported cryptocurrency exchanges and their trading symbols, Find all assets traded on a given exchange
Not supported: Does not handle order placement, wallet management, or on-chain transactions — use for cryptocurrency market data retrieval only.
Jentic publishes the only available OpenAPI specification for CoinAPI Market Data REST API, keeping it validated and agent-ready. CoinAPI aggregates real-time and historical cryptocurrency market data from hundreds of exchanges into a single normalized REST interface. It exposes assets, exchanges, symbols, OHLCV candles, trades, quotes, order books, and exchange-rate conversions across spot and derivative markets. Quants, trading bots, and analytics platforms use it to access uniform market data without integrating each exchange separately.
Install Jentic One Beta
Connect the CoinAPI Market Data REST API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CoinAPI Market Data REST 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://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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 CoinAPI Market Data REST API.
Convert any base asset to any quote asset using current or historical exchange rates
Retrieve OHLCV candles for crypto pairs across multiple time periods and date ranges
List supported exchanges and inspect trading symbols across spot and derivative markets
Pull recent trades and order book snapshots for a chosen symbol on a specific exchange
Browse aggregated metrics across assets, exchanges, and symbols
Look up asset metadata and icons for cryptocurrencies and fiat currencies
Use Cases
Patterns agents use CoinAPI Market Data REST API for, with concrete tasks.
★ Unified Crypto Market Data Feed
Pull normalized real-time and historical data from hundreds of cryptocurrency exchanges through a single REST interface. CoinAPI standardizes asset identifiers, exchange ids, and symbol formats so trading systems and analytics dashboards do not need per-exchange adapters. Integration takes a few hours instead of weeks of per-exchange work.
Call GET /v1/exchangerate/BTC/USD and return the current rate, timestamp, and source
Backtesting Crypto Trading Strategies
Retrieve historical OHLCV candles and exchange-rate history to backtest algorithmic trading strategies. The history endpoints support multiple time periods and date ranges, returning consistently formatted data across exchanges. Useful for quant researchers and trading firms validating models before deploying capital.
Fetch hourly OHLCV history for ETH-USD between two given timestamps via GET /v1/exchangerate/ETH/USD/history and return the candle series
Portfolio Valuation in Fiat
Convert holdings of arbitrary crypto assets into a chosen fiat currency using current exchange rates. The exchangerate endpoints accept any base and quote pair and return a normalized rate sourced from aggregated venues. Suitable for portfolio trackers, accounting systems, and tax reporting tools.
For each holding in a portfolio, call GET /v1/exchangerate/{asset_id_base}/USD and sum the converted values to compute total portfolio value in USD
AI Trading Agent via Jentic
Build an AI trading agent that retrieves live crypto prices, historical context, and order book depth through Jentic. The agent expresses intents in natural language; Jentic resolves the right CoinAPI endpoint and executes the call with stored credentials. Decisions and analysis stay in the agent layer; data retrieval is one hop.
Through Jentic, fetch the latest BTC-USD rate and the last 24 hourly candles, then summarise the short-term trend
Key Endpoints
50 endpoints — jentic publishes the only available openapi specification for coinapi market data rest api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/v1/assets
List all supported assets
GET
/v1/exchanges
List supported cryptocurrency exchanges
GET
/v1/exchangerate/{asset_id_base}/{asset_id_quote}
Get current exchange rate between two assets
GET
/v1/exchangerate/{asset_id_base}/{asset_id_quote}/history
Retrieve historical exchange rates between two assets
GET
/v1/metrics/asset/listing
List metrics available for assets
GET
/v1/assets
List all supported assets
GET
/v1/exchanges
List supported cryptocurrency exchanges
GET
/v1/exchangerate/{asset_id_base}/{asset_id_quote}
Get current exchange rate between two assets
GET
/v1/exchangerate/{asset_id_base}/{asset_id_quote}/history
Retrieve historical exchange rates between two assets
GET
/v1/metrics/asset/listing
List metrics available for assets
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
CoinAPI keys are stored encrypted in the Jentic vault. Agents receive scoped execution tokens; the X-CoinAPI-Key value never enters the agent's prompt or logs.
Intent-based discovery
Agents search Jentic by intent (e.g. get the current BTC to USD rate) and Jentic returns the matching CoinAPI operation with its parameter schema, so the agent calls the correct endpoint without browsing docs.
Time to first call
Direct integration: 1-2 days for auth, pagination, and per-tier rate limit handling. Through Jentic: under 1 hour — search, load schema, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using CoinAPI Market Data REST API through Jentic.
Why is there no official OpenAPI spec for CoinAPI Market Data REST API?
CoinAPI does not publish an OpenAPI specification on its own developer portal. Jentic generates and maintains this spec so that AI agents and developers can call CoinAPI Market Data REST API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the CoinAPI Market Data REST API use?
CoinAPI uses an API key sent in the X-CoinAPI-Key header (a JWT alternative is also supported). When called through Jentic, the key is stored in the encrypted Jentic vault and the agent receives a scoped execution token rather than the raw secret.
Can I retrieve historical OHLCV candles with this API?
Yes. Use GET /v1/exchangerate/{asset_id_base}/{asset_id_quote}/history with period_id and time_start/time_end parameters to retrieve historical candles for any supported pair. Period definitions are listed at GET /v1/exchangerate/history/periods.
What are the rate limits for the CoinAPI Market Data REST API?
CoinAPI enforces request and credit limits per subscription tier — free, startup, streamer, and enterprise. Limits are headers-driven (x-ratelimit-remaining and x-ratelimit-reset) and the OpenAPI spec does not declare them; check the tier attached to your API key for exact thresholds.
How do I get a current crypto exchange rate through Jentic?
Install the SDK with pip install jentic, then search Jentic for get current crypto exchange rate, load the schema for GET /v1/exchangerate/{asset_id_base}/{asset_id_quote}, and execute the call with your asset pair (for example BTC and USD).
Does CoinAPI support derivative and spot markets in the same endpoint set?
Yes. Symbols, trades, quotes, and OHLCV endpoints all expose spot and derivative instruments — symbol metadata indicates the type. Filter by symbol_id_filter or exchange_id to scope queries to the markets you care about.
GET STARTED