TanukiTradeDocs

Technical

Price change, realized volatility, and daily bars.

Today’s price with its point and percent change, close-to-close volatility, and regular-session OHLCV.

The current price-change row is intraday and refreshes with the screener: spot_price, change_pts, change_pct, and snapshot_at. A future uses its own last price, rounded to the contract tick. XSP is one tenth of SPX, with no tick rounding. change_pts stays at most 4 decimals, with no tick rounding. change_pct is rounded to 4 decimal places. Realized volatility is as of the last completed session and updates after 16:00 ET. atr_14_pct and bb_bandwidth_20_pct are rounded to 4 decimal places. The current realized-volatility row uses snapshot_date. The current price-change row uses snapshot_at.

technical/ohlcv needs one symbol. end_date is an inclusive ET day and defaults to today; a later date is 422. Rows are newest day first, 100 per page. Today is included when a regular bar exists, and is usually absent before 09:30 ET. session_complete is false on today’s row before 16:00 ET. open, high, low, and close are prices. A mapped future rounds each to the contract tick. XSP and a listed symbol stay at most 4 decimals. A future uses that day’s conversion factor. XSP uses 0.1. volume is set on a listed stock or ETF and is null on an index and on every synthetic.

Support window: the live routes on this page are supported on NYSE trading days from 06:40 through 16:00 ET. Outside that window, on weekends, on holidays, and during maintenance, they still answer with the last snapshot, but that answer is not meant for trading decisions, and we do not investigate differences from the webapp outside the window. The history routes are supported at any time. Details: data clock.

1 / 3

Price change

POST/api/v1/technical/price-changeMCP list_technical_price_change

Lists the latest price and the change from the previous close. spot_price is the price at snapshot_at. A mapped future rounds spot_price to the contract tick. change_pts is points, at most 4 decimal places, with no tick rounding. change_pct is percent, rounded to 4 decimal places. sort is symbol or abs_change_pct. limit is 1 to 261. The MCP tool is list_technical_price_change. The arguments are this same JSON body. The bearer token stays on the HTTP header.

Parameters · Price change

NameTypeRequiredValues
symbolsarray of stringsNoUp to 300 tickers. Unknown names are left out. Order in the response is symbol ascending.
sortstringNosymbol (default) or abs_change_pct.
limitintegerNo1 to 261. Omit it for the page size, which is still 400.
cursorstringNoPrevious meta.next_cursor. Omit it on the first page.

Page size is fixed at 400 rows. The caller does not set it.

Valid bodies, from the minimal to the one the sample answers:

  • {}
  • {"symbols":["SPX","QQQ"],"sort":"symbol","limit":5}
curl
curl --compressed \
  --request POST \
  --url "${TANUKI_BASE_URL}/api/v1/technical/price-change" \
  --header "Authorization: Bearer 12345.YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --data '{"symbols":["SPX","QQQ"],"sort":"symbol","limit":5}'

Live builder output for the request in this file. The row list was short enough to keep. built_at is the builder health clock of this capture.

200 application/json
{
  "ok": true,
  "data": {
    "items": [
      {
        "symbol": "QQQ",
        "type": "ETF",
        "is_synthetic": false,
        "mapped_from": null,
        "session_complete": false,
        "spot_price": 725.32,
        "change_pts": 7.79,
        "change_pct": 1.09,
        "snapshot_at": "2026-10-21T16:01:20.000-04:00"
      },
      {
        "symbol": "SPX",
        "type": "INDEX",
        "is_synthetic": false,
        "mapped_from": null,
        "session_complete": false,
        "spot_price": 7759.51,
        "change_pts": 42.48,
        "change_pct": 0.55,
        "snapshot_at": "2026-10-21T16:01:20.000-04:00"
      }
    ]
  },
  "meta": {
    "request": {
      "symbols": [
        "QQQ",
        "SPX"
      ],
      "sort": "symbol",
      "limit": 5
    },
    "count": 2,
    "total": 2,
    "page": 1,
    "page_count": 1,
    "next_cursor": null,
    "generation": "5c246baa69d6",
    "as_of": {},
    "built_at": "2026-10-23T01:08:02-04:00",
    "omitted": [],
    "docs": {
      "reference": "https://tanukitrade.com/docs/api/technical#list_technical_price_change",
      "glossary": "https://tanukitrade.com/docs/api/glossary"
    }
  }
}

Response fields · Price change

FieldTypeMeaning
symbolstringCanonical ticker. Copy it from list_symbols. Letter case folds to uppercase.
typestringSTOCK, ETF, INDEX, FUTURES, or CFD_CRYPTO.
is_syntheticbooleanTrue when the ticker is mapped from another symbol. False is a listed underlying.
mapped_fromstring or nullThe symbol a synthetic is mapped from. Null on a listed underlying. A micro names the optionable base, not its parent future.
session_completebooleanTrue when that ET session is closed. On daily OHLCV, today's row is false before 16:00 ET.
spot_pricenumber or nullPrice at snapshot_at. Futures use their own last price, rounded to the contract tick. XSP is one tenth of SPX, with no tick rounding. Null when the source has no price. A listed symbol stays at most 4 decimal places.
change_ptsnumber or nullPoint change from the previous close, at most 4 decimal places.
change_pctnumber or nullPercent change from the previous close, rounded to 4 decimal places.
snapshot_atdatetime ET or nullQuote time, ISO 8601 with an ET offset, or null when the source has no time.

Errors on this route · Price change

HTTPCodeWhen
422VALIDATION_ERRORUnknown field, nested value, repeated key, bad JSON, a bad alias, or a cursor that does not match this request.
413PAYLOAD_TOO_LARGEThe JSON body is larger than 4 KiB.
503DATA_WARMINGThe datapoint is not built yet. Wait Retry-After seconds (1).
422RESULT_TOO_LARGEThe uncompressed JSON would exceed 512 KiB. Narrow the filter.

Auth, rate limit, and the other shared failures are on Errors.

2 / 3

Realized volatility

POST/api/v1/technical/realized-volatilityMCP list_technical_realized_volatility

Lists close-to-close HV, Parkinson, ATR percent, Bollinger percent-b and bandwidth, and iv_hv_spread_30_vol_pts. hv and parkinson fields are annualized volatility in percent. bb_percent_b_20 is a fraction from 0 to 1. iv_hv_ratio_30 is a ratio, not a percent. The current row is the last completed session. The MCP tool is list_technical_realized_volatility. The arguments are this same JSON body. The bearer token stays on the HTTP header.

Parameters · Realized volatility

NameTypeRequiredValues
symbolsarray of stringsNoUp to 300 tickers. Unknown names are left out. Order in the response is symbol ascending.
cursorstringNoPrevious meta.next_cursor. Omit it on the first page.

Page size is fixed at 400 rows. The caller does not set it.

Valid bodies, from the minimal to the one the sample answers:

  • {}
  • {"symbols":["SPX"]}
curl
curl --compressed \
  --request POST \
  --url "${TANUKI_BASE_URL}/api/v1/technical/realized-volatility" \
  --header "Authorization: Bearer 12345.YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --data '{"symbols":["SPX"]}'

Live builder output for the request in this file. The row list was short enough to keep. built_at is the builder health clock of this capture.

200 application/json
{
  "ok": true,
  "data": {
    "items": [
      {
        "symbol": "SPX",
        "type": "INDEX",
        "is_synthetic": false,
        "mapped_from": null,
        "snapshot_date": "2026-10-21",
        "session_complete": true,
        "hv_10d": 9.95,
        "hv_20d": 8.85,
        "hv_30d": 10.07,
        "hv_60d": 10.4,
        "parkinson_20d": 7.99,
        "atr_14_pct": 0.8963,
        "bb_percent_b_20": 0.6051,
        "bb_bandwidth_20_pct": 2.7843,
        "iv_hv_spread_30_vol_pts": 6.78,
        "iv_hv_ratio_30": 1.6733
      }
    ]
  },
  "meta": {
    "request": {
      "symbols": [
        "SPX"
      ]
    },
    "count": 1,
    "total": 1,
    "page": 1,
    "page_count": 1,
    "next_cursor": null,
    "generation": "07cc6709c6cf",
    "as_of": {},
    "built_at": "2026-10-23T01:08:02-04:00",
    "omitted": [],
    "docs": {
      "reference": "https://tanukitrade.com/docs/api/technical#list_technical_realized_volatility",
      "glossary": "https://tanukitrade.com/docs/api/glossary"
    }
  }
}

Response fields · Realized volatility

FieldTypeMeaning
symbolstringCanonical ticker. Copy it from list_symbols. Letter case folds to uppercase.
typestringSTOCK, ETF, INDEX, FUTURES, or CFD_CRYPTO.
is_syntheticbooleanTrue when the ticker is mapped from another symbol. False is a listed underlying.
mapped_fromstring or nullThe symbol a synthetic is mapped from. Null on a listed underlying. A micro names the optionable base, not its parent future.
snapshot_datedateET session of the row, YYYY-MM-DD.
session_completebooleanTrue when that ET session is closed. On daily OHLCV, today's row is false before 16:00 ET.
hv_10dnumber or null10-day close-to-close historical volatility, annualized volatility in percent. Rounded to 4 decimal places.
hv_20dnumber or null20-day close-to-close HV, annualized volatility in percent. Rounded to 4 decimal places.
hv_30dnumber or null30-day close-to-close HV, annualized volatility in percent. Rounded to 4 decimal places.
hv_60dnumber or null60-day close-to-close HV, annualized volatility in percent. Rounded to 4 decimal places.
parkinson_20dnumber or null20-day Parkinson volatility, annualized volatility in percent. Rounded to 4 decimal places.
atr_14_pctnumber or null14-day ATR as a percent, rounded to 4 decimal places. Not a price.
bb_percent_b_20number or null20-day Bollinger percent-b, a fraction from 0 to 1, not a percent. Rounded to 4 decimal places.
bb_bandwidth_20_pctnumber or null20-day Bollinger bandwidth, percent, rounded to 4 decimal places.
iv_hv_spread_30_vol_ptsnumber or nullIVx minus 30-day HV, in annualized volatility percentage points. Rounded to 4 decimal places.
iv_hv_ratio_30number or nullIVx divided by 30-day HV, a ratio (1.5 means 1.5 times), not a percent. Rounded to 4 decimal places.

Errors on this route · Realized volatility

HTTPCodeWhen
422VALIDATION_ERRORUnknown field, nested value, repeated key, bad JSON, a bad alias, or a cursor that does not match this request.
413PAYLOAD_TOO_LARGEThe JSON body is larger than 4 KiB.
503DATA_WARMINGThe datapoint is not built yet. Wait Retry-After seconds (1).
422RESULT_TOO_LARGEThe uncompressed JSON would exceed 512 KiB. Narrow the filter.

Auth, rate limit, and the other shared failures are on Errors.

3 / 3

Daily OHLCV

POST/api/v1/technical/ohlcvMCP list_technical_ohlcv

Lists daily open, high, low, close, and volume for one symbol. end_date defaults to today ET and is inclusive. A later date is rejected. Rows are newest day first. volume is a share count on a listed STOCK or ETF and null on INDEX and on every synthetic, including futures and XSP. A future price uses that day's conversion factor. XSP uses 0.1. The MCP tool is list_technical_ohlcv. The arguments are this same JSON body. The bearer token stays on the HTTP header.

Parameters · Daily OHLCV

NameTypeRequiredValues
symbolstringYesOne ticker. Required. Letter case folds to uppercase.
end_datestringNoOne ET day, YYYY-MM-DD, inclusive. Omit it for today ET. A later date is rejected.
cursorstringNoPrevious meta.next_cursor. Omit it on the first page.

Page size is fixed at 100 rows. The caller does not set it.

Valid bodies, from the minimal to the one the sample answers:

  • {"symbol":"SPY"}
  • {"symbol":"SPY","end_date":"2026-10-21"}
curl
curl --compressed \
  --request POST \
  --url "${TANUKI_BASE_URL}/api/v1/technical/ohlcv" \
  --header "Authorization: Bearer 12345.YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --data '{"symbol":"SPY","end_date":"2026-10-21"}'

Live builder output for the request in this file. The row list was short enough to keep. built_at is the builder health clock of this capture.

200 application/json
{
  "ok": true,
  "data": {
    "items": [
      {
        "symbol": "SPY",
        "type": "ETF",
        "is_synthetic": false,
        "mapped_from": null,
        "snapshot_date": "2026-10-21",
        "session_complete": true,
        "open": 670.12,
        "high": 675.5,
        "low": 668.4,
        "close": 674.25,
        "volume": 51234567
      }
    ]
  },
  "meta": {
    "request": {
      "symbol": "SPY",
      "end_date": "2026-10-21"
    },
    "count": 1,
    "total": 1,
    "page": 1,
    "page_count": 1,
    "next_cursor": null,
    "generation": "07cc6709c6cf",
    "as_of": {},
    "built_at": "2026-10-23T01:08:02-04:00",
    "omitted": [],
    "docs": {
      "reference": "https://tanukitrade.com/docs/api/technical#list_technical_ohlcv",
      "glossary": "https://tanukitrade.com/docs/api/glossary"
    }
  }
}

Response fields · Daily OHLCV

FieldTypeMeaning
symbolstringCanonical ticker. Copy it from list_symbols. Letter case folds to uppercase.
typestringSTOCK, ETF, INDEX, FUTURES, or CFD_CRYPTO.
is_syntheticbooleanTrue when the ticker is mapped from another symbol. False is a listed underlying.
mapped_fromstring or nullThe symbol a synthetic is mapped from. Null on a listed underlying. A micro names the optionable base, not its parent future.
snapshot_datedateET session of the row, YYYY-MM-DD.
session_completebooleanFalse on today's row before 16:00 ET. True once that session has closed.
opennumber or nullRegular-session open, A mapped future is rounded to the contract tick. XSP and a listed symbol stay at most 4 decimal places, with no tick rounding. A future uses the conversion factor of the row's ET day. XSP uses 0.1.
highnumber or nullRegular-session high, A mapped future is rounded to the contract tick. XSP and a listed symbol stay at most 4 decimal places, with no tick rounding. Scaled the same way as open.
lownumber or nullRegular-session low, A mapped future is rounded to the contract tick. XSP and a listed symbol stay at most 4 decimal places, with no tick rounding. Scaled the same way as open.
closenumber or nullRegular-session close, A mapped future is rounded to the contract tick. XSP and a listed symbol stay at most 4 decimal places, with no tick rounding. Scaled the same way as open.
volumeinteger or nullShare count on a listed STOCK or ETF. Null on INDEX and on every synthetic, including futures and XSP. A measured zero stays 0.

Errors on this route · Daily OHLCV

HTTPCodeWhen
422VALIDATION_ERRORUnknown field, nested value, repeated key, bad JSON, a bad date, a date after today ET, or a cursor that does not match this request.
422UNKNOWN_SYMBOLThe ticker is not visible. Call list_symbols.
413PAYLOAD_TOO_LARGEThe JSON body is larger than 4 KiB.
503DATA_WARMINGThe datapoint is not built yet. Wait Retry-After seconds (1).
422RESULT_TOO_LARGEThe uncompressed JSON would exceed 512 KiB. Narrow the filter.

Auth, rate limit, and the other shared failures are on Errors.

TanukiTrade API and MCP. Derived options analytics for your code and for agents. Not investment advice. tanukitrade.com