CoinAPI Market Data REST API

Name: CoinAPI Market Data REST API
Brand: CoinAPI Market Data REST API
Availability: InStock

✓ Official Vendor SpecFinanceBankingapiKey50 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.

CoinAPI publishes an OpenAPI specification for its Market Data REST API from its own production host, and the specification behind this page derives from that vendor document. 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.

Jentic One on Github

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.

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%2Fcoinapi.io%2Fcoinapi" | sh

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%2Fcoinapi.io%2Fcoinapi" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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

GET STARTED

Start building with CoinAPI Market Data REST API

Explore with Jentic One

View OpenAPI Document

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 — coinapi publishes an openapi specification for its market data rest api from its own production host, and the specification behind this page derives from that vendor document.

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?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring CoinAPI by hand means managing its X-CoinAPI-Key header auth against the rest.coinapi.io host and handling rate limits and pagination across fifty market-data endpoints yourself. Through Jentic you install once, import CoinAPI from the API Directory, store the key once, and your agent calls it.

Permission scoping

CoinAPI market data is read-only, so you scope by choosing the operations the agent may call: limit it to what it needs, such as fetching an exchange rate or listing assets, and heavier calls like full history pulls are not included unless you add them.

Credential isolation

Your CoinAPI key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'get the current BTC to USD rate' or 'list supported exchanges', and Jentic returns the matching CoinAPI operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using CoinAPI Market Data REST API through Jentic.

Where does the OpenAPI specification for CoinAPI Market Data REST API come from?

CoinAPI publishes it. The vendor serves an OpenAPI document for this API from its own production host at `https://rest.coinapi.io/swagger/v1/swagger.json`, and the specification behind this page derives from that vendor document rather than from schemas written by Jentic: the same 50 read-only GET endpoints against `https://rest.coinapi.io`, and the same API key and JWT security schemes declared at the document root. Get started with Jentic One, the self-hosted execution layer.

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 your encrypted Jentic One instance 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.

Can I limit what my agent is allowed to do with the CoinAPI Market Data REST API?

Yes. Because you run Jentic One yourself, your own rules decide which CoinAPI operations and credentials the agent may use. Since CoinAPI market data is read-only, you scope by choosing the specific calls the agent can make, such as fetching an exchange rate through GET /v1/exchangerate/{asset_id_base}/{asset_id_quote} or listing assets and exchanges, while leaving heavier operations like full OHLCV history pulls out unless you deliberately add them. Your API key stays in your Jentic One instance and is injected only for the operations you permit.