# info.description
Read-only dataset discovery, schema inspection, structured queries, and version-pinned exports. Kappa is available to approved private-preview accounts.

# externalDocs.description
Human and LLM-readable integration guide

# paths./datasets.get.description
Search the datasets visible to the key. The catalog is large and alphabetically paged, so search by name or label instead of walking every page.

# paths./datasets.get.parameters[].description
Search dataset names and human labels. For example, q=apple matches us-eq-aapl-1d.

# paths./datasets.get.parameters[].description
Optional family filter: equity, intl, futures, fx, crypto, fundamentals, options, news, positioning, or macro.

# paths./datasets.get.responses.200.headers.X-Has-More.description
Whether another raw catalog row exists after this page.

# paths./datasets.get.responses.400.description
The request asks for unsupported semantics, such as as_of on a dataset that does not declare point-in-time support.

# paths./datasets.get.responses.401.description
The bearer key is missing, malformed, expired, revoked, or unknown.

# paths./datasets.get.responses.402.description
The monthly distinct-dataset export meter is exhausted.

# paths./datasets.get.responses.403.description
The account is not entitled to Data API access, or the key's source-CIDR policy denies the trusted client address.

# paths./datasets.get.responses.404.description
The dataset does not exist or is outside this key's scope. Private datasets are concealed rather than disclosed with 403.

# paths./datasets.get.responses.413.description
The preview is too large, or a CSV query matches more than 1,000,000 rows. Narrow the query or use Parquet export.

# paths./datasets.get.responses.422.description
One or more parameters failed validation.

# paths./datasets.get.responses.429.description
The per-key request budget is spent. Wait for Retry-After, then retry.

# paths./datasets.get.responses.503.description
A transient fail-closed service guard rejected the request. Retry with backoff.

# paths./datasets/{name}/preview.get.description
Return a render-ready sample as line points, candles, or table rows. Use schema or query when a dataset is too large to preview.

# paths./datasets/{name}/preview.get.parameters[].description
Pinned dataset version. Omit to use the latest version.

# paths./datasets/{name}/preview.get.parameters[].description
Requested preview density. Values are safely clamped to 10–2,000 points.

# paths./datasets/{name}/preview.get.responses.400.description
The request asks for unsupported semantics, such as as_of on a dataset that does not declare point-in-time support.

# paths./datasets/{name}/preview.get.responses.401.description
The bearer key is missing, malformed, expired, revoked, or unknown.

# paths./datasets/{name}/preview.get.responses.402.description
The monthly distinct-dataset export meter is exhausted.

# paths./datasets/{name}/preview.get.responses.403.description
The account is not entitled to Data API access, or the key's source-CIDR policy denies the trusted client address.

# paths./datasets/{name}/preview.get.responses.404.description
The dataset does not exist or is outside this key's scope. Private datasets are concealed rather than disclosed with 403.

# paths./datasets/{name}/preview.get.responses.413.description
The preview is too large, or a CSV query matches more than 1,000,000 rows. Narrow the query or use Parquet export.

# paths./datasets/{name}/preview.get.responses.422.description
One or more parameters failed validation.

# paths./datasets/{name}/preview.get.responses.429.description
The per-key request budget is spent. Wait for Retry-After, then retry.

# paths./datasets/{name}/preview.get.responses.503.description
A transient fail-closed service guard rejected the request. Retry with backoff.

# paths./datasets/{name}/schema.get.description
Read columns, dtypes, coverage, detected time and symbol fields, and the producer-declared capability contract before querying rows.

# paths./datasets/{name}/schema.get.parameters[].description
Pinned dataset version. Omit to use the latest version.

# paths./datasets/{name}/schema.get.responses.400.description
The request asks for unsupported semantics, such as as_of on a dataset that does not declare point-in-time support.

# paths./datasets/{name}/schema.get.responses.401.description
The bearer key is missing, malformed, expired, revoked, or unknown.

# paths./datasets/{name}/schema.get.responses.402.description
The monthly distinct-dataset export meter is exhausted.

# paths./datasets/{name}/schema.get.responses.403.description
The account is not entitled to Data API access, or the key's source-CIDR policy denies the trusted client address.

# paths./datasets/{name}/schema.get.responses.404.description
The dataset does not exist or is outside this key's scope. Private datasets are concealed rather than disclosed with 403.

# paths./datasets/{name}/schema.get.responses.413.description
The preview is too large, or a CSV query matches more than 1,000,000 rows. Narrow the query or use Parquet export.

# paths./datasets/{name}/schema.get.responses.422.description
One or more parameters failed validation.

# paths./datasets/{name}/schema.get.responses.429.description
The per-key request budget is spent. Wait for Retry-After, then retry.

# paths./datasets/{name}/schema.get.responses.503.description
A transient fail-closed service guard rejected the request. Retry with backoff.

# paths./datasets/{name}/query.get.description
Apply structured filters and column projection. This is not a SQL endpoint. JSON is paginated; CSV is complete-or-rejected up to 1,000,000 matching rows.

# paths./datasets/{name}/query.get.parameters[].description
Pinned dataset version. Omit to use the latest version.

# paths./datasets/{name}/query.get.parameters[].description
Exact symbol filter when the schema declares a symbol column.

# paths./datasets/{name}/query.get.parameters[].description
Inclusive lower bound on the dataset's effective date field.

# paths./datasets/{name}/query.get.parameters[].description
Inclusive upper bound on the dataset's effective date field.

# paths./datasets/{name}/query.get.parameters[].description
Point-in-time knowledge bound. Use only when schema.capabilities.point_in_time_supported is true; unsupported datasets return 400.

# paths./datasets/{name}/query.get.parameters[].description
For JSON, keep the newest bounded window instead of the oldest one. CSV is already the complete filtered result.

# paths./datasets/{name}/query.get.parameters[].description
JSON returns a bounded page. CSV returns the complete filtered result or rejects it before sending partial bytes.

# paths./datasets/{name}/query.get.responses.200.description
A JSON row page or a complete CSV response.

# paths./datasets/{name}/query.get.responses.400.description
The request asks for unsupported semantics, such as as_of on a dataset that does not declare point-in-time support.

# paths./datasets/{name}/query.get.responses.401.description
The bearer key is missing, malformed, expired, revoked, or unknown.

# paths./datasets/{name}/query.get.responses.402.description
The monthly distinct-dataset export meter is exhausted.

# paths./datasets/{name}/query.get.responses.403.description
The account is not entitled to Data API access, or the key's source-CIDR policy denies the trusted client address.

# paths./datasets/{name}/query.get.responses.404.description
The dataset does not exist or is outside this key's scope. Private datasets are concealed rather than disclosed with 403.

# paths./datasets/{name}/query.get.responses.413.description
The preview is too large, or a CSV query matches more than 1,000,000 rows. Narrow the query or use Parquet export.

# paths./datasets/{name}/query.get.responses.422.description
One or more parameters failed validation.

# paths./datasets/{name}/query.get.responses.429.description
The per-key request budget is spent. Wait for Retry-After, then retry.

# paths./datasets/{name}/query.get.responses.503.description
A transient fail-closed service guard rejected the request. Retry with backoff.

# paths./datasets/{name}/export.get.description
Mint a short-lived URL for the immutable Parquet artifact. Download the URL without an Authorization header and verify its SHA-256 checksum.

# paths./datasets/{name}/export.get.parameters[].description
Pinned dataset version. Omit to use the latest version.

# paths./datasets/{name}/export.get.parameters[].description
Do not send this parameter. The endpoint returns 400 rather than silently exporting unfiltered history; use /query with as_of.

# paths./datasets/{name}/export.get.responses.400.description
The request asks for unsupported semantics, such as as_of on a dataset that does not declare point-in-time support.

# paths./datasets/{name}/export.get.responses.401.description
The bearer key is missing, malformed, expired, revoked, or unknown.

# paths./datasets/{name}/export.get.responses.402.description
The monthly distinct-dataset export meter is exhausted.

# paths./datasets/{name}/export.get.responses.403.description
The account is not entitled to Data API access, or the key's source-CIDR policy denies the trusted client address.

# paths./datasets/{name}/export.get.responses.404.description
The dataset does not exist or is outside this key's scope. Private datasets are concealed rather than disclosed with 403.

# paths./datasets/{name}/export.get.responses.413.description
The preview is too large, or a CSV query matches more than 1,000,000 rows. Narrow the query or use Parquet export.

# paths./datasets/{name}/export.get.responses.422.description
One or more parameters failed validation.

# paths./datasets/{name}/export.get.responses.429.description
The per-key request budget is spent. Wait for Retry-After, then retry.

# paths./datasets/{name}/export.get.responses.503.description
A transient fail-closed service guard rejected the request. Retry with backoff.

# components.securitySchemes.bearerAuth.description
Create a tp_live_… key in the authenticated TradePolaris Data API console.

# tags[].description
The read-only Kappa integration surface.

# x-llm-instructions[]
Resolve a dataset with GET /datasets?q=<term>; do not guess slugs or enumerate the full catalog.

# x-llm-instructions[]
Read /datasets/{name}/schema before choosing columns, date fields, symbol filters, or as_of.

# x-llm-instructions[]
This is a structured read-only API, not SQL.

# x-llm-instructions[]
Use as_of only when schema.capabilities.point_in_time_supported is true.

# x-llm-instructions[]
Pin version for reproducible work and verify content_sha256 on Parquet exports.

# x-llm-instructions[]
Never ask a user to paste an API-key secret into chat, logs, or source code.