---
title: "Is this position's trend still intact? Hold state for up to 10 symbols at once"
method: GET
path: "/api/board/hold"
tags: ["Market Data"]
---

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

`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`

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.

## Query parameters

- `sym` string, required

## Headers

- `PAYMENT-SIGNATURE` string
- `X-PAYMENT` string
- `Authorization` string
- `X-Coil-Key` string
- `SIGN-IN-WITH-X` string

## Response `200`

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

## Other responses

- `402`: Payment Required — x402 v2 payment requirements in the JSON body and the PAYMENT-REQUIRED header

---

[API](https://skmtc.dev/coil/apis/coil-scanner-agent-api.md) · [All operations](https://skmtc.dev/coil/apis/coil-scanner-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coil/apis/coil-scanner-agent-api/revisions/e087ee004cfb?raw)