Market Profile API

Manage keys →Studio

A read-only HTTP API exposing the worker's live auction context for the futures scan universe: key levels (POC / value area / IB / naked POCs / poor highs & lows) and market-structure alerts. JSON over HTTPS. Educational context, not financial advice.

Base URL

https://<your-deployment>/api

Authentication

Every request needs an API key in the x-api-key header, never a query string. A query string leaks the key into logs and referrers. Generate and revoke keys self-serve on the Account page.

curl -H "x-api-key: aift_xxxxxxxxxxxx" \
  "https://<your-deployment>/api/levels?symbol=ES"

Rate limits & tiers

Limits are per key, per minute. Every response carries X-RateLimit-Limit and X-Api-Tier. Exceeding the limit returns 429.

TierRequests / min
free30
pro120
admin600

Endpoints

GET/api/levels?symbol=ES

Key levels for one symbol. symbol accepts the full-size display ticker (ES, NQ, GC, CL) or the raw executable key.

{
  "symbol": "ES",
  "updatedAt": "2026-07-17T14:03:11.402Z",
  "lastPrice": 5623.25,
  "bias": "trend_up",
  "developing": { "poc": 5620, "vah": 5628, "val": 5612,
                  "vpoc": 5621, "ibHigh": 5626, "ibLow": 5610,
                  "high": 5631, "low": 5608 },
  "prior":    { "poc": 5601, "vah": 5610, "val": 5590 },
  "overnight":{ "high": 5629, "low": 5605 },
  "nakedPocs":[ { "price": 5588, "date": "2026-07-15" } ],
  "poorHighs":[], "poorLows":[],
  "playbook": { "bias": "trend_up", "levels": [ ... ], "scenarios": [ ... ] }
}
GET/api/alerts

Live market-structure alerts across the scan universe. Optional ?symbol=ES filter. Each alert carries a severity (info / warn / critical).

{
  "updatedAt": "2026-07-17T14:03:11.402Z",
  "count": 2,
  "alerts": [
    { "symbol": "ES", "type": "va-reject-high", "severity": "critical",
      "price": 5628, "ref": "prior-VAH", "message": "ES rejected prior VAH 5628" },
    { "symbol": "NQ", "type": "naked-poc", "severity": "warn",
      "price": 20110, "ref": "2026-07-15", "message": "NQ testing naked POC 20110" }
  ]
}

Alert types & severity

TypeSeverityMeaning
va-reject-high / -lowcriticalPrice rejected prior value-area edge
ib-break-up / -downcriticalInitial-balance breakout
va-accept-above / -belowwarnAcceptance outside prior value
naked-pocwarnTesting an untouched (virgin) POC
va-test-high / -lowinfoTouching prior value-area edge
poor-high / poor-lowinfoRevisiting an unfinished auction extreme

Webhooks

Instead of polling /api/alerts, subscribe a Discord / Telegram / generic endpoint or an email digest on the Account page. Each subscription can filter by symbol and minimum severity; the worker pushes matching alerts as they fire.

Errors

401 missing/invalid key · 404 unknown symbol · 429 rate limit · 502 upstream store unavailable.

The API surfaces auction context for education and research. It is not a trade recommendation or a performance guarantee.