TRADEFLAGS 交易提示 TERMINAL · LIVE · · 27 PACKAGES · 4 PRICING TIERS · FREE TIER
*DELAYED 15M*
SPY 696.91 -2.65%
VIX 33.71 +18.53%
UST10Y 4.94 -10bp
USDJPY 158.47 -0.77%
BTC 58484.04 -5.52%
GOLD 3532.70 -4.15%
WTI 83.17 -0.05%
DXY 103.88 -0.02%

TRADEFLAGS 交易提示 · QUANTITATIVE DATA INFRASTRUCTURE AI AGENT READY

TF> list packages
Docs / Errors

Errors

Error codes, what causes them, and what to do about each.

Shape

An error returns a JSON object with a single error key naming the failure, and an HTTP status that matches its class. The body is never empty and never carries a partial result.

{"error":"network_unavailable"}

Status codes

StatusMeaningWhat to do
200Success. The body may still carry an empty series.Check the series length, not just the status.
400Malformed request.Fix the parameters before retrying. A retry will fail identically.
401Missing or invalid API key.Check TRADEFLAGS_API_KEY is set and the key is live.
403Key valid but not entitled to the package or series.Check your tier. Request an upgrade.
429Rate or quota limit reached.Back off and retry after the interval given in the Retry-After header.
500The service could not complete the call.Retry with backoff. If it persists, the series may be unavailable.
503Service or database unreachable.Check /api/health.php. Retry once the service reports healthy.

Named errors

These are the error values the service returns. Each names the specific series that could not be served, so a failing tool identifies itself.

ErrorMeaning
ads_unavailableThe ADS Business Conditions series could not be read.
cranex_unavailableThe CRANE-X sentiment snapshot could not be read.
live_unavailableThe live bundle could not be assembled.
moirai_hk_unavailableThe Moirai HK forecast bundle could not be read.
network_unavailableThe supply-chain graph could not be read.
news_unavailableThe headline feed could not be read.
trin_scatter_unavailableThe TRIN scatter series could not be read.
vix_unavailableThe VIX term-structure series could not be read.
No dataThe request was valid but the series holds no rows for that query. The response carries an empty strategies array alongside it.

Retrying

A 500 or 503 is worth retrying with exponential backoff. A 400 or a named *_unavailable error on a single series will not be fixed by retrying the same call — it is either a bad request or a series that is genuinely not published.

Named errors are per series. When one series fails, the response identifies that series by name rather than failing the whole bundle. A client can then degrade one panel instead of the page.

Still stuck

Write to contact@tradeflags.com with the error name, the package, the tool and the approximate time of the call. That is enough for us to find the corresponding entry in the request log.