api.coinpaprika.com
Open in
urlscan Pro
2606:4700:10::ac43:172c
Public Scan
Submitted URL: http://api.coinpaprika.com/
Effective URL: https://api.coinpaprika.com/
Submission: On May 13 via manual from TH — Scanned from DE
Effective URL: https://api.coinpaprika.com/
Submission: On May 13 via manual from TH — Scanned from DE
Form analysis 0 forms found in the DOM
Text Content
* Introduction
* Authentication
* Standards and conventions
* General
* Errors
* Rate limit
* API Clients
* Terms of use
* Archival documentations
* Version history
* v1.7.0 - 2022.05.06
* v1.6.1 - 2020.12.09
* v1.6.0 - 2020.10.27
* Global
* getGet market overview data
* Coins
* getList coins
* getGet coin by ID
* getGet Twitter timeline tweets for a coin
* getGet coin events by coin ID
* getGet exchanges by coin ID
* getGet markets by coin ID
* getGet OHLC for the last full day
* getGet historical OHLC
* getGet today OHLC
* People
* getGet person by ID
* Tags
* getList tags
* getGet tag by ID
* Tickers
* getGet tickers for all active coins
* getGet ticker for a specific coin
* getGet historical ticks for a specific coin
* Exchanges
* getList exchanges
* getGet exchange by ID
* getList an exchange markets
* Tools
* getSearch
* getPrice converter
* Contracts
* getList contracts platforms
* getGet all contract addressess for a given platform
* getRedirect to Ticker by contract address
* getRedirect to historical ticks by contract address
* Deprecated
* getGet ticker information for all coins [DEPRECATED]
* getGet ticker by ID [DEPRECATED]
Documentation Powered by ReDoc
COINPAPRIKA API (1.7.0)
Download OpenAPI specification:Download
Coinpaprika API delivers precise & frequently updated market data from the world
of crypto: coin prices, volumes, market caps, ATHs, return rates and more.
INTRODUCTION
If you want to use the Coinpaprika API, you have two main options: you can
choose the API Free plan, which has sufficient limits for hobby and
non-commercial use, or get one of the paid plans, ideal for commercial or
professional use. To decide which plan is the best for you, check the Plans and
Pricing comparison.
Depending on the selected plan, you should send requests to the appropriate base
URL:
Plan Base URL Free https://api.coinpaprika.com/v1/ Pro
https://api-pro.coinpaprika.com/v1/ Business https://api-pro.coinpaprika.com/v1/
Enterprise https://api-pro.coinpaprika.com/v1/
AUTHENTICATION
If you use the Free plan, you don't need to set up an API key for each request.
For other plans it is required. You can generate the API key in the Developer
Portal after signing in.
To provide the API key in REST API calls, set the Authorization header:
Authorization: <api-key>
STANDARDS AND CONVENTIONS
GENERAL
* All endpoints return either a JSON object or array
* All timestamp related fields are in seconds
ERRORS
* API errors are formatted as JSON: {"error": "<error message>"}
* The API uses standard HTTP status codes to indicate a request failure:
* HTTP 4XX return codes are used for invalid requests - the issue is on the
sender's side
* HTTP 5XX return codes are used for internal errors - the issue is on the
server's side
HTTP Status Description 400 Bad Request The server could not process the
request due to invalid request parameters or invalid format of the
parameters. 402 Payment Required The request could not be processed because
of the user has an insufficient plan. If you want to be able to process this
request, get a higher plan. 403 Forbidden The request could not be processed
due to invalid API key. 404 Not Found The server could not process the
request due to invalid URL or invalid path parameter. 429 Too Many Requests
The rate limit has been exceeded. Reduce the frequency of requests to avoid
this error. 500 Internal Server Error An unexpected server error has occured.
RATE LIMIT
* Single IP address can send less than 10 requests per second
API CLIENTS
We provide the API clients in several popular programming languages:
* PHP
* NodeJS
* GO
* Swift
* Kotlin
* Community Contributed Clients:
* C#
* JS
* Python
Note: some of them may not be updated yet. We are working on improving them and
they will be updated soon. If you'd like to contribute, please report issues and
send PRs on Github.
TERMS OF USE
* Download terms of use
ARCHIVAL DOCUMENTATIONS
* API v1.2
* API v1.3
* API v1.4
* API v1.5
* API v1.6
VERSION HISTORY
V1.7.0 - 2022.05.06
* API-Pro documentation
V1.6.1 - 2020.12.09
* Added information about first date with price data for currency ticker
/tickers and /tickers/{coin_id}
* Added redirect for historical tickers by contract address
/contracts/{platform_id}/{contract_address}/historical
V1.6.0 - 2020.10.27
* Added contracts section /contracts, /contracts/{platform_id},
/contracts/{platform_id}/{contract_address}
GLOBAL
GET MARKET OVERVIEW DATA
Returns current cryptocurrencies market overview metrics, such as:
* Global market capitalization
* Total 24h volume of all cryptocurrencies
* Number of active cryptocurrencies on coinpaprika.com
* ATH of 24h volume and market capitalization
* and more
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 5 minute.
RESPONSES
200
successful operation
429
too many requests
get/global
https://api.coinpaprika.com/v1/global
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/global'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "market_cap_usd": 430252937008,
* "volume_24h_usd": 430252937008,
* "bitcoin_dominance_percentage": 36.67,
* "cryptocurrencies_number": 1587,
* "market_cap_ath_value": 835692000000,
* "market_cap_ath_date": "2018-01-07T11:17:00Z",
* "volume_24h_ath_value": 71990500000,
* "volume_24h_ath_date": "2018-01-04T17:17:00Z",
* "market_cap_change_24h": 1.98,
* "volume_24h_change_24h": 1.98,
* "last_updated": 1525089441
}
COINS
LIST COINS
Returns basic information about cryptocurrencies on coinpaprika.com:
* identity (id, name, symbol)
* ranking (rank)
* activity status (is_active)
* type of cryptocurrency (type) - coin or token
* information whether the currency is new (is_new) - true if the currency was
added within the last 5 days
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
RESPONSES
200
successful operation
429
too many requests
get/coins
https://api.coinpaprika.com/v1/coins
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "id": "btc-bitcoin",
* "name": "Bitcoin",
* "symbol": "BTC",
* "rank": 1,
* "is_new": false,
* "is_active": true,
* "type": "coin"
}
]
GET COIN BY ID
Returns detailed descriptive information about a single coin, without price or
volume data. For price data, check the /tickers and /tickers/{coin_id}
endpoints.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}
https://api.coinpaprika.com/v1/coins/{coin_id}
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "id": "btc-bitcoin",
* "name": "Bitcoin",
* "symbol": "BTC",
* "parent": {
* "id": "eth-ethereum",
* "name": "Ethereum",
* "symbol": "ETH"
},
* "rank": 1,
* "is_new": false,
* "is_active": true,
* "type": "coin",
* "tags": [
* {
* "id": "blockchain-service",
* "name": "Blockchain Service",
* "coin_counter": 160,
* "ico_counter": 80
}
],
* "team": [
* {
* "id": "vitalik-buterin",
* "name": "Vitalik Buterin",
* "position": "Author"
}
],
* "description": "Bitcoin is a cryptocurrency and worldwide payment system. It
is the first decentralized digital currency, as the system works without a
central bank or single administrator.",
* "message": "string",
* "open_source": true,
* "hardware_wallet": true,
* "started_at": "2009-01-03T00:00:00Z",
* "development_status": "Working product",
* "proof_type": "Proof of work",
* "org_structure": "Decentralized",
* "hash_algorithm": "SHA256",
* "contract": "string",
* "platform": "string",
* "contracts": [
* {
* "contract": "string",
* "platform": "string",
* "type": "string"
}
],
* "links": {
* "explorer": [
* "http://blockchain.com/explorer",
* "https://blockchair.com/bitcoin/blocks",
* "https://blockexplorer.com/",
* "https://live.blockcypher.com/btc/"
],
* "facebook": [
* "https://www.facebook.com/bitcoins/"
],
* "reddit": [
* "https://www.reddit.com/r/bitcoin"
],
* "source_code": [
* "https://github.com/bitcoin/bitcoin"
],
* "website": [
* "https://bitcoin.org/"
],
* "youtube": [
* "https://www.youtube.com/watch?v=Um63OQz3bjo"
],
* "medium": null
},
* "links_extended": [
* {
* "url": "http://blockchain.com/explorer",
* "type": "explorer"
},
* {
* "url": "https://www.reddit.com/r/bitcoin",
* "type": "reddit",
* "stats": {
* "subscribers": 1009135
}
},
* {
* "url": "https://github.com/bitcoin/bitcoin",
* "type": "source_code",
* "stats": {
* "contributors": 730,
* "stars": 36613
}
},
* {
* "url": "https://bitcoin.org/",
* "type": "website"
}
],
* "whitepaper": {
* "link": "https://static.coinpaprika.com/storage/cdn/whitepapers/215.pdf",
* "thumbnail":
"https://static.coinpaprika.com/storage/cdn/whitepapers/217.jpg"
},
* "first_data_at": "2018-10-03T11:48:19Z",
* "last_data_at": "2019-05-03T11:00:00"
}
GET TWITTER TIMELINE TWEETS FOR A COIN
Returns the last 50 timeline tweets from the official Twitter profile for a
given coin.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 5 minutes.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}/twitter
https://api.coinpaprika.com/v1/coins/{coin_id}/twitter
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/twitter'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "date": "2018-10-03T11:48:19Z",
* "user_name": "bitcoincoreorg",
* "user_image_link": "string",
* "status": "Bitcoin Core 0.17.0 Released https://t.co/ciwCREngon",
* "is_retweet": false,
* "retweet_count": 0,
* "like_count": 0,
* "status_link": "string",
* "status_id": "string",
* "media_link": "string",
* "youtube_link": "string"
}
]
GET COIN EVENTS BY COIN ID
Returns events for a given coin.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 5 minutes.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}/events
https://api.coinpaprika.com/v1/coins/{coin_id}/events
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/events'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "id": "17398-cme-april-first-trade",
* "date": "2018-04-02T00:00:00Z",
* "date_to": "string",
* "name": "CME: April First Trade",
* "description": "First trade of Bitcoin futures contract for April 2018.",
* "is_conference": false,
* "link":
"http://www.cmegroup.com/trading/equity-index/us-index/bitcoin_product_calendar_futures.html",
* "proof_image_link":
"https://static.coinpaprika.com/storage/cdn/event_images/16635.jpg"
}
]
GET EXCHANGES BY COIN ID
Returns exchanges where a given coin is traded.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}/exchanges
https://api.coinpaprika.com/v1/coins/{coin_id}/exchanges
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/exchanges'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "id": "binance",
* "name": "Binance",
* "fiats": [
* {
* "name": "US Dollars",
* "symbol": "USD"
}
],
* "adjusted_volume_24h_share": 11.26
}
]
GET MARKETS BY COIN ID
Returns all available markets for a given coin.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
QUERY PARAMETERS
quotes
string
Default: "USD"
Example: quotes=USD,BTC
Comma separated list of quotes to return. Currently allowed values: BTC, ETH,
USD, EUR, PLN, KRW, GBP, CAD, JPY, RUB, TRY, NZD, AUD, CHF, UAH, HKD, SGD, NGN,
PHP, MXN, BRL, THB, CLP, CNY, CZK, DKK, HUF, IDR, ILS, INR, MYR, NOK, PKR, SEK,
TWD, ZAR, VND, BOB, COP, PEN, ARS, ISK
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}/markets
https://api.coinpaprika.com/v1/coins/{coin_id}/markets
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/markets'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "exchange_id": "binance",
* "exchange_name": "Binance",
* "pair": "BTC/USDT",
* "base_currency_id": "btc-bitcoin",
* "base_currency_name": "Bitcoin",
* "quote_currency_id": "usdt-tether",
* "quote_currency_name": "Tether",
* "market_url": "https://www.binance.com/en/trade/BTC_USDT",
* "category": "Spot",
* "fee_type": "Percentage",
* "outlier": false,
* "adjusted_volume_24h_share": 30.29,
* "quotes": {
* "$KEY": {
* "price": 4582.6967796728,
* "volume_24h": 229658776.19514218
}
},
* "last_updated": "2018-11-14T07:20:41Z"
}
]
GET OHLC FOR THE LAST FULL DAY
Returns Open/High/Low/Close values with volume and market capitalization for the
last full day.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
QUERY PARAMETERS
quote
string
Default: "usd"
returned data quote (available values: usd btc)
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}/ohlcv/latest/
https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/latest/
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/ohlcv/latest'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "time_open": "2018-03-01T00:00:00Z",
* "time_close": "2018-03-01T23:59:59Z",
* "open": 856.012,
* "high": 880.302,
* "low": 851.92,
* "close": 872.2,
* "volume": 1868520000,
* "market_cap": 83808161204
}
]
GET HISTORICAL OHLC
Returns Open/High/Low/Close values with volume and market capitalization for any
date range. If the end date is the current day, data can change with every
request until actual close of the day at 23:59:59"
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
QUERY PARAMETERS
start
required
string
start point for historical data
SUPPORTED FORMATS:
* RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
* Simple date (yyyy-mm-dd) eg. 2018-02-15
* Unix timestamp (in seconds) eg. 1518671700
end
string
end point for ohlcv (max 1 year)
SUPPORTED FORMATS:
* RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
* Simple date (yyyy-mm-dd) eg. 2018-02-15
* Unix timestamp (in seconds) eg. 1518671700
If not provided calculated by the limit parameter
limit
integer
Default: 1
limit of result rows (max 366)
quote
string
Default: "usd"
returned data quote (available values: usd btc)
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}/ohlcv/historical
https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/ohlcv/historical?start=2019-01-01&end=2019-01-20'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "time_open": "2018-03-01T00:00:00Z",
* "time_close": "2018-03-01T23:59:59Z",
* "open": 856.012,
* "high": 880.302,
* "low": 851.92,
* "close": 872.2,
* "volume": 1868520000,
* "market_cap": 83808161204
}
]
GET TODAY OHLC
Returns Open/High/Low/Close values with volume and market capitalization for the
current day. Data can change every each request until actual close of the day at
23:59:59.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
QUERY PARAMETERS
quote
string
Default: "usd"
returned data quote (available values: usd btc)
RESPONSES
200
successful operation
404
not found
429
too many requests
get/coins/{coin_id}/ohlcv/today/
https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/today/
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/ohlcv/today'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "time_open": "2018-03-01T00:00:00Z",
* "time_close": "2018-03-01T23:59:59Z",
* "open": 856.012,
* "high": 880.302,
* "low": 851.92,
* "close": 872.2,
* "volume": 1868520000,
* "market_cap": 83808161204
}
]
PEOPLE
GET PERSON BY ID
Returns information about a person with the specified ID, related to the
cryptocurrency market. Using this endpoint you can get a description of the
person, social media links, number of teams she or he is involved in and the
positions in those teams.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 hour.
PATH PARAMETERS
person_id
required
string
Example: vitalik-buterin
RESPONSES
200
successful operation
404
not found
429
too many requests
get/people/{person_id}
https://api.coinpaprika.com/v1/people/{person_id}
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/people/vitalik-buterin'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "id": "vitalik-buterin",
* "name": "Vitalik Buterin",
* "description": "Vitalik is the creator of Ethereum. He first discovered
blockchain and cryptocurrency technologies through Bitcoin in 2011, and was
immediately excited by the technology and its potential. He cofounded Bitcoin
Magazine in September 2011, and after two and a half years looking at what
the existing blockchain technology and applications had to offer, wrote the
Ethereum white paper in November 2013. He now leads Ethereum's research team,
working on future versions of the Ethereum protocol.",
* "teams_count": 5,
* "links": {
* "github": [
* {
* "url": "http://example.com",
* "followers": 6448
}
],
* "linkedin": [
* {
* "url": "http://example.com",
* "followers": 6448
}
],
* "medium": [
* {
* "url": "http://example.com",
* "followers": 6448
}
],
* "twitter": [
* {
* "url": "http://example.com",
* "followers": 6448
}
],
* "additional": [
* {
* "url": "http://example.com",
* "followers": 6448
}
]
},
* "positions": [
* {
* "coin_id": "eth-ethereum",
* "coin_name": "Ethereum",
* "position": "Author"
}
]
}
TAGS
LIST TAGS
Returns basic information about cryptocurrencies tags (categories):
* name
* description
* type of tag: technical or functional
* number of coins with the tag
* number of ICOs with the tag
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 hour.
QUERY PARAMETERS
additional_fields
string
Example: additional_fields=coins,icos
Comma separated list of additional fields to include in query result for each
tag. Currently supported values are: "coins" and "icos".
RESPONSES
200
successful operation
429
too many requests
get/tags
https://api.coinpaprika.com/v1/tags
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/tags'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "id": "blockchain-service",
* "name": "Blockchain Service",
* "coin_counter": 160,
* "ico_counter": 80,
* "description": "A solution for companies wanting to build, host and use
their own blockchain apps, smart contracts and functions on the
blockchain.",
* "type": "functional",
* "coins": [
* "dcr-decred",
* "hc-hypercash",
* "nxs-nexus"
],
* "icos": [
* "kodakcoin-kodakone",
* "acad-academy"
]
}
]
GET TAG BY ID
Returns information about a given cryptocurrency tag:
* name
* description
* type of tag: technical or functional
* number of coins with the tag
* number of ICOs with the tag
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 hour.
PATH PARAMETERS
tag_id
required
string
Example: blockchain-service
QUERY PARAMETERS
additional_fields
string
Example: additional_fields=coins,icos
Comma separated list of additional fields to include in query result for each
tag. Currently supported values are: "coins" and "icos".
RESPONSES
200
successful operation
404
not found
429
too many requests
get/tags/{tag_id}
https://api.coinpaprika.com/v1/tags/{tag_id}
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/tags/blockchain-service'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "id": "blockchain-service",
* "name": "Blockchain Service",
* "coin_counter": 160,
* "ico_counter": 80,
* "description": "A solution for companies wanting to build, host and use their
own blockchain apps, smart contracts and functions on the blockchain.",
* "type": "functional",
* "coins": [
* "dcr-decred",
* "hc-hypercash",
* "nxs-nexus"
],
* "icos": [
* "kodakcoin-kodakone",
* "acad-academy"
]
}
TICKERS
GET TICKERS FOR ALL ACTIVE COINS
Returns price data of all active cryptocurrencies on coinpaprika.com:
* identity (id, name, symbol)
* ranking (rank)
* supplies (circulating_supply, total_supply, max_supply)
* beta coefficient (beta_value)
* price data in a given currency (price, volumes, market cap, price changes,
ath)
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
QUERY PARAMETERS
quotes
string
Default: "USD"
Example: quotes=USD,BTC
Comma separated list of quotes to return. Currently allowed values: BTC, ETH,
USD, EUR, PLN, KRW, GBP, CAD, JPY, RUB, TRY, NZD, AUD, CHF, UAH, HKD, SGD, NGN,
PHP, MXN, BRL, THB, CLP, CNY, CZK, DKK, HUF, IDR, ILS, INR, MYR, NOK, PKR, SEK,
TWD, ZAR, VND, BOB, COP, PEN, ARS, ISK
RESPONSES
200
successful operation
429
too many requests
get/tickers
https://api.coinpaprika.com/v1/tickers
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/tickers'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "id": "btc-bitcoin",
* "name": "Bitcoin",
* "symbol": "BTC",
* "rank": 1,
* "circulating_supply": 17007062,
* "total_supply": 17007062,
* "max_supply": 21000000,
* "beta_value": 0.735327,
* "first_data_at": "2010-11-14T07:20:41Z",
* "last_updated": "2018-11-14T07:20:41Z",
* "quotes": {
* "BTC": {
* "price": 1,
* "volume_24h": 1414951.9739396,
* "volume_24h_change_24h": -4.03,
* "market_cap": 17646575,
* "market_cap_change_24h": 0.01,
* "percent_change_15m": 0,
* "percent_change_30m": 0,
* "percent_change_1h": 0,
* "percent_change_6h": 0,
* "percent_change_12h": 0,
* "percent_change_24h": 0,
* "percent_change_7d": 0,
* "percent_change_30d": 0,
* "percent_change_1y": 0,
* "ath_price": null,
* "ath_date": null,
* "percent_from_price_ath": null
},
* "USD": {
* "price": 5162.15941296,
* "volume_24h": 7304207651.1585,
* "volume_24h_change_24h": -2.5,
* "market_cap": 91094433242,
* "market_cap_change_24h": 1.6,
* "percent_change_15m": 0,
* "percent_change_30m": 0,
* "percent_change_1h": 0,
* "percent_change_6h": 0,
* "percent_change_12h": -0.09,
* "percent_change_24h": 1.59,
* "percent_change_7d": 0.28,
* "percent_change_30d": 27.39,
* "percent_change_1y": -37.99,
* "ath_price": 20089,
* "ath_date": "2017-12-17T12:19:00Z",
* "percent_from_price_ath": -74.3
}
}
}
]
GET TICKER FOR A SPECIFIC COIN
Returns price data of a single cryptocurrency on coinpaprika.com:
* identity (id, name, symbol)
* ranking (rank)
* supplies (circulating_supply, total_supply, max_supply)
* beta coefficient (beta_value)
* price data in a given currency (price, volumes, market cap, price changes,
ath)
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
QUERY PARAMETERS
quotes
string
Default: "USD"
Example: quotes=USD,BTC
Comma separated list of quotes to return. Currently allowed values: BTC, ETH,
USD, EUR, PLN, KRW, GBP, CAD, JPY, RUB, TRY, NZD, AUD, CHF, UAH, HKD, SGD, NGN,
PHP, MXN, BRL, THB, CLP, CNY, CZK, DKK, HUF, IDR, ILS, INR, MYR, NOK, PKR, SEK,
TWD, ZAR, VND, BOB, COP, PEN, ARS, ISK
RESPONSES
200
successful operation
404
not found
429
too many requests
get/tickers/{coin_id}
https://api.coinpaprika.com/v1/tickers/{coin_id}
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/tickers/btc-bitcoin'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "id": "btc-bitcoin",
* "name": "Bitcoin",
* "symbol": "BTC",
* "rank": 1,
* "circulating_supply": 17007062,
* "total_supply": 17007062,
* "max_supply": 21000000,
* "beta_value": 0.735327,
* "first_data_at": "2010-11-14T07:20:41Z",
* "last_updated": "2018-11-14T07:20:41Z",
* "quotes": {
* "BTC": {
* "price": 1,
* "volume_24h": 1414951.9739396,
* "volume_24h_change_24h": -4.03,
* "market_cap": 17646575,
* "market_cap_change_24h": 0.01,
* "percent_change_15m": 0,
* "percent_change_30m": 0,
* "percent_change_1h": 0,
* "percent_change_6h": 0,
* "percent_change_12h": 0,
* "percent_change_24h": 0,
* "percent_change_7d": 0,
* "percent_change_30d": 0,
* "percent_change_1y": 0,
* "ath_price": null,
* "ath_date": null,
* "percent_from_price_ath": null
},
* "USD": {
* "price": 5162.15941296,
* "volume_24h": 7304207651.1585,
* "volume_24h_change_24h": -2.5,
* "market_cap": 91094433242,
* "market_cap_change_24h": 1.6,
* "percent_change_15m": 0,
* "percent_change_30m": 0,
* "percent_change_1h": 0,
* "percent_change_6h": 0,
* "percent_change_12h": -0.09,
* "percent_change_24h": 1.59,
* "percent_change_7d": 0.28,
* "percent_change_30d": 27.39,
* "percent_change_1y": -37.99,
* "ath_price": 20089,
* "ath_date": "2017-12-17T12:19:00Z",
* "percent_from_price_ath": -74.3
}
}
}
GET HISTORICAL TICKS FOR A SPECIFIC COIN
Returns historical values of price, volume_24h, market_cap for a given
cryptocurrency on coinpaprika.com:
Available history range depending on the selected API plan:
Interval interval param values Free Pro Business Enterprise Daily 24h, 1d, 7d,
14d, 30d, 90d, 365d unlimited unlimited unlimited unlimited Hourly 1h, 2h, 3h,
6h, 12h last 7 days last 30 days last 365 days unlimited 5-minute 5m, 10m, 15m,
30m, 45m last 24 hours last 7 days last 30 days unlimited
Update interval: Every 1 minute.
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
QUERY PARAMETERS
start
required
string
start point for historical data
SUPPORTED FORMATS:
* RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
* Simple date (yyyy-mm-dd) eg. 2018-02-15
* Unix timestamp (in seconds) eg. 1518671700
end
string
Default: "NOW"
end point for historical data
SUPPORTED FORMATS:
* RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
* Simple date (yyyy-mm-dd) eg. 2018-02-15
* Unix timestamp (in seconds) eg. 1518671700
limit
integer
Default: 1000
limit of result rows (max 5000)
quote
string
Default: "usd"
returned data quote (available values: usd btc)
interval
string
Default: "5m"
returned points interval (available values: 5m 10m 15m 30m 45m 1h 2h 3h 6h 12h
24h 1d 7d 14d 30d 90d 365d)
RESPONSES
200
successful operation
400
invalid parameters
404
not found
429
too many requests
get/tickers/{coin_id}/historical
https://api.coinpaprika.com/v1/tickers/{coin_id}/historical
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/tickers/btc-bitcoin/historical?start=2019-01-01&interval=1d'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "timestamp": "2018-03-01T00:00:00Z",
* "price": 855.53,
* "volume_24h": 1968587956,
* "market_cap": 83761787514
}
]
EXCHANGES
LIST EXCHANGES
Returns basic information about exchanges on coinpaprika.com:
* identity (id, name)
* ranking
* activity status
* number of currencies, markets
* volumes
* etc.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
QUERY PARAMETERS
quotes
string
Default: "USD"
Example: quotes=USD,BTC
Comma separated list of quotes to return. Currently allowed values: BTC, ETH,
USD, EUR, PLN, KRW, GBP, CAD, JPY, RUB, TRY, NZD, AUD, CHF, UAH, HKD, SGD, NGN,
PHP, MXN, BRL, THB, CLP, CNY, CZK, DKK, HUF, IDR, ILS, INR, MYR, NOK, PKR, SEK,
TWD, ZAR, VND, BOB, COP, PEN, ARS, ISK
RESPONSES
200
successful operation
429
too many requests
get/exchanges
https://api.coinpaprika.com/v1/exchanges
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/exchanges'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "id": "binance",
* "name": "Binance",
* "active": true,
* "website_status": true,
* "api_status": true,
* "description": "Binance is a Malta-based cryptocurrency exchange founded
in July 2017",
* "message": "Currently under maintenance",
* "links": {
* "website": [
* "https://www.binance.com/"
],
* "twitter": [
* "https://twitter.com/binance"
]
},
* "markets_data_fetched": true,
* "adjusted_rank": 1,
* "reported_rank": 3,
* "currencies": 150,
* "markets": 385,
* "fiats": [
* {
* "name": "US Dollars",
* "symbol": "USD"
}
],
* "quotes": {
* "$KEY": {
* "reported_volume_24h": 794020873,
* "adjusted_volume_24h": 794020873,
* "reported_volume_7d": 153060819,
* "adjusted_volume_7d": 153060819,
* "reported_volume_30d": 301246828,
* "adjusted_volume_30d": 301246828
}
},
* "last_updated": "2018-11-14T07:20:41Z"
}
]
GET EXCHANGE BY ID
Returns basic information about a given exchange on coinpaprika.com:
* identity (id, name)
* ranking
* activity status
* number of currencies, markets
* volumes
* etc.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
exchange_id
required
string
Example: binance
QUERY PARAMETERS
quotes
string
Default: "USD"
Example: quotes=USD,BTC
Comma separated list of quotes to return. Currently allowed values: BTC, ETH,
USD, EUR, PLN, KRW, GBP, CAD, JPY, RUB, TRY, NZD, AUD, CHF, UAH, HKD, SGD, NGN,
PHP, MXN, BRL, THB, CLP, CNY, CZK, DKK, HUF, IDR, ILS, INR, MYR, NOK, PKR, SEK,
TWD, ZAR, VND, BOB, COP, PEN, ARS, ISK
RESPONSES
200
successful operation
404
not found
429
too many requests
get/exchanges/{exchange_id}
https://api.coinpaprika.com/v1/exchanges/{exchange_id}
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/exchanges/binance'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "id": "binance",
* "name": "Binance",
* "active": true,
* "website_status": true,
* "api_status": true,
* "description": "Binance is a Malta-based cryptocurrency exchange founded in
July 2017",
* "message": "Currently under maintenance",
* "links": {
* "website": [
* "https://www.binance.com/"
],
* "twitter": [
* "https://twitter.com/binance"
]
},
* "markets_data_fetched": true,
* "adjusted_rank": 1,
* "reported_rank": 3,
* "currencies": 150,
* "markets": 385,
* "fiats": [
* {
* "name": "US Dollars",
* "symbol": "USD"
}
],
* "quotes": {
* "$KEY": {
* "reported_volume_24h": 794020873,
* "adjusted_volume_24h": 794020873,
* "reported_volume_7d": 153060819,
* "adjusted_volume_7d": 153060819,
* "reported_volume_30d": 301246828,
* "adjusted_volume_30d": 301246828
}
},
* "last_updated": "2018-11-14T07:20:41Z"
}
LIST AN EXCHANGE MARKETS
Returns list of all available markets on a given exchange on coinpaprika.com:
* base, quote coin names/symbols, market url
* market type
* activity and outlier status
* price and volume
* etc.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
exchange_id
required
string
Example: binance
QUERY PARAMETERS
quotes
string
Default: "USD"
Example: quotes=USD,BTC
Comma separated list of quotes to return. Currently allowed values: BTC, ETH,
USD, EUR, PLN, KRW, GBP, CAD, JPY, RUB, TRY, NZD, AUD, CHF, UAH, HKD, SGD, NGN,
PHP, MXN, BRL, THB, CLP, CNY, CZK, DKK, HUF, IDR, ILS, INR, MYR, NOK, PKR, SEK,
TWD, ZAR, VND, BOB, COP, PEN, ARS, ISK
RESPONSES
200
successful operation
404
not found
429
too many requests
get/exchanges/{exchange_id}/markets
https://api.coinpaprika.com/v1/exchanges/{exchange_id}/markets
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/exchanges/binance/markets'
RESPONSE SAMPLES
* 200
* 404
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "pair": "BTC/USDT",
* "base_currency_id": "btc-bitcoin",
* "base_currency_name": "Bitcoin",
* "quote_currency_id": "usdt-tether",
* "quote_currency_name": "Tether",
* "market_url": "https://www.binance.com/en/trade/BTC_USDT",
* "category": "Spot",
* "fee_type": "Percentage",
* "outlier": false,
* "reported_volume_24h_share": 30.29,
* "quotes": {
* "$KEY": {
* "price": 4582.6967796728,
* "volume_24h": 229658776.19514218
}
},
* "last_updated": "2018-11-14T07:20:41Z"
}
]
TOOLS
SEARCH
Returns currencies, exchanges, icos, people, tags on coinpaprika.com for a given
search query.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
QUERY PARAMETERS
q
required
string
phrase for search eg. btc
c
string
Default: "currencies,exchanges,icos,people,tags"
one or more categories (comma separated) to search. Available options:
currencies|exchanges|icos|people|tags
modifier
string
set modifier for search results. Available options: symbol_search - search only
by symbol (works for currencies only)
limit
integer
Default: 6
limit of results per category (max 250)
RESPONSES
200
successful operation
400
invalid parameters
429
too many requests
get/search
https://api.coinpaprika.com/v1/search
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/search?q=btc'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "currencies": [
* {
* "id": "btc-bitcoin",
* "name": "Bitcoin",
* "symbol": "BTC",
* "rank": 1,
* "is_new": false,
* "is_active": true,
* "type": "coin"
}
],
* "icos": [
* {
* "id": "fil-filecoin-futures",
* "name": "Filecoin",
* "symbol": "FIL",
* "is_new": false
}
],
* "exchanges": [
* {
* "id": "binance",
* "name": "Binance",
* "rank": 1
}
],
* "people": [
* {
* "id": "vitalik-buterin",
* "name": "Vitalik Buterin",
* "teams_count": 5
}
],
* "tags": [
* {
* "id": "blockchain-service",
* "name": "Blockchain Service",
* "coin_counter": 160,
* "ico_counter": 80
}
]
}
PRICE CONVERTER
Converts a set amount of base currency to quote currency.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
QUERY PARAMETERS
base_currency_id
required
string
quote_currency_id
required
string
amount
integer
Default: 0
RESPONSES
200
successful operation
400
invalid parameters
429
too many requests
get/price-converter
https://api.coinpaprika.com/v1/price-converter
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/price-converter?base_currency_id=btc-bitcoin"e_currency_id=eth-ethereum&amount=1.2'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "base_currency_id": "btc-bitcoin",
* "base_currency_name": "Bitcoin",
* "base_price_last_updated": "2019-02-26T13:32:39Z",
* "quote_currency_id": "usd-us-dollars",
* "quote_currency_name": "US Dollars",
* "quote_price_last_updated": "2019-02-26T13:33:45Z",
* "amount": 100,
* "price": 386621.99158499995
}
CONTRACTS
LIST CONTRACTS PLATFORMS
Returns all available contract platforms on coinpaprika.com.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
RESPONSES
200
successful operation
429
too many requests
get/contracts
https://api.coinpaprika.com/v1/contracts
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/contracts'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* "eth-ethereum"
]
GET ALL CONTRACT ADDRESSESS FOR A GIVEN PLATFORM
Returns all available contracts for a given platform on coinpaprika.com.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
platform_id
required
string
Example: eth_ethereum
RESPONSES
200
successful operation
429
too many requests
get/contracts/{platform_id}
https://api.coinpaprika.com/v1/contracts/{platform_id}
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/contracts/eth-ethereum'
RESPONSE SAMPLES
* 200
* 429
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "address": "0xd26114cd6ee289accf82350c8d8487fedb8a0c07",
* "id": "omg-omisego",
* "type": "ERC20"
}
]
REDIRECT TO TICKER BY CONTRACT ADDRESS
Returns ticker data for a contract with a given address.
Available on the following API plans:
* Free
* Pro
* Business
* Enterprise
Update interval: Every 1 minute.
PATH PARAMETERS
platform_id
required
string
Example: eth_ethereum
contract_address
required
string
Example: 0xd26114cd6ee289accf82350c8d8487fedb8a0c07
RESPONSES
301
successful redirect
429
too many requests
get/contracts/{platform_id}/{contract_address}
https://api.coinpaprika.com/v1/contracts/{platform_id}/{contract_address}
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/contracts/eth-ethereum/0xd26114cd6ee289accf82350c8d8487fedb8a0c07'
RESPONSE SAMPLES
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "error": "you have reached maximum request limit"
}
REDIRECT TO HISTORICAL TICKS BY CONTRACT ADDRESS
Returns historical ticks for a contract with a given address.
Check historical ticks endpoint documentation to find out about the limitations
for each API plan.
Update interval: Every 1 minute.
PATH PARAMETERS
platform_id
required
string
Example: eth_ethereum
contract_address
required
string
Example: 0xd26114cd6ee289accf82350c8d8487fedb8a0c07
QUERY PARAMETERS
start
required
string
start point for historical data
SUPPORTED FORMATS:
* RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
* Simple date (yyyy-mm-dd) eg. 2018-02-15
* Unix timestamp (in seconds) eg. 1518671700
end
string
Default: "NOW"
end point for historical data
SUPPORTED FORMATS:
* RFC3999 (ISO-8601) eg. 2018-02-15T05:15:00Z
* Simple date (yyyy-mm-dd) eg. 2018-02-15
* Unix timestamp (in seconds) eg. 1518671700
limit
integer
Default: 1000
limit of result rows (max 5000)
quote
string
Default: "usd"
returned data quote (available values: usd btc)
interval
string
Default: "5m"
returned points interval (available values: 5m 10m 15m 30m 45m 1h 2h 3h 6h 12h
24h 1d 7d 14d 30d 90d 365d)
RESPONSES
301
successful redirect
429
too many requests
get/contracts/{platform_id}/{contract_address}/historical
https://api.coinpaprika.com/v1/contracts/{platform_id}/{contract_address}/historical
REQUEST SAMPLES
* CLI
Copy
curl --request GET \
--url 'https://api.coinpaprika.com/v1/contracts/eth-ethereum/0xd26114cd6ee289accf82350c8d8487fedb8a0c07/historical?start=2019-01-01&interval=1d'
RESPONSE SAMPLES
* 429
Content type
application/json
Copy
Expand all Collapse all
{
* "error": "you have reached maximum request limit"
}
DEPRECATED
GET TICKER INFORMATION FOR ALL COINS [DEPRECATED]
RESPONSES
200
successful operation
429
too many requests
get/ticker
https://api.coinpaprika.com/v1/ticker
RESPONSE SAMPLES
* 200
Content type
application/json
Copy
Expand all Collapse all
[
* {
* "id": "btc-bitcoin",
* "name": "Bitcoin",
* "symbol": "BTC",
* "rank": "1",
* "price_usd": "9259.01",
* "price_btc": "1",
* "volume_24h_usd": "8102619999",
* "market_cap_usd": "157468557128",
* "circulating_supply": "17007062",
* "total_supply": "17007062",
* "max_supply": "21000000",
* "percent_change_1h": "-0.26",
* "percent_change_24h": "0.22",
* "percent_change_7d": "4.1",
* "last_updated": "1525088839"
}
]
GET TICKER BY ID [DEPRECATED]
PATH PARAMETERS
coin_id
required
string
Example: btc-bitcoin
RESPONSES
200
successful operation
429
too many requests
get/ticker/{coin_id}
https://api.coinpaprika.com/v1/ticker/{coin_id}
RESPONSE SAMPLES
* 200
Content type
application/json
Copy
Expand all Collapse all
{
* "id": "btc-bitcoin",
* "name": "Bitcoin",
* "symbol": "BTC",
* "rank": "1",
* "price_usd": "9259.01",
* "price_btc": "1",
* "volume_24h_usd": "8102619999",
* "market_cap_usd": "157468557128",
* "circulating_supply": "17007062",
* "total_supply": "17007062",
* "max_supply": "21000000",
* "percent_change_1h": "-0.26",
* "percent_change_24h": "0.22",
* "percent_change_7d": "4.1",
* "last_updated": "1525088839"
}