Market Data

Is this position's trend still intact? Hold state for up to 10 symbols at once

Per-symbol HOLD-STATE read for names already tracked: GET /api/board/hold?sym=NVDA (or ?sym=NVDA,AMD,BTC-USD — up to 10 names, one price) returns each name's published trend state, hold strength, readiness, maturity-late flag, overnight gap-risk grade and its book's regime, plus the mechanical rules the states flip on. Refreshed ~5 min in US market hours. Scores and states only, never stop/target prices; an impersonal publication identical for every reader — it never reads a buyer's entry price or position size. Unknown symbols return the valid-symbol directory.

get/api/board/hold

Request

  • Base URL: https://coil.trade
  • URL: https://coil.trade/api/board/hold
  • Auth: one of:
    • API key in header X-PAYMENT
    • HTTP payment
    • API key in header X-Coil-Key

Query parameters

symstring required

Ticker, e.g. NVDA — or up to 10 comma-separated (NVDA,AMD,BTC-USD). Symbols that are not on the board fail FREE with a 400 pointing at /api/board/symbols — a typo is never billed.

Headers

PAYMENT-SIGNATUREstring

x402 v2 payment: base64 of the signed payment payload. Send this OR X-PAYMENT (v1 name) — omit both to receive the 402 challenge.

X-PAYMENTstring

x402 v1 payment header — the v1 dialect's name for PAYMENT-SIGNATURE. Accepted for backwards compatibility with v1 clients.

Authorizationstring

MPP credential: Payment <base64 credential> answering the WWW-Authenticate: Payment challenge on the 402 (method usdc, intent charge).

X-Coil-Keystring

Free-tier key (coilfree_/coilwallet_) — ~25 live calls/day on this endpoint instead of paying. A free key reads up to 3 symbols per call (extras come back in free_key_sample.ignored); the paid read serves the full batch. Mint at POST /api/key or via SIWX at /api/auth/verify.

SIGN-IN-WITH-Xstring

SIWX (CAIP-122) wallet sign-in: base64 {message, signature, chainId, type}. Serves the free tier keyed to the wallet — no payment, no key mint.

Response

Per-symbol hold state for up to 10 names: published trend state, hold strength 0-100, readiness, maturity-late flag, overnight gap-risk grade and each book's regime, with the mechanical rules the states flip on (BTC-USD/ETH-USD return the crypto book's IN|CASH daily-close state). Impersonal publication — never ingests a buyer's entry or size. Settlement receipt in the PAYMENT-RESPONSE header. Includes a freshness object (market_open, data_age_seconds, next_refresh_at, poll_hint).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.