Candles

List historical candles

Provide exchange, symbol, and timeframe. Nothing else is required: the window defaults to the last 1000 candles.

With from the window starts there and runs forward, ending at to, after period seconds, or after limit candles (1000 by default).
Without from the window ends at to (now by default) and runs backwards over limit candles (1000 by default) or period seconds.
period and limit cannot be used together, and neither can be added to an explicit from+to window.
Tick timeframes accept from and limit only.
A request is limited to at most 10000 estimated candles.

Cost: 1 credit per returned candle, at least 1000 credits per request.

GET

api

marketdata

candles

List historical candles

curl --request GET \
  --url https://public-api.takeprofit.com/api/v1/marketdata/candles \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://public-api.takeprofit.com/api/v1/marketdata/candles', 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://public-api.takeprofit.com/api/v1/marketdata/candles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://public-api.takeprofit.com/api/v1/marketdata/candles"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://public-api.takeprofit.com/api/v1/marketdata/candles")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "meta": {
    "exchange": "BATS",
    "symbol": "AAPL",
    "timeframe": "1m"
  },
  "candles": [
    {
      "timestamp": "2026-09-21T13:30:00Z",
      "open": "335.28",
      "high": "335.54",
      "low": "333.66",
      "close": "333.97",
      "volume": "12895",
      "sessionType": "MAINSESSION"
    },
    {
      "timestamp": "2026-09-21T13:31:00Z",
      "open": "333.92",
      "high": "334.52",
      "low": "333.66",
      "close": "334.07",
      "volume": "4172",
      "sessionType": "MAINSESSION"
    }
  ]
}

{
  "error": {
    "code": "invalid_argument",
    "message": "query parameter \"exchange\" is required"
  }
}

{
  "error": {
    "code": "unauthenticated",
    "message": "authentication failed"
  }
}

{
  "error": {
    "code": "permission_denied",
    "message": "permission denied"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "security not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded"
  }
}

Authorizations

x-api-key

string

header

required

Query Parameters

exchange

string

required

TakeProfit exchange code as returned by /api/v1/marketdata/exchanges.

Example:

"BATS"

symbol

string

required

Public security symbol returned by /api/v1/marketdata/exchanges/{exchange}/securities. TakeProfit security symbol as returned by /api/v1/marketdata/exchanges/{exchange}/securities. In a path segment a slash must be percent-encoded (BTC/USDT is requested as BTC%2FUSDT).

Example:

"AAPL"

timeframe

string

required

Timeframe id returned by /api/v1/marketdata/timeframes. Canonical suffixes include M for months and Q for quarters.

Example:

"1h"

from

string

Range start as Unix seconds or RFC3339 timestamp. Without it the window is measured backwards from to. Unix seconds (for example 1790000000) or RFC3339 timestamp.

string

Range end as Unix seconds or RFC3339 timestamp, greater than from. Defaults to now when from is omitted. Not supported for tick timeframes. Unix seconds (for example 1790000000) or RFC3339 timestamp.

period

integer

Range duration in seconds, counted forward from from or backwards from to. Not supported for tick timeframes.

Required range: x >= 1

limit

integer

Candle count to return, counted forward from from or backwards from to. Defaults to 1000.

Required range: 1 <= x <= 10000

sessionType

enum<string>[]

Optional session filter. Repeat this parameter or pass comma-separated values.

Available options:

MAINSESSION,

PRE_MARKET,

POST_MARKET

Response

Candles response.

meta

object

required

Show child attributes

candles

object[]

required

Show child attributes

List historical candles

curl --request GET \
  --url https://public-api.takeprofit.com/api/v1/marketdata/candles \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://public-api.takeprofit.com/api/v1/marketdata/candles', 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://public-api.takeprofit.com/api/v1/marketdata/candles",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://public-api.takeprofit.com/api/v1/marketdata/candles"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://public-api.takeprofit.com/api/v1/marketdata/candles")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "meta": {
    "exchange": "BATS",
    "symbol": "AAPL",
    "timeframe": "1m"
  },
  "candles": [
    {
      "timestamp": "2026-09-21T13:30:00Z",
      "open": "335.28",
      "high": "335.54",
      "low": "333.66",
      "close": "333.97",
      "volume": "12895",
      "sessionType": "MAINSESSION"
    },
    {
      "timestamp": "2026-09-21T13:31:00Z",
      "open": "333.92",
      "high": "334.52",
      "low": "333.66",
      "close": "334.07",
      "volume": "4172",
      "sessionType": "MAINSESSION"
    }
  ]
}

{
  "error": {
    "code": "invalid_argument",
    "message": "query parameter \"exchange\" is required"
  }
}

{
  "error": {
    "code": "unauthenticated",
    "message": "authentication failed"
  }
}

{
  "error": {
    "code": "permission_denied",
    "message": "permission denied"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "security not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "rate limit exceeded"
  }
}