News & Content

List news articles

Get a paginated list of news articles. Supports sorting by hot, new, or top. Use status parameter to filter by article status (requires authentication for non-approved statuses). Each item includes a related_market summary (same shape as the single-article detail endpoint) when the article has an open, frozen, or resolved prediction market attached, else null; always null when prediction markets are disabled. related_market prices/volume are baked into the cached page and can be up to one cache TTL (60s for hot/new, 300s otherwise) stale relative to the latest trade.

get/api/v1/news/

Request

  • Base URL: https://api.leviathannews.xyz (the document declares no server; this is the origin it was published from)
  • URL: https://api.leviathannews.xyz/api/v1/news/
  • Auth: none declared

Query parameters

pageinteger

Page number

per_pageinteger

Items per page

preferred_tagsstring

Onboarding-funnel interest tags (ids, slugs, or names). Repeat the param or provide a comma-separated list. Matching articles are boosted toward the top of the feed; non-matching articles are still included, never hard-filtered out. Requests using this param bypass the shared response cache.

sort_timeframeinteger

Timeframe in days for top sort (required when sort_type=top)

sort_type'hot' | 'new' | 'top'

Sort type: hot, new, or top

status'all' | 'approved' | 'scheduled' | 'submitted'

Filter by article status: approved (default, public), submitted (pending review, public), scheduled (future publication, requires auth), or all (auth)

Response

Paginated list of news articles

Changes

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