Skip to main content
GET
News feed

Authorizations

X-API-KEY
string
header
default:pk_live_YOUR_KEY
required

Prometheus API key (pk_live_...), created on the Developers page in the terminal. Also accepted as Authorization: Bearer pk_live_....

Query Parameters

after
integer<int64>

Poll: return items with id greater than this (newest first). Pass the previous response's latestId.

before
integer<int64>

Load older: return items with id lower than this. Pass the previous response's nextCursor.

changedSince
string<date-time>

ISO 8601; with after, also re-send items whose updatedAt is later (headline rewrites, re-tagging). Pass the previous response's serverTime.

limit
integer

1–200, default 100.

tickers
string

Comma-separated tickers; items tagged with any of them.

cik
string

Numeric CIK or platform key; items whose primary company or a tagged company entity is this issuer.

topics
string

Comma-separated topic codes (see /news/topics); any of them.

sources
string

Comma-separated source codes (see /news/sources); any of them.

excludeSources
string

Comma-separated source codes to hide (the UI's Markets view hides agency releases, social posts and GDELT links).

excludeForms
string

Comma-separated filing form types to hide (e.g. 4,144,SC 13G); rows without a form are kept.

flash
enum<string>

1 to return flash (high-priority) items only.

Available options:
1
minImportance
integer

Minimum importance score 0–100.

Required range: 0 <= x <= 100
q
string

Full-text query over headline and snippet (websearch syntax: quoted phrases, OR, -exclusion).

Response

OK

items
object[]
required

Newest first.

latestId
integer<int64> | null
required

Highest id in the response (never below the caller's after); poll with after=latestId.

nextCursor
integer<int64> | null
required

Lowest id in the response when more rows exist below it; page older with before=nextCursor. null when exhausted.

serverTime
string<date-time>
required

Database time at query; pass back as changedSince on the next poll.