GET

/api/v1/sources

Recent sources for selected markets

Recent evidence for up to 10 covered markets across Polymarket International, Polymarket US, Kalshi, and Limitless: correlated articles and relevant X posts ordered by published time. Prefer market_keys for cross-venue or nullable-slug rows. Legacy markets= slugs share one explicit venue and default to Polymarket. X posts window on when last seen as relevant, so a re-sighted older post can appear.

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

Parameters

Name	In	Type	Description
markets	query	string	Comma-separated market slugs (1-10). Mutually exclusive with market_keys; legacy default venue is polymarket.
market_keys	query	string	Preferred comma-separated globally unique marketKey values (1-10). Mutually exclusive with markets.
venue	query	"polymarket" \| "polymarket_us" \| "kalshi" \| "limitless"	Optional prediction-market venue filter. Omit it on catalog/feed routes to include every covered venue. On legacy slug or condition-ID lookups, omission retains the Polymarket namespace; prefer marketKey for collision-safe cross-venue lookup.
window	query	integer	Lookback window in hours. Default: 48 Default: 48; Minimum: 1; Maximum: 168
types	query	string	Comma-separated subset of: article, x_post. Default: both.

Responses

200: Recent sources across the selected markets, newest first

Field

Type

Description

sources

required

SourceItem[]

sources fields

Field

Type

Description

type

required

"article" | "x_post"

market_slug

required

string | null

market

required

CanonicalMarketWithRelationships

market fields

Field

Type

Description

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

string

Stable 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 | null

Connector-owned market page URL; null when unavailable.

Format: uri

sourceUrl

required

string | null

Connector 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 | null

Robinhood's own category slug for the listing (economics, politics, crypto, climate, …); null when not listed on Robinhood.

robinhood_url

required

string | null

Deep link to the Robinhood event page; null when not listed on Robinhood.

Format: uri

relationships

required

RelationshipsEnvelope

Bounded, 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

Field

Type

Description

assets

required

RelationshipAssetRef[]

Maximum items: 50

assets fields

Field	Type	Description
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

Field	Type	Description
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

Field	Type	Description
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

Field	Type	Description
assets required	boolean
markets required	boolean
signals required	boolean

title

string | null

url

string | null

source_name

string | null

feed_tier

string

primary | specialist | secondary (X posts use specialist)

published_at

string

Format: date-time

relevance

object

relevance fields

Field	Type	Description
confidence	string \| null	Correlation confidence (articles) or materiality (X posts)
reasoning	string \| null
evidence_quote	string \| null	Verbatim quote grounding the relevance

author_handle

string | null

X posts only

is_expert

boolean | null

X posts only: reviewed expert author

401: Unauthorized

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

402: Payment Required

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

403: Insufficient credits for the requested route

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured bound for the forecast-request quota that was exceeded.

422: Invalid request parameters

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured 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.

Field	Type	Description
error required	string	Error code
message required	string	Human-readable message
retry_after	integer	Seconds to wait (only on 429)
retryAfter	integer	Seconds to wait for owner-scoped forecast-request quota errors.
limit_scope	string	Quota scope that rejected the request, such as standard or x_research.
quotaScope	string	Stable forecast-request quota scope, such as venue_market_daily.
limit	integer	Configured 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/sources'

200 · application/json

{
  "sources": [
    {
      "type": "article",
      "market_slug": "example",
      "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",
        "relationships": {
          "assets": [
            {}
          ],
          "markets": [
            {}
          ],
          "signals": [
            {}
          ],
          "truncated": {
            "assets": false,
            "markets": false,
            "signals": false
          }
        }
      },
      "title": "example",
      "url": "example",
      "source_name": "example",
      "feed_tier": "example",
      "published_at": "2027-01-01T00:00:00Z",
      "relevance": {
        "confidence": "example",
        "reasoning": "example",
        "evidence_quote": "example"
      },
      "author_handle": "example",
      "is_expert": false
    }
  ]
}