Get the live options chain for a symbol from Unusual Whales (REQ-12.4).

GET

/api/advisor/options-chain

const url = 'https://api.tradr.cloud/api/advisor/options-chain?symbol=example';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.tradr.cloud/api/advisor/options-chain?symbol=example'

Backs the options-tools page chain viewer. Shares the Unusual Whales client and the market_data_options_chain tool’s parsing (REQ-12.4 — no duplicate fetch logic). When the authenticated user has no Unusual Whales key the response is { configured: false } (200) so the viewer shows an empty-state CTA to Settings, not an error (REQ-12.2). With a key the response is { configured: true, chain } where chain is the compact projection { symbol, expiration?, count, contracts[] }. Upstream failures are mapped to their REQ-6.5 reason codes on the matching HTTP status (REQ-12.3): 400 MARKET_DATA_KEY_INVALID, 429 MARKET_DATA_RATE_LIMITED / PLATFORM_RATE_LIMITED, 404 SYMBOL_NOT_FOUND, 503 MARKET_DATA_UNAVAILABLE. The plaintext key is never returned or logged.

Parameters

Query Parameters

symbol

required

string

/^[A-Z.]{1,6}$/

expiration

string

/^\d{4}-\d{2}-\d{2}$/

Responses

200

{ configured: false } or { configured: true, chain }.

400

Validation error or MARKET_DATA_KEY_INVALID.

404

SYMBOL_NOT_FOUND.

429

MARKET_DATA_RATE_LIMITED or PLATFORM_RATE_LIMITED.

503

MARKET_DATA_UNAVAILABLE.