v3 Events

Arcs

Storylines belonging to the same larger movement, with a summary and every storyline by id. Reconciled hourly, and most storylines never join one.

By default, arcs by when they last changed. assetClass, entityIds or sort read the app's narrative list instead: active arcs in a market or about an asset, newest event first, or by how many storylines or events they hold. That list holds active arcs only, newest first, so it cannot be combined with arcIds, status=retired or order=asc, and it starts at the plan's history on the newest event.

q searches arcs by topic, best match first, within status. It serves the first 100 matches that clear a minimum relevance; arcIds, assetClass, entityIds, sort and order=asc are refused with it.

Cost: 1 credit.

get/v3/events/arcs

Request

  • Base URL: https://api.elfa.ai
  • URL: https://api.elfa.ai/v3/events/arcs
  • Auth: API key in header x-elfa-api-key

Query parameters

qstring

Topic to search for, up to 500 characters. Ranks by relevance.

arcIdsstring[]

Up to 30. An id we do not hold is skipped.

status'active' | 'retired'

Default active.

assetClass'crypto' | 'equity'

Arcs where at least 15% of the shown events name an asset in this market, then arcs in neither market (macro news), each group in sort order. Counts and recency leave out events tagged only for the other market.

entityIdsstring[]

Up to 30 asset family UUIDs. A person, project or organisation is refused.

sort'latest' | 'storylines' | 'events'

latest (newest event), storylines or events (most first).

order'desc' | 'asc'
limitnumber double

Default 10, maximum 30.

cursorstring

Response

Ok

nextCursorstring nullable required
hasMoreboolean required

Changes

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