TPO

List historical TPO (Market Profile) data

Provide exchange, symbol, and timeframe. Nothing else is required: the window defaults to the 40 timeframe periods before now.

With from the window starts there and runs forward, ending at to or after period seconds (40 timeframe periods by default).
Without from the window ends at to (now by default) and runs backwards over period seconds or the 40 timeframe periods before it.
The default is measured in wall-clock time, so it holds fewer than 40 periods on an exchange with non-trading days (about 28 for a 1d frame on a weekday-only market).
period cannot be added to an explicit from+to window.
Supported timeframes are day, week, and month based (1d..31d, 1w..4w, 1M).
If from is not aligned to a timeframe period boundary, the beginning of the next period is used.
The requested range is limited to at most 400 profiles (with mergeSessions=GROUP_BY_TYPE every session type of a period counts as a profile); a wider range is rejected with 400 too_much_data.

Cost: 25 credits per returned timeframe period (distinct openTradingDay), at least 1000 credits per request. With mergeSessions=GROUP_BY_TYPE one profile per session type is built for every period at no additional cost.

GET

api

marketdata

tpo

List historical TPO (Market Profile) data

curl --request GET \
  --url https://public-api.takeprofit.com/api/v1/marketdata/tpo \
  --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/tpo', 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/tpo",
  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/tpo"

	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/tpo")

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": "1d"
  },
  "profiles": [
    {
      "openTradingDay": "2026-09-21T00:00:00Z",
      "profileEnd": "2026-09-21T20:00:00Z",
      "sessionType": "MAINSESSION",
      "rowSize": "0.26",
      "pointOfControl": "338.26",
      "initialBalanceHigh": "337.74",
      "initialBalanceLow": "332.8",
      "blocks": [
        48600,
        50400,
        52200,
        54000,
        55800,
        57600,
        59400,
        61200,
        63000,
        64800,
        66600,
        68400,
        70200
      ],
      "rows": [
        [
          "332.8",
          [
            0
          ],
          "0",
          "106"
        ],
        [
          "333.06",
          [
            0
          ],
          "2754",
          "4223"
        ],
        [
          "333.32",
          [
            0
          ],
          "7037",
          "9217"
        ],
        [
          "333.58",
          [
            0
          ],
          "7783",
          "9611"
        ],
        [
          "333.84",
          [
            0
          ],
          "8329",
          "15930"
        ],
        [
          "334.1",
          [
            0
          ],
          "9352",
          "8254"
        ],
        [
          "334.36",
          [
            0
          ],
          "9777",
          "11524"
        ],
        [
          "334.62",
          [
            0
          ],
          "4930",
          "2161"
        ],
        [
          "334.88",
          [
            0
          ],
          "7366",
          "2128"
        ],
        [
          "335.14",
          [
            0
          ],
          "12193",
          "9753"
        ],
        [
          "335.4",
          [
            0
          ],
          "2663",
          "1883"
        ],
        [
          "335.66",
          [
            0,
            1
          ],
          "10208",
          "10787"
        ],
        [
          "335.92",
          [
            0,
            1
          ],
          "20081",
          "7412"
        ],
        [
          "336.18",
          [
            0,
            1,
            2
          ],
          "12438",
          "4948"
        ],
        [
          "336.44",
          [
            1,
            2
          ],
          "21328",
          "43779"
        ],
        [
          "336.7",
          [
            1,
            2,
            3,
            4
          ],
          "19068",
          "29667"
        ],
        [
          "336.96",
          [
            1,
            2,
            3,
            4
          ],
          "43127",
          "21425"
        ],
        [
          "337.22",
          [
            1,
            2,
            3,
            4
          ],
          "20867",
          "16892"
        ],
        [
          "337.48",
          [
            1,
            2,
            3,
            4,
            5
          ],
          "26492",
          "13659"
        ],
        [
          "337.74",
          [
            1,
            2,
            3,
            4,
            5,
            9
          ],
          "26485",
          "10554"
        ],
        [
          "338",
          [
            2,
            4,
            5,
            8,
            9,
            11
          ],
          "32058",
          "16709"
        ],
        [
          "338.26",
          [
            4,
            5,
            6,
            7,
            8,
            9,
            10,
            11
          ],
          "34640",
          "20544"
        ],
        [
          "338.52",
          [
            5,
            6,
            7,
            8,
            9,
            10,
            11
          ],
          "57464",
          "46732"
        ],
        [
          "338.78",
          [
            5,
            6,
            7,
            8,
            9,
            10,
            11,
            12
          ],
          "90818",
          "36228"
        ],
        [
          "339.04",
          [
            6,
            7,
            9,
            10,
            11,
            12
          ],
          "43163",
          "29151"
        ],
        [
          "339.3",
          [
            11,
            12
          ],
          "29120",
          "10199"
        ],
        [
          "339.56",
          [
            11,
            12
          ],
          "2754",
          "3395"
        ]
      ]
    }
  ]
}

{
  "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

Day (1d..31d), week (1w..4w), or month (1M) timeframe id. 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. Unix seconds (for example 1790000000) or RFC3339 timestamp.

period

integer

Range duration in seconds, counted forward from from or backwards from to.

Required range: x >= 1

blockSize

enum<string>

Duration of each profile time block. Defaults to 30m. Duration of each TPO time block.

Available options:

30m,

1h,

2h,

4h

rowSize

integer

Price row height in tick size. 0 (or omitted) enables automatic row size detection.

Required range: 0 <= x <= 1000000

sessionType

enum<string>[]

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

Available options:

MAINSESSION,

PRE_MARKET,

POST_MARKET

mergeSessions

enum<string>

How sessions are merged into profiles. Defaults to MERGE_ALL. MERGE_ALL merges all sessions into one profile per period. GROUP_BY_TYPE builds one profile per session type per period.

Available options:

MERGE_ALL,

GROUP_BY_TYPE

Response

TPO response.

meta

object

required

Show child attributes

profiles

object[]

required

Show child attributes

List historical TPO (Market Profile) data

curl --request GET \
  --url https://public-api.takeprofit.com/api/v1/marketdata/tpo \
  --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/tpo', 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/tpo",
  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/tpo"

	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/tpo")

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": "1d"
  },
  "profiles": [
    {
      "openTradingDay": "2026-09-21T00:00:00Z",
      "profileEnd": "2026-09-21T20:00:00Z",
      "sessionType": "MAINSESSION",
      "rowSize": "0.26",
      "pointOfControl": "338.26",
      "initialBalanceHigh": "337.74",
      "initialBalanceLow": "332.8",
      "blocks": [
        48600,
        50400,
        52200,
        54000,
        55800,
        57600,
        59400,
        61200,
        63000,
        64800,
        66600,
        68400,
        70200
      ],
      "rows": [
        [
          "332.8",
          [
            0
          ],
          "0",
          "106"
        ],
        [
          "333.06",
          [
            0
          ],
          "2754",
          "4223"
        ],
        [
          "333.32",
          [
            0
          ],
          "7037",
          "9217"
        ],
        [
          "333.58",
          [
            0
          ],
          "7783",
          "9611"
        ],
        [
          "333.84",
          [
            0
          ],
          "8329",
          "15930"
        ],
        [
          "334.1",
          [
            0
          ],
          "9352",
          "8254"
        ],
        [
          "334.36",
          [
            0
          ],
          "9777",
          "11524"
        ],
        [
          "334.62",
          [
            0
          ],
          "4930",
          "2161"
        ],
        [
          "334.88",
          [
            0
          ],
          "7366",
          "2128"
        ],
        [
          "335.14",
          [
            0
          ],
          "12193",
          "9753"
        ],
        [
          "335.4",
          [
            0
          ],
          "2663",
          "1883"
        ],
        [
          "335.66",
          [
            0,
            1
          ],
          "10208",
          "10787"
        ],
        [
          "335.92",
          [
            0,
            1
          ],
          "20081",
          "7412"
        ],
        [
          "336.18",
          [
            0,
            1,
            2
          ],
          "12438",
          "4948"
        ],
        [
          "336.44",
          [
            1,
            2
          ],
          "21328",
          "43779"
        ],
        [
          "336.7",
          [
            1,
            2,
            3,
            4
          ],
          "19068",
          "29667"
        ],
        [
          "336.96",
          [
            1,
            2,
            3,
            4
          ],
          "43127",
          "21425"
        ],
        [
          "337.22",
          [
            1,
            2,
            3,
            4
          ],
          "20867",
          "16892"
        ],
        [
          "337.48",
          [
            1,
            2,
            3,
            4,
            5
          ],
          "26492",
          "13659"
        ],
        [
          "337.74",
          [
            1,
            2,
            3,
            4,
            5,
            9
          ],
          "26485",
          "10554"
        ],
        [
          "338",
          [
            2,
            4,
            5,
            8,
            9,
            11
          ],
          "32058",
          "16709"
        ],
        [
          "338.26",
          [
            4,
            5,
            6,
            7,
            8,
            9,
            10,
            11
          ],
          "34640",
          "20544"
        ],
        [
          "338.52",
          [
            5,
            6,
            7,
            8,
            9,
            10,
            11
          ],
          "57464",
          "46732"
        ],
        [
          "338.78",
          [
            5,
            6,
            7,
            8,
            9,
            10,
            11,
            12
          ],
          "90818",
          "36228"
        ],
        [
          "339.04",
          [
            6,
            7,
            9,
            10,
            11,
            12
          ],
          "43163",
          "29151"
        ],
        [
          "339.3",
          [
            11,
            12
          ],
          "29120",
          "10199"
        ],
        [
          "339.56",
          [
            11,
            12
          ],
          "2754",
          "3395"
        ]
      ]
    }
  ]
}

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