Get Price OHLC

Endpoint

GET /api/price/ohlc/v1

Parameters

Name	In	Type	Required	Description
asset	query	string	✅
period	query	—	✅	One hour, one day or one month.
timestamp_start	query	integer		Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
timestamp_end	query	integer		End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive)
page	query	integer		The page number of the response.
limit	query	integer		The number of responses. max is 200,

Responses

200 — Price OHLCs retrieved successfully

Media: application/json

Schema

{
  "type": "object",
  "required": [
    "pagination",
    "data"
  ],
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "period",
          "timestamp",
          "asset",
          "volume_24h",
          "open",
          "high",
          "low",
          "close"
        ],
        "properties": {
          "asset": {
            "type": "string"
          },
          "close": {
            "type": "string"
          },
          "high": {
            "type": "string"
          },
          "low": {
            "type": "string"
          },
          "open": {
            "type": "string"
          },
          "period": {
            "type": "string"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time"
          },
          "volume_24h": {
            "type": "string"
          }
        }
      }
    },
    "pagination": {
      "type": "object",
      "required": [
        "current_page",
        "per_page",
        "total_items",
        "total_pages"
      ],
      "properties": {
        "current_page": {
          "type": "integer",
          "format": "int32"
        },
        "next_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "per_page": {
          "type": "integer",
          "format": "int32"
        },
        "prev_page": {
          "type": "integer",
          "format": "int32",
          "nullable": true
        },
        "total_items": {
          "type": "integer",
          "format": "int32"
        },
        "total_pages": {
          "type": "integer",
          "format": "int32"
        }
      }
    }
  }
}

Examples

{
  "Result": {
    "value": "{\n  \"pagination\": {\n    \"current_page\": 1,\n    \"per_page\": 50,\n    \"total_items\": 977,\n    \"total_pages\": 20,\n    \"next_page\": 2,\n    \"prev_page\": null\n  },\n  \"data\": [\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-26T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"263821126.1415\",\n      \"open\": \"379.5458\",\n      \"high\": \"385.8701\",\n      \"low\": \"363.6157\",\n      \"close\": \"366.4996\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-25T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"417313992.0036\",\n      \"open\": \"397.1862\",\n      \"high\": \"405.8875\",\n      \"low\": \"356.3167\",\n      \"close\": \"381.5133\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-24T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"293676148.6443\",\n      \"open\": \"432.6099\",\n      \"high\": \"439.4285\",\n      \"low\": \"401.0247\",\n      \"close\": \"404.2285\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-23T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"120127774.3861\",\n      \"open\": \"433.2872\",\n      \"high\": \"441.7220\",\n      \"low\": \"416.9573\",\n      \"close\": \"431.7027\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-22T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"173246841.2394\",\n      \"open\": \"443.2756\",\n      \"high\": \"454.6406\",\n      \"low\": \"424.7332\",\n      \"close\": \"434.6695\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-21T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"290904586.1483\",\n      \"open\": \"464.3842\",\n      \"high\": \"488.7084\",\n      \"low\": \"429.7727\",\n      \"close\": \"441.7635\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-20T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"289929302.5397\",\n      \"open\": \"418.8674\",\n      \"high\": \"466.1259\",\n      \"low\": \"418.6452\",\n      \"close\": \"463.8020\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-19T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"247688880.7693\",\n      \"open\": \"375.7505\",\n      \"high\": \"424.0179\",\n      \"low\": \"370.3362\",\n      \"close\": \"417.3923\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-18T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"164179154.7519\",\n      \"open\": \"360.6571\",\n      \"high\": \"385.9896\",\n      \"low\": \"349.6245\",\n      \"close\": \"373.9885\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-17T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"127854353.8772\",\n      \"open\": \"360.3490\",\n      \"high\": \"375.2229\",\n      \"low\": \"348.9650\",\n      \"close\": \"360.0873\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-16T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"72308954.7460\",\n      \"open\": \"375.2919\",\n      \"high\": \"376.1435\",\n      \"low\": \"356.9175\",\n      \"close\": \"361.4126\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-15T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"81327760.9927\",\n      \"open\": \"391.5728\",\n      \"high\": \"401.1891\",\n      \"low\": \"371.8710\",\n      \"close\": \"376.0996\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-14T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"152451676.6873\",\n      \"open\": \"382.8790\",\n      \"high\": \"405.5877\",\n      \"low\": \"377.9664\",\n      \"close\": \"389.7182\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-13T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"164709039.2869\",\n      \"open\": \"401.9151\",\n      \"high\": \"413.3219\",\n      \"low\": \"373.1497\",\n      \"close\": \"384.1851\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-12T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"231354211.1097\",\n      \"open\": \"412.2387\",\n      \"high\": \"416.9779\",\n      \"low\": \"376.9582\",\n      \"close\": \"401.5705\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-11T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"257793914.9074\",\n      \"open\": \"386.7262\",\n      \"high\": \"435.6251\",\n      \"low\": \"386.7262\",\n      \"close\": \"411.6853\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-10T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"198691735.7230\",\n      \"open\": \"365.1658\",\n      \"high\": \"398.0300\",\n      \"low\": \"353.1147\",\n      \"close\": \"383.4704\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-09T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"155337840.4256\",\n      \"open\": \"351.4171\",\n      \"high\": \"367.6921\",\n      \"low\": \"345.5374\",\n      \"close\": \"366.5424\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-08T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"134941316.8754\",\n      \"open\": \"320.0634\",\n      \"high\": \"351.7078\",\n      \"low\": \"319.5067\",\n      \"close\": \"351.7078\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-07T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"187547850.0846\",\n      \"open\": \"326.2729\",\n      \"high\": \"350.5707\",\n      \"low\": \"309.2638\",\n      \"close\": \"319.8709\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-06T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"187501625.0173\",\n      \"open\": \"350.0670\",\n      \"high\": \"373.6964\",\n      \"low\": \"325.0455\",\n      \"close\": \"325.0455\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-05T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"174251235.9466\",\n      \"open\": \"358.7566\",\n      \"high\": \"367.3150\",\n      \"low\": \"343.7030\",\n      \"close\": \"351.1294\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-04T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"292995755.4348\",\n      \"open\": \"399.0081\",\n      \"high\": \"399.0081\",\n      \"low\": \"350.9335\",\n      \"close\": \"357.5705\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-03T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"689492829.9311\",\n      \"open\": \"351.0259\",\n      \"high\": \"392.7751\",\n      \"low\": \"268.2490\",\n      \"close\": \"391.4238\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-02T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"315356245.5530\",\n      \"open\": \"393.6679\",\n      \"high\": \"403.4273\",\n      \"low\": \"341.4735\",\n      \"close\": \"347.5191\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-02-01T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"198215034.3197\",\n      \"open\": \"448.7017\",\n      \"high\": \"466.9395\",\n      \"low\": \"391.1135\",\n      \"close\": \"395.1650\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-31T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"166040294.2371\",\n      \"open\": \"452.7958\",\n      \"high\": \"474.3623\",\n      \"low\": \"446.2048\",\n      \"close\": \"448.7641\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-30T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"183063289.3843\",\n      \"open\": \"448.1760\",\n      \"high\": \"476.6073\",\n      \"low\": \"446.2326\",\n      \"close\": \"454.5244\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-29T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"360461497.7984\",\n      \"open\": \"451.4391\",\n      \"high\": \"496.3865\",\n      \"low\": \"442.3210\",\n      \"close\": \"450.6865\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-28T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"247969734.3309\",\n      \"open\": \"446.0712\",\n      \"high\": \"460.1391\",\n      \"low\": \"431.3334\",\n      \"close\": \"444.9063\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-27T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"545440799.0010\",\n      \"open\": \"433.8691\",\n      \"high\": \"473.2535\",\n      \"low\": \"387.4840\",\n      \"close\": \"441.3764\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-26T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"256568630.4462\",\n      \"open\": \"407.5977\",\n      \"high\": \"458.4287\",\n      \"low\": \"402.6062\",\n      \"close\": \"433.4903\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-25T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"137091719.4025\",\n      \"open\": \"371.9159\",\n      \"high\": \"417.4692\",\n      \"low\": \"364.2841\",\n      \"close\": \"413.1925\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-24T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"145660445.0171\",\n      \"open\": \"380.2868\",\n      \"high\": \"389.8673\",\n      \"low\": \"364.9406\",\n      \"close\": \"370.5888\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-23T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"235178771.3298\",\n      \"open\": \"399.4911\",\n      \"high\": \"399.4911\",\n      \"low\": \"371.5500\",\n      \"close\": \"380.8522\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-22T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"147397911.0979\",\n      \"open\": \"425.8191\",\n      \"high\": \"430.9405\",\n      \"low\": \"399.0062\",\n      \"close\": \"401.1287\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-21T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"205626431.8235\",\n      \"open\": \"407.0540\",\n      \"high\": \"430.8847\",\n      \"low\": \"387.1831\",\n      \"close\": \"426.3480\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-20T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"295264801.4321\",\n      \"open\": \"425.0844\",\n      \"high\": \"467.7773\",\n      \"low\": \"406.8480\",\n      \"close\": \"409.8736\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-19T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"305663527.7432\",\n      \"open\": \"457.5348\",\n      \"high\": \"474.1965\",\n      \"low\": \"416.3037\",\n      \"close\": \"424.4864\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-18T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"168607970.3113\",\n      \"open\": \"485.3808\",\n      \"high\": \"493.4261\",\n      \"low\": \"441.8882\",\n      \"close\": \"460.0504\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-17T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"154212420.5129\",\n      \"open\": \"445.6999\",\n      \"high\": \"490.9864\",\n      \"low\": \"445.6999\",\n      \"close\": \"486.9949\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-16T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"161586284.4438\",\n      \"open\": \"459.0480\",\n      \"high\": \"467.3519\",\n      \"low\": \"440.4712\",\n      \"close\": \"443.5276\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-15T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"210453794.8342\",\n      \"open\": \"416.0600\",\n      \"high\": \"466.5185\",\n      \"low\": \"403.8969\",\n      \"close\": \"457.0246\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-14T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"155600544.1796\",\n      \"open\": \"420.9810\",\n      \"high\": \"430.8358\",\n      \"low\": \"410.6926\",\n      \"close\": \"417.2112\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-13T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"308250795.6698\",\n      \"open\": \"443.5755\",\n      \"high\": \"454.1476\",\n      \"low\": \"394.1604\",\n      \"close\": \"420.5869\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-12T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"170477551.1528\",\n      \"open\": \"445.5099\",\n      \"high\": \"450.8296\",\n      \"low\": \"435.4201\",\n      \"close\": \"443.4141\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-11T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"157468129.4015\",\n      \"open\": \"439.1084\",\n      \"high\": \"454.1055\",\n      \"low\": \"428.8638\",\n      \"close\": \"447.6506\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-10T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"292380636.1004\",\n      \"open\": \"432.2257\",\n      \"high\": \"454.4338\",\n      \"low\": \"424.6815\",\n      \"close\": \"440.5970\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-09T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"200669721.3126\",\n      \"open\": \"467.5310\",\n      \"high\": \"474.0472\",\n      \"low\": \"430.1614\",\n      \"close\": \"431.3249\"\n    },\n    {\n      \"period\": \"1d\",\n      \"timestamp\": \"2025-01-08T00:00:00Z\",\n      \"asset\": \"TAO\",\n      \"volume_24h\": \"261700538.1583\",\n      \"open\": \"499.0671\",\n      \"high\": \"500.0575\",\n      \"low\": \"443.0413\",\n      \"close\": \"468.2963\"\n    }\n  ]\n}"
  }
}

400 — Bad request

404 — Price OHLCs not found

500 — Internal server error

Try it

Interactive request console coming soon. In the meantime you can use the OpenAPI spec with any client (Insomnia, Bruno, Scalar, curl).

Authentication

All Taostats API requests require an Authorization header containing your API key. See Getting Started.