NewConnect Claude, Gemini, ChatGPT, and other AI agents to API Ninjas via our MCP server →

Crypto Price API

The Crypto Price API provides access to live market prices for several hundred different cryptocurrencies, quoted in either another cryptocurrency or in a fiat currency (e.g. BTCEUR, ETHJPY).

Available endpoints:

  • /v1/cryptoprice - Get the current price for any cryptocurrency symbol, quoted in another cryptocurrency or in a fiat currency (premium only for fiat quotes)
  • /v1/cryptopricehistorical - Get historical price data for any cryptocurrency symbol
  • /v1/cryptosymbols - Get a list of all available cryptocurrency ticker symbols

Premium members have access to live prices. Free users receive the price as of the top of the current hour, updated once per hour.

(4.1)

From 2,495 users

900+

Applications using this API

API Status

Online - All Systems Operational

API Response Times

Average
P50
P75
P90
P95
349ms379ms422ms663ms1175ms

Didn't find what you were looking for? Suggest an improvement

3 endpoints

https://api.api-ninjas.com/v1/cryptoprice

Returns the current price and current time (in UNIX timestamp in seconds) for any cryptocurrency symbol. Premium members have access to live prices. Free users receive the price as of the top of the current hour, updated once per hour. For historical price data, see /v1/cryptopricehistorical.

Fiat quotes: Premium subscribers can quote any cryptocurrency in a supported fiat currency by appending the three-letter fiat code to the crypto symbol (e.g. BTCEUR, ETHJPY, TRXGBP).

Parameters

  • symbol  required

    Cryptocurrency symbol (e.g. ETHUSDT). To get the full list of available crypto-quoted symbols, use the Crypto Symbols API. Premium subscribers can also quote any cryptocurrency in a supported fiat currency (e.g. BTCEUR, ETHJPY).

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • symbol

    The cryptocurrency trading pair symbol (e.g. ETHUSDT).

  • price

    The current price of the cryptocurrency pair.

  • timestamp

    The timestamp of the price in Unix format (in seconds). On paid plans this is the moment the price was read. On the free plan it is the top of the current hour — the price is the close of the last completed hour, so every request within the same hour returns the same price and the same timestamp.

Sample Request Live Demo!

symbol

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/cryptoprice?symbol=ETHUSDT

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
{
    symbol:"ETHUSDT",
    price:"0.00381400",
    timestamp:1637809196
}

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/cryptoprice?symbol=BTCUSD" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

Premium only

https://api.api-ninjas.com/v1/cryptopricehistorical

Returns historical price data for any cryptocurrency pair in OHLCV (Open, High, Low, Close, Volume) format. The data is returned in ascending order (oldest first).

Parameters

  • symbol  required

    Cryptocurrency symbol (e.g. ETHUSDT). Use the same values as the symbol parameter in /v1/cryptoprice.

  • interval  optional

    Time interval between data points. Valid values are: 1m, 5m, 15m, 30m, 1h, 4h, 1d. Default is 1h.

  • start  optional

    Start timestamp in Unix format (in seconds). If not provided, defaults to 24 hours ago.

  • end  optional

    End timestamp in Unix format (in seconds). If not provided, defaults to current time.

  • limit  optional

    Maximum number of data points to return. Default is 100, maximum is 1000.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • open

    The opening price of the cryptocurrency.

  • high

    The highest price of the cryptocurrency.

  • low

    The lowest price of the cryptocurrency.

  • close

    The closing price of the cryptocurrency.

  • volume

    The volume of the cryptocurrency traded in the time period.

  • close_time

    The timestamp of the closing price in Unix format (in milliseconds).

  • timestamp

    The timestamp of the price in Unix format (in seconds).

  • price

    The current price of the cryptocurrency pair. This is the same value as the close field.

Sample Request Live Demo!

symbol
interval
start
end
limit

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/cryptopricehistorical?symbol=ETHUSDT&interval=1h&limit=10

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
[
    {
      open:"0.00381100",
      high:"0.00381100",
      low:"0.00380100",
      close:"0.00380900",
      volume:"6.41000000",
      close_time:1637812799999,
      timestamp:1637812799,
      price:"0.00380900"
    }
]

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/cryptopricehistorical?symbol=ETHUSDT&interval=1h&limit=10" \ -H "X-Api-Key: YOUR_API_KEY"

Premium only

https://api.api-ninjas.com/v1/cryptosymbols

The Crypto Symbols API provides a list of all available cryptocurrency ticker symbols. It can be used in conjunction with the Crypto Price API to retrieve price data.

Returns a list of available cryptocurrency symbols that have pricing information.

Parameters

None

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • symbols  array

    An array of cryptocurrency symbol pairs.

Sample Request Live Demo!

Try our APIs in the API playground

Sign up for a free API key to get started — no credit card required.

https://api.api-ninjas.com/v1/cryptosymbols

Headers

X-Api-KeyLog in or sign up to get your API Key

Sample Response

JSON
{
    symbols:[
      "ETHBTC",
      "ETHUSDT",
      "..."
    ]
}

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/cryptosymbols" \ -H "X-Api-Key: YOUR_API_KEY"

If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.

New

https://api.api-ninjas.com/v1/cryptotreasury

Returns crypto holdings that companies, funds and private filers disclose to the SEC. Covers bitcoin, ethereum, solana, XRP and others; filter with asset. Results are ranked by dollar value, because unit counts are only comparable within a single asset. For bitcoin only, including the spot bitcoin ETFs, see /v1/bitcointreasury.

Positions come from SEC XBRL crypto-asset disclosures filed under ASU 2023-08. These are quarterly balance-sheet figures, not a live feed: each result carries a period_end and can be several months old. SEC filings are public domain, so you may store, redistribute and display these results commercially.

Parameters

  • ticker  optional

    Stock ticker of the filer (e.g. MSTR). Private filers have no ticker — use cik.

  • cik  optional

    SEC Central Index Key of the filer, with or without leading zeros.

  • name  optional

    Case-insensitive substring match on the filer name. Requires a Business or Professional subscription.

  • asset  optional

    Restrict to one asset: BITCOIN, ETHEREUM, SOLANA, XRP, LITECOIN, DOGECOIN, CARDANO, INJECTIVE, CANTON, STABLECOIN or UNKNOWN.

  • entity_type  optional

    OPERATING for a company holding crypto on its balance sheet, ETP for an exchange-traded product whose holdings are the fund itself, or PRIVATE for a filer with no listed ticker.

  • period  optional

    Reporting period end as YYYY-MM-DD, or latest. Defaults to the most recent period. How far back you may query depends on your subscription tier.

  • include_unverified  optional

    Include filings whose unit count does not reconcile with their own reported fair value. Excluded by default; when included they are reproduced exactly as filed and carry a warning.

  • limit  optional

    Maximum results to return. Capped at 5 on Free, 50 on Developer, and 250 on Business and Professional.

  • offset  optional

    Number of results to skip, for pagination. Default is 0, maximum is 10000.

Headers

  • X-Api-Key  required

    API Key associated with your account.

Response

A JSON object with the following fields or an error if the request is unsuccessful.

  • results  array

    Matching treasury positions.

  • entity_name  string

    Filer name as it appears in EDGAR.

  • ticker  string

    Stock ticker, or null for private filers.

  • cik  string

    SEC Central Index Key, zero-padded to 10 digits.

  • entity_type  string

    OPERATING, ETP or PRIVATE.

  • asset  string

    Canonical asset name, for example BITCOIN.

  • units  number

    Coins held at the period end. Fractional holdings are returned as filed.

  • fair_value_usd  number

    Value of this asset position. null when the filer holds several assets and did not break the value out per asset — use entity_total_crypto_fair_value_usd instead.

  • cost_usd  number

    Cost basis as reported, or null where the filer did not disclose it.

  • entity_total_crypto_fair_value_usd  number

    The filer's total crypto fair value across all assets.

  • entity_holds_multiple_assets  boolean

    True when the filer reported more than one crypto asset for this period.

  • period_end  string

    Reporting period end as YYYY-MM-DD.

  • calendar_year  integer

    Calendar year of the reporting period. Not the filer's fiscal year.

  • calendar_quarter  string

    Calendar quarter, Q1 to Q4. Not the filer's fiscal quarter.

  • accession  string

    SEC accession number of the source filing.

  • sec_filing_url  string

    Link to the source filing on EDGAR.

  • attribution  object

    How the figure was derived, so you can audit it. Contains asset_source, units_basis, units_facts_reconciled, recovered_from_instance_document, quality, implied_unit_price_usd and market_price_at_period_end_usd.

  • disclosure  object

    Data source, your redistribution rights, and a not-investment-advice notice.

Code Examples

1 2 curl -X GET "https://api.api-ninjas.com/v1/cryptotreasury?asset=BITCOIN&limit=5" \ -H "X-Api-Key: YOUR_API_KEY"

Frequently Asked Questions

  • Yes, but you must have a premium subscription. Commercial use of the Crypto Price API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.
  • Sign up for a free account to instantly get your API key, then pass it in the X-Api-Key header on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.
  • Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.
  • The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.
  • Yes — /v1/cryptotreasury returns crypto holdings that companies, funds and private filers disclose to the SEC: units held, cost basis where reported, and a link to the source filing. Filter with asset for BITCOIN, ETHEREUM, SOLANA, XRP and others, or with entity_type to separate operating companies from exchange-traded products. Results are ranked by dollar value, since unit counts are only comparable within a single asset.
  • The SEC tag CryptoAssetFairValue is an entity-level total across all crypto a filer holds, not a per-asset figure. When a filer holds several assets and did not break the value out per asset, we return fair_value_usd as null and set entity_holds_multiple_assets to true, with the company-wide figure in entity_total_crypto_fair_value_usd. Repeating the entity total on each asset row would multiply the same money several times over.
  • It shows how each number was derived so you can audit it. asset_source says whether the filing named the coin or it was identified by matching the implied unit price to the period-end market close. units_basis says how overlapping unit facts were collapsed — some filers report a total alongside its components, and summing them would double-count. quality says whether the unit count reconciles with the filer's own reported fair value; filings that fail are excluded unless you pass include_unverified=true.
  • Premium subscribers can quote any cryptocurrency in a supported fiat currency by appending the three-letter fiat code to the crypto symbol in the symbol parameter (e.g. BTCEUR, ETHJPY, TRXGBP); free users are limited to crypto-quoted pairs such as ETHBTC. See pricing for fiat-quote access.
  • The current-price endpoint returns the price along with a timestamp in Unix seconds. Premium members receive live prices; free users receive the price as of the top of the current hour, which updates once per hour, so every request within the same hour returns the same price and the same timestamp. Compare plan-level data access on the pricing page.
  • The premium-only /v1/cryptopricehistorical endpoint returns historical candles in OHLCV format with open, high, low, close, and volume fields; you can control granularity with the interval parameter (1m through 1d) and return up to 1000 points via limit. Historical data access requires a premium plan.
  • Use the premium-only /v1/cryptosymbols endpoint, which returns a symbols array of every available trading pair that you can then pass to the symbol parameter. For single-coin data you can also try the dedicated Bitcoin API.