changes

Cross-family delta feed since a cursor

Return only the rows in each product family that are newer than your cursor, in one call. Poll this instead of re-fetching whole family payloads every tick: it exists to cut agent token cost. Start with since (an ISO-8601 timestamp, at most 7 days old), then pass the previous response's meta.next_cursor back as cursor: it holds one position per family, so every row is delivered exactly once, including the rest of a family that hit limit_per_family (meta.truncated[family] true means more rows are pending for that family; poll again with next_cursor to get them). meta.next_since (also as_of) is a single timestamp kept for older clients: it never skips a row, but after a truncated poll it is held back to that family's last fully delivered timestamp, so re-polling with it can re-deliver rows of the other families (dedupe on id), and meta.next_since_stalled names a family whose next page cannot be reached that way (more than limit_per_family rows on one timestamp). Empty arrays mean nothing changed. A cursor is tied to the symbol filter it was issued for and expires 7 days after it was issued. Each family returns its own compact column set: signals (asset_signals), whale (whale_transactions), prediction (polymarket_markets), funding (funding_rate_history), etf_flow (crypto_etf_aggregate; has no per-symbol column so the symbol filter is ignored for it; each row carries total_kind, reported_subtotal_usd, funds_known and funds_active, total_net_flow_usd is set only when total_kind is 'total', and BTC/ETH rows for an NYSE session are served with total_kind 'withheld' and null flow values because the only session figures held for them carry no redistribution licence), gamma (options_gamma_exposure), confluence (compound_signals symbol_confluence and symbol_divergence rows; composites with a crypto-options family are not served). The optional symbol filter is case-insensitive and applies per family that has a symbol column. For deeper history than 7 days use the per-family endpoints or /v1/bulk.

get/changes

Request

  • Base URL: https://kresmion.com/v1
  • URL: https://kresmion.com/v1/changes
  • Auth: HTTP bearer

Query parameters

sincestring nullable

ISO-8601 timestamp to start from: rows strictly newer are returned. Must be within the last 7 days. Required unless cursor is given.

cursorstring nullable

The previous response's meta.next_cursor. Resumes every family exactly where it stopped (exactly-once). Takes precedence over since.

familiesstring

Comma-separated family names. Valid: signals, whale, prediction, funding, etf_flow, gamma, confluence.

symbolstring nullable

Optional symbol filter (case-insensitive), e.g. BTC or NVDA. Ignored for families with no symbol column.

limit_per_familyinteger

Max rows returned per family (truncation is flagged in meta).

Headers

authorizationstring nullable

Response

Successful Response

object required

Changes

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