Read a client's current feed snapshot

GET/api/v1/feeds/{id}

Snapshots refresh every minute. Follow next_cursor for a stable snapshot; cursors last at least 15 minutes. After reading all pages, use event_cursor to resume changes. A stale snapshot is returned during source failures, without false exits.

Auth x-quotient-api-key or x402Limit 5/s · 120/min · 20,000/day

Parameters

Name	In	Type	Description
id	path, required	string	Format: uuid
limit	query	integer	Default: 50; Minimum: 1; Maximum: 100
cursor	query	string

Responses

200: Snapshot

Field

Type

Description

schema_version

feed_id

string

snapshot_id

string | null

evaluated_at

string | null

stale

boolean

event_cursor

integer

config_version

integer

items

EnterpriseFeedItem[]

items fields

Field	Type	Description
item_key required	string	Stable venue-specific market identity or perp series/basis identity.
kind required	"market" \| "perp"
matching_rule_ids required	string[]
data required	object	Market or execution signal, exact forecast IDs, stored reasoning, cited_sources, related_markets, and explicit evidence_status. Probabilities use 0–1; spread_pp uses percentage points. Perps include original signal-basis and current outlook provenance.

next_cursor

string | null

401: Missing or invalid credential

403: Credential does not own this feed

409: Snapshot expired; restart pagination

429: Rate limited

Set QUOTIENT_API_KEY in your shell and replace example identifiers with returned IDs before running a request.

curl

curl --request GET \
  --header "x-quotient-api-key: $QUOTIENT_API_KEY" \
  'https://quotient-api-gateway.onrender.com/api/v1/feeds/example-id'

200 · application/json

{
  "schema_version": 1,
  "feed_id": "example",
  "snapshot_id": null,
  "evaluated_at": null,
  "stale": false,
  "event_cursor": 0,
  "config_version": 0,
  "items": [
    {
      "item_key": "example",
      "kind": "market",
      "matching_rule_ids": [
        "example"
      ],
      "data": {}
    }
  ],
  "next_cursor": null
}