GET

/api/v1/latest

Latest forecasts and associated sources across Quotient

A board-wide chronological feed of new forecasts and newly associated articles/X posts. Defaults to three hours and supports up to six. Market rows include venue_quote provenance: Polymarket International and Kalshi expose a verified live quote or null; Polymarket US and Limitless expose a graph snapshot marked stale.

Price $0.02Auth x-quotient-api-key or x402Limit 20/s · 600/min · 20,000/day

Parameters

NameInTypeDescription
hoursqueryintegerLookback in whole hours.

Default: 3; Minimum: 1; Maximum: 6

typesquerystringComma-separated subset of forecast, article, x_post.

Responses

200: Latest board-wide update events
FieldTypeDescription
as_ofstring

Format: date-time

windowobject
window fields
FieldTypeDescription
hoursinteger
sincestring

Format: date-time

types"forecast" | "article" | "x_post"[]
eventsobject[]
events fields
FieldTypeDescription
type"forecast" | "article" | "x_post"
idstring
occurred_atstring

Format: date-time

sourceobject | null
marketLatestMarket
market fields
FieldTypeDescription
venue
required
"polymarket" | "polymarket_us" | "kalshi" | "limitless"Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
nativeMarketId
required
string
nativeEventId
required
string | null
seriesTicker
required
string | null
marketKey
required
string
quotientMarketId
required
stringStable Quotient market-page id: bare numeric for legacy Polymarket rows, venue-prefixed (kalshi:TICKER, polymarket_us:123, …) elsewhere. quotientUrl is exactly https://quotient.social/markets/{quotientMarketId} (URL-encoded) — the id form the market page resolves for every venue. A market with no Quotient coverage yet may not have a page.
slug
required
string | null
marketUrl
required
string | nullConnector-owned market page URL; null when unavailable.

Format: uri

sourceUrl
required
string | nullConnector provenance or API source URL.

Format: uri

broker_channels
required
"robinhood"[]Retail brokers that carry this exact venue contract (same order book, same settlement). A broker distributes the venue contract; venue and marketKey remain the contract's identity. Today only robinhood, stamped on Kalshi rows from Robinhood's public listings; empty when no broker lists the market. Filter with topic=robinhood on /markets, /markets/mispriced and /signals, or tag=robinhood on /markets/search.
robinhood_category
required
string | nullRobinhood's own category slug for the listing (economics, politics, crypto, climate, …); null when not listed on Robinhood.
robinhood_url
required
string | nullDeep link to the Robinhood event page; null when not listed on Robinhood.

Format: uri

id
required
string | null
questionstring
condition_id
required
string | null
end_date
required
string | null

Format: date-time

quotientUrl
required
string | null
polymarketUrl
required
string | nullLegacy Polymarket navigation alias. Populated only for Polymarket International rows and null for Polymarket US, Kalshi, and Limitless; use marketUrl for venue-neutral navigation.
venue_data
required
object
venue_data fields
FieldTypeDescription
yes_odds
required
number | nullSource-venue YES probability (0-1), exactly matching venue_quote.selected_probability. Polymarket International and Kalshi use a verified live quote or null. Polymarket US and Limitless currently expose a graph snapshot marked quote_method=graph_snapshot and freshness=stale.
volume_24h
required
number | null
venue_quote
required
VenueQuoteV1
venue_quote fields
FieldTypeDescription
schema_version
required
"1"
venue
required
"polymarket" | "polymarket_us" | "kalshi" | "limitless" | nullPrediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
market_id
required
string | null
yes_bid
required
number | null

Minimum: 0; Maximum: 1

yes_ask
required
number | null

Minimum: 0; Maximum: 1

yes_last
required
number | null

Minimum: 0; Maximum: 1

selected_probability
required
number | nullPrediction-market YES probability selected for the enclosing response. Inspect freshness and quote_method before treating it as current.

Minimum: 0; Maximum: 1

quote_method
required
string | nullmidpoint, bid, ask, fresh last, or graph_snapshot. Null when pricing is unavailable.
venue_timestamp
required
string | nullSource clock for the selected quote: book update for book methods, last-trade time for last, or catalog observation time for graph_snapshot.

Format: date-time

observed_at
required
string | nullWhen Quotient observed the live quote or stored graph snapshot.

Format: date-time

freshness
required
CapabilityState
relationships
required
RelationshipsEnvelopeBounded, non-recursive graph references. Each category publishes at most 50 lightweight refs. These refs contain no forecast probability, venue odds, aggregate asset probability, or inferred causal AFFECTS edge.
relationships fields
FieldTypeDescription
assets
required
RelationshipAssetRef[]

Maximum items: 50

assets fields
FieldTypeDescription
relationship
required
"HAS_MARKET" | "ON_MARKET" | "ON_FORECAST" | "HAS_SIGNAL"Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction
required
"incoming" | "outgoing"Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via
required
"direct" | "market" | "asset"direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id
required
string

Format: uuid

assetKey
required
string
name
required
string
ticker
required
string | null
asset_type
required
string
markets
required
RelationshipMarketRef[]

Maximum items: 50

markets fields
FieldTypeDescription
relationship
required
"HAS_MARKET" | "ON_MARKET" | "ON_FORECAST" | "HAS_SIGNAL"Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction
required
"incoming" | "outgoing"Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via
required
"direct" | "market" | "asset"direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
marketKey
required
string
venue
required
"polymarket" | "polymarket_us" | "kalshi" | "limitless"Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
nativeMarketId
required
string
question
required
string | null
signals
required
RelationshipSignalRef[]

Maximum items: 50

signals fields
FieldTypeDescription
relationship
required
"HAS_MARKET" | "ON_MARKET" | "ON_FORECAST" | "HAS_SIGNAL"Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction
required
"incoming" | "outgoing"Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via
required
"direct" | "market" | "asset"direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id
required
string
signal_type
required
"prediction_market"
canonical_endpoint
required
"/api/v1/signals"
side
required
string | null
published_at
required
string | null
truncated
required
object
truncated fields
FieldTypeDescription
assets
required
boolean
markets
required
boolean
signals
required
boolean
forecastCompactForecast | null
forecast fields
FieldTypeDescription
venue
required
"polymarket" | "polymarket_us" | "kalshi" | "limitless" | nullPrediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
market
required
CanonicalMarketRouting | null
market fields
FieldTypeDescription
venue
required
"polymarket" | "polymarket_us" | "kalshi" | "limitless"Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
nativeMarketId
required
string
nativeEventId
required
string | null
seriesTicker
required
string | null
marketKey
required
string
quotientMarketId
required
stringStable Quotient market-page id: bare numeric for legacy Polymarket rows, venue-prefixed (kalshi:TICKER, polymarket_us:123, …) elsewhere. quotientUrl is exactly https://quotient.social/markets/{quotientMarketId} (URL-encoded) — the id form the market page resolves for every venue. A market with no Quotient coverage yet may not have a page.
slug
required
string | null
marketUrl
required
string | nullConnector-owned market page URL; null when unavailable.

Format: uri

sourceUrl
required
string | nullConnector provenance or API source URL.

Format: uri

broker_channels
required
"robinhood"[]Retail brokers that carry this exact venue contract (same order book, same settlement). A broker distributes the venue contract; venue and marketKey remain the contract's identity. Today only robinhood, stamped on Kalshi rows from Robinhood's public listings; empty when no broker lists the market. Filter with topic=robinhood on /markets, /markets/mispriced and /signals, or tag=robinhood on /markets/search.
robinhood_category
required
string | nullRobinhood's own category slug for the listing (economics, politics, crypto, climate, …); null when not listed on Robinhood.
robinhood_url
required
string | nullDeep link to the Robinhood event page; null when not listed on Robinhood.

Format: uri

id
required
string
probability
required
number
created_at
required
string

Format: date-time

headlinestring | null
thesis
required
string | null
resolution_pathway
required
ResolutionPathwayThe market contract and forecast crux needed to review how this forecast can resolve.
resolution_pathway fields
FieldTypeDescription
criteria
required
string | null
crux
required
string | null
deadline
required
string | null

Format: date-time

source
required
string | null
delta_from_priornumber | null
delta_reasoningstring | null
refresh_reasonstring | null
relationships
required
RelationshipsEnvelopeBounded, non-recursive graph references. Each category publishes at most 50 lightweight refs. These refs contain no forecast probability, venue odds, aggregate asset probability, or inferred causal AFFECTS edge.
relationships fields
FieldTypeDescription
assets
required
RelationshipAssetRef[]

Maximum items: 50

assets fields
FieldTypeDescription
relationship
required
"HAS_MARKET" | "ON_MARKET" | "ON_FORECAST" | "HAS_SIGNAL"Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction
required
"incoming" | "outgoing"Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via
required
"direct" | "market" | "asset"direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id
required
string

Format: uuid

assetKey
required
string
name
required
string
ticker
required
string | null
asset_type
required
string
markets
required
RelationshipMarketRef[]

Maximum items: 50

markets fields
FieldTypeDescription
relationship
required
"HAS_MARKET" | "ON_MARKET" | "ON_FORECAST" | "HAS_SIGNAL"Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction
required
"incoming" | "outgoing"Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via
required
"direct" | "market" | "asset"direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
marketKey
required
string
venue
required
"polymarket" | "polymarket_us" | "kalshi" | "limitless"Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless.
nativeMarketId
required
string
question
required
string | null
signals
required
RelationshipSignalRef[]

Maximum items: 50

signals fields
FieldTypeDescription
relationship
required
"HAS_MARKET" | "ON_MARKET" | "ON_FORECAST" | "HAS_SIGNAL"Exact graph edge at the final hop. The API does not synthesize AFFECTS relationships.
direction
required
"incoming" | "outgoing"Direction of the final graph edge relative to the response subject for direct refs, or relative to the explicit via node for two-hop refs.
via
required
"direct" | "market" | "asset"direct is one graph hop; market or asset names the explicit intermediate node for a bounded two-hop ref.
id
required
string
signal_type
required
"prediction_market"
canonical_endpoint
required
"/api/v1/signals"
side
required
string | null
published_at
required
string | null
truncated
required
object
truncated fields
FieldTypeDescription
assets
required
boolean
markets
required
boolean
signals
required
boolean
countinteger
401: Unauthorized
FieldTypeDescription
error
required
stringError code
message
required
stringHuman-readable message
retry_afterintegerSeconds to wait (only on 429)
retryAfterintegerSeconds to wait for owner-scoped forecast-request quota errors.
limit_scopestringQuota scope that rejected the request, such as standard or x_research.
quotaScopestringStable forecast-request quota scope, such as venue_market_daily.
limitintegerConfigured bound for the forecast-request quota that was exceeded.
402: Payment Required
FieldTypeDescription
error
required
stringError code
message
required
stringHuman-readable message
retry_afterintegerSeconds to wait (only on 429)
retryAfterintegerSeconds to wait for owner-scoped forecast-request quota errors.
limit_scopestringQuota scope that rejected the request, such as standard or x_research.
quotaScopestringStable forecast-request quota scope, such as venue_market_daily.
limitintegerConfigured bound for the forecast-request quota that was exceeded.
403: Insufficient credits for the requested route
FieldTypeDescription
error
required
stringError code
message
required
stringHuman-readable message
retry_afterintegerSeconds to wait (only on 429)
retryAfterintegerSeconds to wait for owner-scoped forecast-request quota errors.
limit_scopestringQuota scope that rejected the request, such as standard or x_research.
quotaScopestringStable forecast-request quota scope, such as venue_market_daily.
limitintegerConfigured bound for the forecast-request quota that was exceeded.
422: Invalid query parameters
FieldTypeDescription
error
required
stringError code
message
required
stringHuman-readable message
retry_afterintegerSeconds to wait (only on 429)
retryAfterintegerSeconds to wait for owner-scoped forecast-request quota errors.
limit_scopestringQuota scope that rejected the request, such as standard or x_research.
quotaScopestringStable forecast-request quota scope, such as venue_market_daily.
limitintegerConfigured bound for the forecast-request quota that was exceeded.
429: The caller exceeded a per-second, per-minute, daily, or concurrency limit. No credits are debited and no x402 payment is settled for this response.
FieldTypeDescription
error
required
stringError code
message
required
stringHuman-readable message
retry_afterintegerSeconds to wait (only on 429)
retryAfterintegerSeconds to wait for owner-scoped forecast-request quota errors.
limit_scopestringQuota scope that rejected the request, such as standard or x_research.
quotaScopestringStable forecast-request quota scope, such as venue_market_daily.
limitintegerConfigured bound for the forecast-request quota that was exceeded.

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/latest'
200 · application/json
{
  "as_of": "2027-01-01T00:00:00Z",
  "window": {
    "hours": 0,
    "since": "2027-01-01T00:00:00Z"
  },
  "types": [
    "forecast"
  ],
  "events": [
    {
      "type": "forecast",
      "id": "example",
      "occurred_at": "2027-01-01T00:00:00Z",
      "source": {},
      "market": {
        "venue": "polymarket",
        "nativeMarketId": "example",
        "nativeEventId": "example",
        "seriesTicker": "example",
        "marketKey": "example",
        "quotientMarketId": "example",
        "slug": "example",
        "marketUrl": "example",
        "sourceUrl": "example",
        "broker_channels": [
          "robinhood"
        ],
        "robinhood_category": "example",
        "robinhood_url": "example",
        "id": "example",
        "question": "example",
        "condition_id": "example",
        "end_date": "2027-01-01T00:00:00Z",
        "quotientUrl": "example",
        "polymarketUrl": "example",
        "venue_data": {
          "yes_odds": 0,
          "volume_24h": 0
        },
        "venue_quote": {
          "schema_version": "1",
          "venue": "polymarket",
          "market_id": "example",
          "yes_bid": 0,
          "yes_ask": 0,
          "yes_last": 0,
          "selected_probability": 0,
          "quote_method": "example",
          "venue_timestamp": "2027-01-01T00:00:00Z",
          "observed_at": "2027-01-01T00:00:00Z",
          "freshness": "verified"
        },
        "relationships": {
          "assets": [
            {}
          ],
          "markets": [
            {}
          ],
          "signals": [
            {}
          ],
          "truncated": {
            "assets": false,
            "markets": false,
            "signals": false
          }
        }
      },
      "forecast": {
        "venue": "polymarket",
        "market": {
          "venue": "polymarket",
          "nativeMarketId": "example",
          "nativeEventId": "example",
          "seriesTicker": "example",
          "marketKey": "example",
          "quotientMarketId": "example",
          "slug": "example",
          "marketUrl": "example",
          "sourceUrl": "example",
          "broker_channels": [
            "robinhood"
          ],
          "robinhood_category": "example",
          "robinhood_url": "example"
        },
        "id": "example",
        "probability": 0,
        "created_at": "2027-01-01T00:00:00Z",
        "headline": "example",
        "thesis": "example",
        "resolution_pathway": {
          "criteria": "example",
          "crux": "example",
          "deadline": "2027-01-01T00:00:00Z",
          "source": "example"
        },
        "delta_from_prior": 0,
        "delta_reasoning": "example",
        "refresh_reason": "example",
        "relationships": {
          "assets": [
            {}
          ],
          "markets": [
            {}
          ],
          "signals": [
            {}
          ],
          "truncated": {
            "assets": false,
            "markets": false,
            "signals": false
          }
        }
      }
    }
  ],
  "count": 0
}