Documentation

See how Hyperfeed records market reality.

The public feed lets you inspect real, source-cited events before connecting live access. It uses the same event model, evidence trail, filters, and cursors as the production API. Only the newest events are held back.

Open eval manifest View OpenAPI Read API reference

Public access

real events, 7-day delay

Live edge

paid API key

Model

same event contract

Format

JSON + OpenAPI

delayed 7devent detail

200 OK

typeheadlinesources

cfo_departedJennifer Wilson departed as Chief Financial Officer at SIFCO INDUSTRIES INC2

{
  "event_id": "evt_c18949163707d7b17d3a645f",
  "event_type": "cfo_departed",
  "status": "filed_pending_effective",
  "assertion_type": "fact",
  "confirmation_level": "sec_item_5_02_filed",
  "announced_at": "2026-02-03T21:11:13Z",
  "entity": {
    "name": "SIFCO INDUSTRIES INC",
    "type": "company"
  },
  "identifiers": {
    "primary_ticker": "SIF",
    "primary_exchange": "NYSE"
  },
  "headline": "Jennifer Wilson departed as Chief Financial Officer...",
  "source_count": 2
}

Endpoints

One contract, two access windows.

GET

/v1/public/events

Public, delayed

Inspect the event tape with filters, limits, and cursor pagination.

GET

/v1/public/events/{event_id}

Public, delayed

Open sources, evidence spans, lifecycle fields, payload, and links.

GET

/v1/events

Paid, live

Move the same event contract to the live market edge.

Quickstart

Work from the real tape.

No mock payloads, no curated demo rows. Pull real events, open the source trail, test pagination, then move the same integration to paid live access when recency matters.

Public list

curl "https://api.hyperfeed.io/v1/public/events?limit=10&ticker=AAPL"

Public detail

curl "https://api.hyperfeed.io/v1/public/events/evt_c18949163707d7b17d3a645f"

Paid live API

curl "https://api.hyperfeed.io/v1/events?limit=10&ticker=AAPL" \
  -H "Authorization: Bearer hf_live_..."

Delta polling

curl "https://api.hyperfeed.io/v1/events?updated_since=2026-04-20T00:00:00Z&limit=100" \
  -H "Authorization: Bearer hf_live_..."

Event Object

The useful unit is the event, not the article.

Event identity

event_idevent_typestatusassertion_typeconfirmation_level

Market subject

entityidentifierspersonsubjectsobjectsrelated_entities

Event lifecycle

observed_atannounced_ateffective_dateupdated_ataction_semantics

Evidence trail

sourcessource_claim_idsevidencedeeplink_urlquoted_text

Evidence span

{
  "field_path": "effective_date",
  "quoted_text": "Jennifer Wilson notified the Board...",
  "validation_status": "verified",
  "deeplink_url": "https://www.sec.gov/Archives/..."
}

Evidence is field-level.

Detail responses include quote-backed spans and deep links so a client can verify why a visible field exists. The API does not ask you to trust a summary without the source trail.

Machine-readable

Discovery files are part of the surface.

/llms.txt

Discovery file with the product summary, entrypoints, and commercial boundary.

/ai/eval.json

Structured manifest for automated inspection of endpoints, rubric, and expected output.

/ai/evaluation-prompt.md

Plain-language evaluation prompt for agents reviewing data quality and integration fit.

Commercial boundary

Public access proves the event contract on delayed real data. Paid access removes the delay and adds production limits, webhooks, watchlists, and broader history.

See pricing