developers / positioning API

Developers

API consumption for pressure and catalyst timing. Missing sources stay null with reasons; no route infers direction.

https://flowdensity.com

18live endpoints1 planned, visibly blocked

18live

/v1/boardlive

/v1/calendarlive

/v1/schemalive

/v1/core-kpislive

/v1/replay/pressurelive

/v1/archive/positioning/{symbol}live

/v1/replay/state-changeslive

/v1/snapshot/event-risklive

/v1/snapshot/volumelive

18 live contracts1 planned, visibly blockedmissing sources return null + reason

current packetfixture fallback packet

freshnesslive

as_of2026-06-12T14:32:14+00:00

visible gaps0 gaps

sources live20/50 sources live; 0 degraded; 0 stale; 30 limited

sourcefixture fallback; .local/snapshots.jsonl

allowed usemeasurement only

degradationnull + reason

raw datanot redistributed

SERVED FIELD ADDITIVITY

new consumer fields are additive wrappers around served packets; numbers stay separate from interpretation

fieldas_ofsource/v1/board[].as_of and /v1/replay/pressure.points[].as_ofconsumerjoin key, freshness stamp, and replay orderingpolicyadditive timestamp; preserve the producer value and never replace it with client clock time

fieldhistory arrayssource/v1/replay/pressure.points[] -> pressureTrajectory.points[]consumerPressure home rows, watchlist trend, and focused pressure-over-timepolicyappend-only history; empty stays empty, never filler points

fieldscan-diffsourcepressureTrajectory.points[]; collapse when the prior scan is absentconsumerPressure home Field scan-diff strippolicyderived only from two scored history points with distinct as_of; not a producer score

The UI scan-diff line is not a new API field and not a number source; it is a view over existing history arrays with the boundary copy field change only; no direction implied.

RESPONSE FIELD CONTRACT

board and calendar fields stay source-labeled, nullable when missing, and never zero-filled

field/v1/board[].as_ofsourceproducer packet timestampnull policyrequired on packet rows; stale stays labeled, not hiddencurrent packet2026-06-12T14:32:14+00:00

field/v1/board[].instrument_idsourceinstrument identity in current board packetnull policyrequired when a row is emitted; absent rows are not synthesizedcurrent packet10/10 rows carry instrument_id

field/v1/board[].pressure_scoresourceobjective positioning-pressure measurementnull policynullable; missing pressure is not zeroed and not read as quietcurrent packet10 rows carry visible null/degraded/stale/limited coverage

field/v1/board[].next_catalyst.days_tosource/v1/calendar primary-source clocknull policynullable when no confirmed catalyst is present; dates are not inferredcurrent packet10/10 rows carry catalyst context

field/v1/board[].signal_fields[].source_signalsourceproducer source receiptnull policynullable when a source is unavailable; gaps[] must name the missing sourcecurrent packet50/50 signal fields cite source_signal

field/v1/board[].signal_fields[].source_cadencesourceproducer cadence metadatanull policynullable; undeclared cadence stays null and visible in receiptscurrent packet0/50 signal fields declare source_cadence

field/v1/board[].signal_fields[].source_delay_minutessourceproducer delay metadatanull policynullable; delayed feeds stay labeled instead of promoted to livecurrent packet0/50 signal fields declare source_delay_minutes

field/v1/board[].gaps[]sourcemissing-data receiptnull policyempty only when no known gap exists; never converted to a calm signalcurrent packet0 visible gaps in the current packet

AGENT-NATIVE

MCP server, open skill, and llms.txt ship with the API — agents get the same schema-first contract as humans.

MCP: nine in-process tools (schema, board, asset, core KPIs, watchlist, calibration scorecard, state changes, health, methodology) mirror the public read surface.
Open skill: skill.md teaches the packet join key (instrument_id, symbol, as_of, window), preserve rules, and the schema-first fetch order.
llms.txt gives crawler-facing agents the measurement-not-advice framing and canonical endpoints.
Data contract: what the feed guarantees, including lane freshness, replay admissibility, explicit missing-data states, and countersign verification.
Calibration receipts: /v1/scorecard + /v1/scorecard/methodology publish the CP-072 gate state every signal must pass before it leads a marketed claim.

curl -s https://flowdensity.com/v1/methodology
curl -s https://flowdensity.com/v1/scorecard
curl -s -H "X-API-Key: $FD_KEY" https://flowdensity.com/v1/insights/NVDA

WORKING BASE

plain curl examples against the public apex API base

curl -s https://flowdensity.com/v1/board
curl -s https://flowdensity.com/v1/calendar
curl -s https://flowdensity.com/v1/assets/NVDA

HISTORY + SNAPSHOTS

append-only replay and derived snapshot surfaces; nulls remain typed

curl -s https://flowdensity.com/v1/replay/pressure?symbol=NVDA
curl -s https://flowdensity.com/v1/archive/positioning/NVDA
curl -s https://flowdensity.com/v1/replay/state-changes?symbol=NVDA
curl -s https://flowdensity.com/v1/snapshot/event-risk
curl -s https://flowdensity.com/v1/snapshot/volume
curl -s https://flowdensity.com/v1/snapshot/squeeze-risk
curl -s https://flowdensity.com/v1/snapshot/attention-divergence

ENDPOINT CONTRACT MAP · v1

search copyable contracts, isolate honest blockers, copy a shaped request

19 visible

Pressure Read of positioning data Pressure Read endpoints return cited positioning text only. not investment advice; pressure and timing measurement only.

searchsort

19 visible18 live1 planned2 keyed1 paid

VISIBLE CSV19 rows - 11 columns

Exports the active endpoint lens only; planned endpoints remain planned and request paths stay example-shaped.

ACTIVE ENDPOINT CONTRACT/v1/board

filterall

sortpath:asc

visible19

authpublic

request path/v1/board

statuslive

null policyscores and sources can stay null; gaps[] names the reason

freshness policyfixture fallback; freshness live; as_of 2026-06-12T14:32:14+00:00

coverage policy20/50 sources live; 0 degraded; 0 stale; 30 limited

contract JSON

{
  "surface": "developers",
  "version": "developer_endpoint_table_view_v1",
  "lens": {
    "search": null,
    "filter": "all",
    "sort": {
      "key": "path",
      "direction": "asc"
    },
    "columns": [
      "method",
      "path",
      "category",
      "auth",
      "detail",
      "status"
    ]
  },
  "result": {
    "visible_count": 19,
    "total_count": 19,
    "live_count": 18,
    "planned_count": 1,
    "keyed_count": 2,
    "paid_count": 1,
    "visible_endpoints": [
      "/health/deep",
      "/v1/archive/positioning/{symbol}",
      "/v1/assets/{symbol}",
      "/v1/board",
      "/v1/calendar",
      "/v1/core-kpis",
      "/v1/flow/events",
      "/v1/insights/{symbol}",
      "/v1/methodology",
      "/v1/reads/{symbol}",
      "/v1/replay/pressure",
      "/v1/replay/state-changes",
      "/v1/schema",
      "/v1/scorecard",
      "/v1/snapshot/attention-divergence",
      "/v1/snapshot/event-risk",
      "/v1/snapshot/squeeze-risk",
      "/v1/snapshot/volume",
      "/v1/watchlist"
    ]
  },
  "selection": {
    "method": "GET",
    "path": "/v1/board",
    "category": "public",
    "auth": "public",
    "tiers": [
      "free"
    ],
    "status": "live",
    "request_path": "/v1/board",
    "null_policy": "scores and sources can stay null; gaps[] names the reason",
    "freshness_policy": "fixture fallback; freshness live; as_of 2026-06-12T14:32:14+00:00",
    "coverage_policy": "20/50 sources live; 0 degraded; 0 stale; 30 limited",
    "fields_cited": [
      "endpoints[path=/v1/board].method",
      "endpoints[path=/v1/board].path",
      "endpoints[path=/v1/board].category",
      "endpoints[path=/v1/board].auth",
      "endpoints[path=/v1/board].tiers",
      "endpoints[path=/v1/board].detail",
      "endpoints[path=/v1/board].null_policy",
      "endpoints[path=/v1/board].freshness_policy",
      "endpoints[path=/v1/board].coverage_policy",
      "endpoints[path=/v1/board].status"
    ]
  }
}

METHODDETAIL

REQUEST PREVIEWGET /v1/board

curl -s "$FD_API_BASE/v1/board"

/v1/calendarmarket-wide, 90dsnapshot_store=.local/snapshots.jsonl; as_of=2026-06-12T14:32:14+00:00; status=fixture fallback; packet=fixture fallback packetpacketContext rows=10; freshness=live; visible gaps=0; sleeves live=20/50; degraded=0; null_safe_rows=10

source envelope JSON

{
  "asset": "NVDA",
  "signal": "event_risk",
  "score": 88.7,
  "components": {
    "n_events": 9,
    "nearest_days_to": 5,
    "magnitude": "unknown"
  },
  "confidence": 0.5,
  "freshness": "live",
  "as_of": "2026-06-12T14:32:00+00:00"
}

API reference

Developers are loading.

curl -s https://flowdensity.com/v1/replay/pressure?symbol=NVDA curl -s https://flowdensity.com/v1/archive/positioning/NVDA curl -s https://flowdensity.com/v1/replay/state-changes?symbol=NVDA curl -s https://flowdensity.com/v1/snapshot/event-risk curl -s https://flowdensity.com/v1/snapshot/volume curl -s https://flowdensity.com/v1/snapshot/squeeze-risk curl -s https://flowdensity.com/v1/snapshot/attention-divergence

{ "surface": "developers", "version": "developer_endpoint_table_view_v1", "lens": { "search": null, "filter": "all", "sort": { "key": "path", "direction": "asc" }, "columns": [ "method", "path", "category", "auth", "detail", "status" ] }, "result": { "visible_count": 19, "total_count": 19, "live_count": 18, "planned_count": 1, "keyed_count": 2, "paid_count": 1, "visible_endpoints": [ "/health/deep", "/v1/archive/positioning/{symbol}", "/v1/assets/{symbol}", "/v1/board", "/v1/calendar", "/v1/core-kpis", "/v1/flow/events", "/v1/insights/{symbol}", "/v1/methodology", "/v1/reads/{symbol}", "/v1/replay/pressure", "/v1/replay/state-changes", "/v1/schema", "/v1/scorecard", "/v1/snapshot/attention-divergence", "/v1/snapshot/event-risk", "/v1/snapshot/squeeze-risk", "/v1/snapshot/volume", "/v1/watchlist" ] }, "selection": { "method": "GET", "path": "/v1/board", "category": "public", "auth": "public", "tiers": [ "free" ], "status": "live", "request_path": "/v1/board", "null_policy": "scores and sources can stay null; gaps[] names the reason", "freshness_policy": "fixture fallback; freshness live; as_of 2026-06-12T14:32:14+00:00", "coverage_policy": "20/50 sources live; 0 degraded; 0 stale; 30 limited", "fields_cited": [ "endpoints[path=/v1/board].method", "endpoints[path=/v1/board].path", "endpoints[path=/v1/board].category", "endpoints[path=/v1/board].auth", "endpoints[path=/v1/board].tiers", "endpoints[path=/v1/board].detail", "endpoints[path=/v1/board].null_policy", "endpoints[path=/v1/board].freshness_policy", "endpoints[path=/v1/board].coverage_policy", "endpoints[path=/v1/board].status" ] } }