Symbols, expiries, and the glossary.

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

{
  "ok": true,
  "data": {
    "items": [
      {
        "symbol": "/ES1",
        "type": "FUTURES",
        "is_synthetic": true,
        "mapped_from": "SPX"
      },
      {
        "symbol": "AAPL",
        "type": "STOCK",
        "is_synthetic": false,
        "mapped_from": null
      },
      {
        "symbol": "SPX",
        "type": "INDEX",
        "is_synthetic": false,
        "mapped_from": null
      }
    ]
  },
  "meta": {
    "request": {
      "symbols": [
        "/ES1",
        "AAPL",
        "SPX"
      ]
    },
    "count": 3,
    "total": 3,
    "page": 1,
    "page_count": 1,
    "next_cursor": null,
    "generation": "04642afa2dbe",
    "as_of": {},
    "built_at": "2026-10-23T01:08:02-04:00",
    "omitted": [],
    "docs": {
      "reference": "https://tanukitrade.com/docs/api/discovery#list_symbols",
      "glossary": "https://tanukitrade.com/docs/api/glossary"
    }
  }
}

curl --compressed \
  --request POST \
  --url "${TANUKI_BASE_URL}/api/v1/discovery/expiries" \
  --header "Authorization: Bearer 12345.YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --data '{"symbol":"SPX"}'

{
  "ok": true,
  "data": {
    "items": [
      {
        "expiration_date": "2026-10-23",
        "dte": 0,
        "aliases": [
          "0",
          "w1"
        ],
        "is_monthly": false
      },
      {
        "expiration_date": "2026-10-26",
        "dte": 3,
        "aliases": [
          "1"
        ],
        "is_monthly": false
      },
      {
        "expiration_date": "2026-10-27",
        "dte": 4,
        "aliases": [],
        "is_monthly": false
      },
      "..."
    ]
  },
  "meta": {
    "request": {
      "symbol": "SPX"
    },
    "count": 52,
    "total": 52,
    "page": 1,
    "page_count": 1,
    "next_cursor": null,
    "generation": "934247a0818e",
    "as_of": {
      "chain": "2026-10-21T16:01:54.082-04:00",
      "secondary": "2026-10-21T15:59:05-04:00"
    },
    "built_at": "2026-10-23T01:08:02-04:00",
    "omitted": [],
    "docs": {
      "reference": "https://tanukitrade.com/docs/api/discovery#list_expiries",
      "glossary": "https://tanukitrade.com/docs/api/glossary"
    }
  }
}

curl --compressed \
  --request POST \
  --url "${TANUKI_BASE_URL}/api/v1/discovery/glossary" \
  --header "Authorization: Bearer 12345.YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --data '{"terms":["P1","HVL","cT"]}'

{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "P1",
        "name": "P1",
        "family": "Labels",
        "summary": "Put support: the primary put wall, the strongest negative net-GEX strike.",
        "definition": "P1 is the largest put-side gamma wall. Dealers hedging a put-dominated strike often lean against downside through that strike, so it is read as structural support. It is the first label in the primary order P1, pT, HVL, cT, C1.",
        "how_to_read": "On an unbroken profile P1 is at or below pT. Spot at or below P1 is the NEG_SQUEEZE state. weight, when present, is the signed normalized size and is negative on a put wall.",
        "related": [
          "pT",
          "P2",
          "NEG_SQUEEZE",
          "norm"
        ],
        "learn_url": "https://tanukitrade.com/docs/learn/walls"
      },
      {
        "id": "HVL",
        "name": "HVL",
        "family": "Labels",
        "summary": "High Volatility Level: the structural pivot inside the transition zone.",
        "definition": "HVL marks the steepest change in the net-GEX profile, inside the band pT ≤ HVL ≤ cT. It is the reference Tanuki uses instead of a single gamma-flip price. The knowledge base also titles this level Highest Volatility Level; the Learn page and this glossary use High Volatility Level for the same strike. Below HVL, dealer hedging is read as tending to amplify moves. Above HVL, it is read as tending to dampen them. That is a tendency, not a forecast.",
        "how_to_read": "Require pT ≤ HVL ≤ cT before you trust the zone. Spot at or above HVL and still below cT is POS_TRANSITION. Spot below HVL and still above pT is NEG_TRANSITION.",
        "related": [
          "pT",
          "cT",
          "transition-zone",
          "POS_TRANSITION",
          "NEG_TRANSITION"
        ],
        "learn_url": "https://tanukitrade.com/docs/learn/hvl"
      },
      {
        "id": "cT",
        "name": "cT",
        "family": "Labels",
        "summary": "Call transition (cTrans): the upper boundary of the transition zone.",
        "definition": "cT is the upper edge of the band that contains HVL. Above cT the net-GEX structure is read as positive-gamma territory. The label is cT; the same level is cTrans in the classification text.",
        "how_to_read": "An unbroken profile keeps cT between HVL and C1, inclusive. Spot above cT and still below C1 is POS. Spot at or above C1 (and at or above cT) is POS_SQUEEZE.",
        "related": [
          "HVL",
          "C1",
          "transition-zone",
          "POS"
        ],
        "learn_url": "https://tanukitrade.com/docs/learn/walls"
      }
    ]
  },
  "meta": {
    "request": {
      "terms": [
        "P1",
        "HVL",
        "cT"
      ]
    },
    "count": 3,
    "docs": {
      "reference": "https://tanukitrade.com/docs/api/glossary",
      "glossary": "https://tanukitrade.com/docs/api/glossary"
    }
  }
}