finance.price.history

POST

ops

Daily, weekly or monthly OHLCV bars for a stock, ETF or index. Returns a normalized Candle page.

curl --request POST \
  --url https://api.agentkey.app/v2/ops/finance.price.history \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbol": "<string>",
  "end": "2023-12-25",
  "fields": [
    "<string>"
  ],
  "include_raw": false,
  "interval": "1d",
  "limit": 100,
  "provider": "<string>",
  "routing": {
    "allow_fallbacks": true,
    "only": [
      "<string>"
    ],
    "order": [
      "<string>"
    ],
    "strategy": "auto"
  },
  "start": "2023-12-25"
}
'

import requests

url = "https://api.agentkey.app/v2/ops/finance.price.history"

payload = {
    "symbol": "<string>",
    "end": "2023-12-25",
    "fields": ["<string>"],
    "include_raw": False,
    "interval": "1d",
    "limit": 100,
    "provider": "<string>",
    "routing": {
        "allow_fallbacks": True,
        "only": ["<string>"],
        "order": ["<string>"],
        "strategy": "auto"
    },
    "start": "2023-12-25"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    symbol: '<string>',
    end: '2023-12-25',
    fields: ['<string>'],
    include_raw: false,
    interval: '1d',
    limit: 100,
    provider: '<string>',
    routing: {
      allow_fallbacks: true,
      only: ['<string>'],
      order: ['<string>'],
      strategy: 'auto'
    },
    start: '2023-12-25'
  })
};

fetch('https://api.agentkey.app/v2/ops/finance.price.history', 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.agentkey.app/v2/ops/finance.price.history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'symbol' => '<string>',
    'end' => '2023-12-25',
    'fields' => [
        '<string>'
    ],
    'include_raw' => false,
    'interval' => '1d',
    'limit' => 100,
    'provider' => '<string>',
    'routing' => [
        'allow_fallbacks' => true,
        'only' => [
                '<string>'
        ],
        'order' => [
                '<string>'
        ],
        'strategy' => 'auto'
    ],
    'start' => '2023-12-25'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.agentkey.app/v2/ops/finance.price.history"

	payload := strings.NewReader("{\n  \"symbol\": \"<string>\",\n  \"end\": \"2023-12-25\",\n  \"fields\": [\n    \"<string>\"\n  ],\n  \"include_raw\": false,\n  \"interval\": \"1d\",\n  \"limit\": 100,\n  \"provider\": \"<string>\",\n  \"routing\": {\n    \"allow_fallbacks\": true,\n    \"only\": [\n      \"<string>\"\n    ],\n    \"order\": [\n      \"<string>\"\n    ],\n    \"strategy\": \"auto\"\n  },\n  \"start\": \"2023-12-25\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.agentkey.app/v2/ops/finance.price.history")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"symbol\": \"<string>\",\n  \"end\": \"2023-12-25\",\n  \"fields\": [\n    \"<string>\"\n  ],\n  \"include_raw\": false,\n  \"interval\": \"1d\",\n  \"limit\": 100,\n  \"provider\": \"<string>\",\n  \"routing\": {\n    \"allow_fallbacks\": true,\n    \"only\": [\n      \"<string>\"\n    ],\n    \"order\": [\n      \"<string>\"\n    ],\n    \"strategy\": \"auto\"\n  },\n  \"start\": \"2023-12-25\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentkey.app/v2/ops/finance.price.history")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"symbol\": \"<string>\",\n  \"end\": \"2023-12-25\",\n  \"fields\": [\n    \"<string>\"\n  ],\n  \"include_raw\": false,\n  \"interval\": \"1d\",\n  \"limit\": 100,\n  \"provider\": \"<string>\",\n  \"routing\": {\n    \"allow_fallbacks\": true,\n    \"only\": [\n      \"<string>\"\n    ],\n    \"order\": [\n      \"<string>\"\n    ],\n    \"strategy\": \"auto\"\n  },\n  \"start\": \"2023-12-25\"\n}"

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

{
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "credits_charged": 123,
  "data": {
    "items": [
      {
        "adjusted_close": 123,
        "close": 123,
        "high": 123,
        "low": 123,
        "open": 123,
        "time": "2023-11-07T05:31:56Z",
        "volume": 123
      }
    ],
    "next_cursor": "<string>"
  },
  "op": "<string>",
  "op_version": 123,
  "provider": "<string>",
  "request_id": "<string>",
  "took_ms": 123,
  "unsupported_fields": [
    "<string>"
  ],
  "raw": "<unknown>",
  "raw_truncated": true
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

Authorizations

Authorization

string

header

required

AgentKey API key (ak_…).

Body

application/json

symbol

string

required

Ticker: AAPL, 0700.HK, 600519.SH, 000001.SZ.

end

string<date>

Latest bar date, YYYY-MM-DD (inclusive); default today.

fields

string[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

include_raw

boolean

default:false

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

interval

enum<string>

default:1d

Bar size.

Available options:

1d,

1wk,

1mo

limit

integer

default:100

Maximum number of bars to return.

Required range: 1 <= x <= 500

provider

string

Shorthand for routing.only = [provider].

routing

object

Provider routing override. order: try these providers first; only: restrict to these (equivalent to pinning); allow_fallbacks: false tries only the first eligible provider.

Show child attributes

start

string<date>

Earliest bar date, YYYY-MM-DD. Required for every market except A-shares and Hong Kong daily bars.

Response

Success envelope

Success envelope whose data is a CandlePage.

attempts

object[]

required

Show child attributes

credits_charged

number

required

Credits charged for this call (the method's fixed price).

data

object

required

One page of OHLCV bars, most recent first.

Show child attributes

string

required

Method name.

op_version

integer

required

Method version that served the call.

provider

string

required

Provider that actually served the call.

request_id

string

required

Correlation id; quote it in support requests.

took_ms

integer

required

unsupported_fields

string[]

required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

raw

any

Upstream payload, only with include_raw=true. Not a stable contract.

raw_truncated

boolean

Daily, weekly or monthly OHLCV bars for a stock, ETF or index. Returns a normalized Candle page.

curl --request POST \
  --url https://api.agentkey.app/v2/ops/finance.price.history \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "symbol": "<string>",
  "end": "2023-12-25",
  "fields": [
    "<string>"
  ],
  "include_raw": false,
  "interval": "1d",
  "limit": 100,
  "provider": "<string>",
  "routing": {
    "allow_fallbacks": true,
    "only": [
      "<string>"
    ],
    "order": [
      "<string>"
    ],
    "strategy": "auto"
  },
  "start": "2023-12-25"
}
'

import requests

url = "https://api.agentkey.app/v2/ops/finance.price.history"

payload = {
    "symbol": "<string>",
    "end": "2023-12-25",
    "fields": ["<string>"],
    "include_raw": False,
    "interval": "1d",
    "limit": 100,
    "provider": "<string>",
    "routing": {
        "allow_fallbacks": True,
        "only": ["<string>"],
        "order": ["<string>"],
        "strategy": "auto"
    },
    "start": "2023-12-25"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    symbol: '<string>',
    end: '2023-12-25',
    fields: ['<string>'],
    include_raw: false,
    interval: '1d',
    limit: 100,
    provider: '<string>',
    routing: {
      allow_fallbacks: true,
      only: ['<string>'],
      order: ['<string>'],
      strategy: 'auto'
    },
    start: '2023-12-25'
  })
};

fetch('https://api.agentkey.app/v2/ops/finance.price.history', 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.agentkey.app/v2/ops/finance.price.history",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'symbol' => '<string>',
    'end' => '2023-12-25',
    'fields' => [
        '<string>'
    ],
    'include_raw' => false,
    'interval' => '1d',
    'limit' => 100,
    'provider' => '<string>',
    'routing' => [
        'allow_fallbacks' => true,
        'only' => [
                '<string>'
        ],
        'order' => [
                '<string>'
        ],
        'strategy' => 'auto'
    ],
    'start' => '2023-12-25'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://api.agentkey.app/v2/ops/finance.price.history"

	payload := strings.NewReader("{\n  \"symbol\": \"<string>\",\n  \"end\": \"2023-12-25\",\n  \"fields\": [\n    \"<string>\"\n  ],\n  \"include_raw\": false,\n  \"interval\": \"1d\",\n  \"limit\": 100,\n  \"provider\": \"<string>\",\n  \"routing\": {\n    \"allow_fallbacks\": true,\n    \"only\": [\n      \"<string>\"\n    ],\n    \"order\": [\n      \"<string>\"\n    ],\n    \"strategy\": \"auto\"\n  },\n  \"start\": \"2023-12-25\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.agentkey.app/v2/ops/finance.price.history")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"symbol\": \"<string>\",\n  \"end\": \"2023-12-25\",\n  \"fields\": [\n    \"<string>\"\n  ],\n  \"include_raw\": false,\n  \"interval\": \"1d\",\n  \"limit\": 100,\n  \"provider\": \"<string>\",\n  \"routing\": {\n    \"allow_fallbacks\": true,\n    \"only\": [\n      \"<string>\"\n    ],\n    \"order\": [\n      \"<string>\"\n    ],\n    \"strategy\": \"auto\"\n  },\n  \"start\": \"2023-12-25\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.agentkey.app/v2/ops/finance.price.history")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"symbol\": \"<string>\",\n  \"end\": \"2023-12-25\",\n  \"fields\": [\n    \"<string>\"\n  ],\n  \"include_raw\": false,\n  \"interval\": \"1d\",\n  \"limit\": 100,\n  \"provider\": \"<string>\",\n  \"routing\": {\n    \"allow_fallbacks\": true,\n    \"only\": [\n      \"<string>\"\n    ],\n    \"order\": [\n      \"<string>\"\n    ],\n    \"strategy\": \"auto\"\n  },\n  \"start\": \"2023-12-25\"\n}"

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

{
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "credits_charged": 123,
  "data": {
    "items": [
      {
        "adjusted_close": 123,
        "close": 123,
        "high": 123,
        "low": 123,
        "open": 123,
        "time": "2023-11-07T05:31:56Z",
        "volume": 123
      }
    ],
    "next_cursor": "<string>"
  },
  "op": "<string>",
  "op_version": 123,
  "provider": "<string>",
  "request_id": "<string>",
  "took_ms": 123,
  "unsupported_fields": [
    "<string>"
  ],
  "raw": "<unknown>",
  "raw_truncated": true
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

{
  "code": 123,
  "error": "<string>",
  "error_type": "<string>",
  "attempts": [
    {
      "provider": "<string>",
      "status": 123,
      "took_ms": 123,
      "tool": "<string>",
      "error_type": "<string>",
      "refunded": true,
      "upstream_status": 123
    }
  ],
  "op": "<string>",
  "request_id": "<string>"
}

Overview

Scenario Methods

Catalog & Describe

Methods

Tool Catalog (MCP)

finance.price.history

Authorizations

Body

Response