Skip to content

Historical.metadata.get_cost

POST/v0/metadata.get_costPython · HTTP

The cost of a request in US dollars: always 0. The cloud API is free, with limits: 60 requests a minute and 2 GB a day per identity, and 120 requests a minute and 4 GB a day per IP address.

Parameters

dataset str required

XTKS.BRISK (your own live recordings) or XTKS.BRISKDEMO (the public demo, open to every identity).

start str | int | date required

The inclusive start. An ISO 8601 time (JST unless it names a zone), a date (that trading day, from JST midnight) or UTC nanoseconds.

end str | int | date | None optional

The exclusive end, in the same forms. Default: the end of the start's trading day. At most 31 days after start; both between 2000 and 2100.

symbols Iterable[str] | str optional = "ALL_SYMBOLS"

Up to 2,000 JPX codes ("7203", "167A"), as a list or comma-separated. Default "ALL_SYMBOLS".

schema str optional = "trades"

trades (default), mbp-10, definition, imbalance, brisk-quotes or ohlcv-1s, ohlcv-1m, ohlcv-1h, ohlcv-1d. See Data format.

Returns

float

0.0.

API method
Historical.metadata.get_cost(
    dataset: str,
    start: str | int | date,
    end: str | int | date | None = None,
    symbols: Iterable[str] | str = "ALL_SYMBOLS",
    schema: str = "trades",
) -> float
Example usage
1
2
3
4
import briskapi

client = briskapi.Historical()
print(client.metadata.get_cost(dataset="XTKS.BRISKDEMO", start="2021-09-27"))

1
2
3
4
5
export BRISK_KEY=$(brisk identity --export)   # your archive identity is the API key
curl -X POST 'https://h2dxahfcj6436nlf3y255exu6e0omhrk.lambda-url.ap-northeast-1.on.aws/v0/metadata.get_cost' \
  -u "$BRISK_KEY:" \
  -d dataset=XTKS.BRISKDEMO \
  -d start=2021-09-27
Example responseCaptured from the demo
0.0

0.0