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
Starter
Pro
Business
Enterprise

Maximum time range of data available to fetch depending on the plan:

Plan	Time range
Free	Last 24 hours
Starter	Last 30 days
Pro	Last 90 days
Business	Last 365 days
Enterprise	No limits

The default interval of returned data for OHLCV is 24 hours:

[
  {
    "time_open": "2020-01-01T00:00:00Z",
    "time_close": "2020-01-01T23:59:59Z",
    "open": ...,
    "high": ...,
    "low": ...,
    "close": ...,
    "volume": ...,
    "market_cap": ...
  }
  ...
]

However, depending on your API plan, you can set a smaller interval by using the query parameter interval:

Plan	`interval` parameter value
Free	`24h`
Starter	`24h`
Pro	`24h`
Business	`1h`, `6h`, `12h`, `24h`
Enterprise	`5m`, `15m`, `30m`, `1h`, `6h`, `12h`, `24h`

Update interval: Every 5 minute.

GET

coins

{coin_id}

ohlcv

historical

CLI

curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/ohlcv/historical?start=2019-01-01&end=2019-01-20'

import requests

url = "https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "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
  }
]

{
  "error": "id not found"
}

{
  "error": "you have reached maximum request limit"
}

Path Parameters

coin_id

string

required

Example:

"btc-bitcoin"

Query Parameters

start

string

required

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)

interval

string

default:24h

returned OHLCV point interval (available values: 5m, 15m, 30m, 1h, 6h, 12h, 24h)

quote

string

default:usd

returned data quote (available values: usd btc)

Response

successful operation

time_open

string

RFC3999 (ISO-8601) format

Example:

"2018-03-01T00:00:00Z"

time_close

string

RFC3999 (ISO-8601) format

Example:

"2018-03-01T23:59:59Z"

open

number | null

Example:

856.012

high

number | null

Example:

880.302

low

number | null

Example:

851.92

number | null

Example:

872.2

volume

integer | null

Example:

1868520000

market_cap

integer | null

Example:

83808161204

Get today OHLCReturns 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 - Starter - Pro - Business - Enterprise **Update interval:** Every 5 minute.

CLI

curl --request GET \
--url 'https://api.coinpaprika.com/v1/coins/btc-bitcoin/ohlcv/historical?start=2019-01-01&end=2019-01-20'

import requests

url = "https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.coinpaprika.com/v1/coins/{coin_id}/ohlcv/historical")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

[
  {
    "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
  }
]

{
  "error": "id not found"
}

{
  "error": "you have reached maximum request limit"
}