How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Coin Metrics Reference Data API

Metadata information of entities supported by Coin Metrics.

Coin Metrics Reference Data API is one of 19 APIs that Coin Metrics publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reference Data. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 13 operations across 13 paths, and defines 104 schemas. It is described by OpenAPI 3.2.0, at version 4.0.0.

Requests are made against 3 base URLs: https://api.coinmetrics.io/v4, wss://api.coinmetrics.io/v4, https://community-api.coinmetrics.io/v4.

13 operations 13 paths 104 schemas 13 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
4.0.0
Base URL
https://api.coinmetrics.io/v4
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Coin Metrics Reference Data API declares 1 security scheme for authenticating requests. An API key is passed in the query as api_key (api_key).

  • api_key — Coin Metrics API key can be specified as ?apikey= query parameter.

Paths & Operations 13

Across 13 paths, the API surfaces 13 operations — 13 GET. Each is listed below with its method, path, parameters, and response codes.

Reference Data 13

Metadata information of entities supported by Coin Metrics.

GET
/reference-data/assets
Assets
getReferenceDataAssets 7 params → 200400401414
GET
/reference-data/exchanges
Exchanges
getReferenceDataExchanges 7 params → 200400401414
GET
/reference-data/markets
Markets
getReferenceDataMarkets 18 params → 200400401414
GET
/reference-data/indexes
Indexes
getReferenceDataIndexes 6 params → 200400401414
GET
/reference-data/protocols
Protocols
getReferenceDataProtocols 8 params → 200400401414
GET
/reference-data/pairs
Pairs
getReferenceDataPairs 6 params → 200400401414
GET
/reference-data/asset-metrics
Asset metrics
getReferenceDataAssetMetrics 7 params → 200400401414
GET
/reference-data/exchange-metrics
Exchange metrics
getReferenceDataExchangeMetrics 6 params → 200400401414
GET
/reference-data/exchange-asset-metrics
Exchange asset metrics
getReferenceDataExchangeAssetMetrics 6 params → 200400401414
GET
/reference-data/exchange-pair-metrics
Exchange pair metrics
getReferenceDataExchangePairMetrics 6 params → 200400401414
GET
/reference-data/pair-metrics
Pair metrics
getReferenceDataPairMetrics 6 params → 200400401414
GET
/reference-data/institution-metrics
Institution metrics
getReferenceDataInstitutionMetrics 6 params → 200400401414
GET
/reference-data/market-metrics
Market metrics
getReferenceDataMarketMetrics 6 params → 200400401414

Schemas 104

The contract defines 104 schemas that model the data the API accepts and returns. The most detailed are ReferenceDataMarketInfo (53 properties), TalosMarketMetadata (28 properties), ProtocolChain (20 properties), ReferenceDataMetricInfo (15 properties). Each schema is shown below with its type and property counts.

DefiFee
string
DeFi fee (in percents).
AssetIdBase
string
Unique name of the base asset.
ReferenceDataExchangeAssetMetricsResponse
object
3 properties 1 required
ReferenceDataProtocol
object
Protocol reference data response.
5 properties 5 required
TalosAssetMetadata
object
Provider metadata. Contains cmextasset (Coin Metrics symbol using provider namespace, e.g. "talos:BTC") and cmextassetbyid (Coin Metrics ID using provider name…
7 properties
ReferenceDataExchangesResponse
object
3 properties 1 required
DisplayName
string
More detailed and human friendly name of a metric.
DerivativeContractListing
string
Derivative contract listing date.
OrderSizeMin
string
Minimum order size, where order size is amount price.
ReferenceDataPairMetricsResponse
object
3 properties 1 required
MaturityDate
string
Maturity date of the security.
MarketType
string
Type of the market (spot, future).
Reviewable
boolean
Reviewable by human flag.
OrderAmountMin
string
Minimum amount size.
FutureTickSize
string
Futures tick size.
MarketId
string
Unique name of the market.
DerivativeContractSizeAsset
string
Name of the derivative contract size asset.
ReferenceDataAssetsResponse
object
3 properties 1 required
Asset
string
Name of the asset.
FutureMultiplierSize
string
Futures multiplier size.
IssueDate
string
Issue date of the security.
ReferenceDataProtocolsResponse
object
Blockchain protocol reference data response.
4 properties 1 required
ProtocolAddress
string
Address of the protocol contract.
ReferenceDataMarketMetricsResponse
object
3 properties 1 required
OptionStrike
string
Strike price for option trade.
DefiBaseAddress
string
DeFi base address.
ReferenceDataProtocols
array
AssetIdQuoteNative
string
Exchange name of the quote asset.
DerivativeContractMarginAsset
string
Name of the derivative margin asset.
ExperimentalMarket
boolean
If set to true, indicates that market collection is under active development - there is a chance of temporary discrepancies in the served dataset.
Product
string
Associated Product of the metric.
ConstituentSnapshotsUrl
string
The endpoint URL of the constituent snapshots.
CouponRate
string
Coupon rate of the security.
Pair
string
Pair string representation as - .
SourceType
string
Source type of the exchange.
Index
string
Name of the index.
Category
string
Category of the metric.
PricePer100
string
Price per $100 face value.
Exchange
string
Name of the exchange.
ReferenceDataExchangeMetricsResponse
object
3 properties 1 required
DefiContractAddress
string
DeFi contract address.
OrderAmountMax
string
Maximum amount size.
ReferenceDataMarketsResponse
object
List of markets.
3 properties 1 required
SecurityDescription
string
Description of the security (e.g., "30-Year Treasury Bond").
ProtocolAsset
string
Protocol asset symbol.
ProtocolChain
object
Protocol chain.
20 properties 1 required
ReferenceDataPairInfo
object
Pair metadata.
2 properties 2 required
TalosMarketMetadata
object
Provider metadata for markets. Contains cmextmarket (Coin Metrics symbol using provider namespace, e.g. "talos:kucoin:BTC-USDT") and cmextmarketbyid (Coin Metr…
28 properties
ReferenceDataIndexesResponse
object
3 properties 1 required
MarketSymbol
string
Unique name of the derivative market symbol.
NextPageToken
string
Token of the next page results for a given request.
AssetIdBaseNative
string
Exchange name of the base asset.
IndexType
string
Type of the index.
OrderPriceIncrement
string
Price precision.
OrderAmountIncrement
string
Volume precision.
AssetClass
string
Asset class of the market.
ReferenceDataExchangePairMetricsResponse
object
3 properties 1 required
NextPageUrl
string
URL of the next page results for a given request.
DefiPoolConfigId
string
DeFi pooling config ID.
ReferenceDataInstitutionMetricsResponse
object
3 properties 1 required
AssetIdQuote
string
Unique name of the quote asset.
ReferenceDataPairsResponse
object
3 properties 1 required
IsEuropean
boolean
shows if the options contract is european or not.
Cusip
string
CUSIP identifier for the security.
WarningObject
object
2 properties 2 required
ConstituentTimeframesUrl
string
The endpoint URL of the constituent timeframes.
MetricId
string
Name of the metric.
Description
string
Human-friendly description.
MetricType
string
Type of the metric.
ExperimentalMetric
boolean
If set to true, indicates that metrics collection is under active development - there is a chance of temporary discrepancies in the served dataset.
ReferenceDataExchangeInfo
object
Exchange metadata.
3 properties 2 required
MarketContractSize
string
Market contract size.
SecurityType
string
Type of the security (e.g., Treasury Bill, Treasury Note, Common Stock).
OrderPriceMax
string
Maximum price.
DefiQuoteAddress
string
DeFi quote address.
MetricDataType
string
Data Type of the metric. Can be bigint or decimal. "bigint" means that you should expect an integer number in a range from -9223372036854775808 to 922337203685…
FullName
string
Human-friendly name.
ErrorObject
object
2 properties 2 required
ReferenceDataAssetMetricsResponse
object
3 properties 1 required
MarginTradingEnabled
boolean
Publisher
string
Publisher of the market data.
Unit
string
Unit of the metric.
OrderMakerFee
string
ReferenceDataMarketInfo
object
Information about a market.
53 properties 3 required
Isin
string
ISIN identifier for the security.
Figi
string
FIGI identifier for the security.
ReferenceDataAssetInfo
object
Asset metadata.
3 properties 2 required
OrderTakerFee
string
TalosExchangeMetadata
object
Provider metadata for exchanges. Contains cmextexchange (Coin Metrics symbol using provider namespace, e.g. "talos:binance") and cmextexchangebyid (Coin Metric…
12 properties
DocsUrl
string
The documentation URL.
Subcategory
string
Subcategory of the metric.
SettlementPrice
string
Price of underlying asset at contract expiration.
Status
string
Market status (online/offline).
ErrorResponse
object
1 property 1 required
DefiVariableFee
boolean
Whether the market has a variable (true) or fixed (false) fee structure.
DefiPriceIncludesFee
boolean
Whether the reported price for a trade is inclusive (true) or exclusive (false) of fee.
OrderPriceMin
string
Minimum price.
ProtocolAddressName
string
Name associated with the address.
OptionContractType
string
'call or 'put' option contract type.
ReferenceDataIndexInfo
object
Index metadata.
4 properties 2 required
DerivativeContractExpiration
string
Derivative contract expiration date.
ReferenceDataMetricInfo
object
Metric metadata.
15 properties 9 required
TalosMarketSizeBucket
object
A size bucket for order sizing.
1 property
SecurityTerm
string
Original term of the security (e.g., "4-Week", "10-Year").

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

coin-metrics-reference-data-api-openapi.yml Raw ↑

Other APIs Coin Metrics publishes across the network.

Coin Metrics Blockchain Explorer Job API
Coin Metrics Blockchain Metadata API
Coin Metrics Catalog API
Coin Metrics Catalog v2 API
Coin Metrics Chain Monitor tools API
Coin Metrics Constituent Snapshots API
Coin Metrics Constituent Timeframes API
Coin Metrics Full blockchain entities v2 API
Coin Metrics Full catalog API
Coin Metrics Full catalog v2 API
Coin Metrics Jobs API
Coin Metrics List of blockchain entities v2 API
Where this information came from

This is an independent, third-party profile of Coin Metrics Reference Data API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.