v3 Calls

Call episodes

One account's position on one asset, from the call that opened it to whatever closed it, with its calls by id. An episode is served when it was open at any point between from and to, not only when it opened in that range.

calls lists only the calls inside the plan's history (the ones /calls serves when no from is given), so a position opened before it can come back with fewer calls, or none. Its position facts (openedAt, entryPrice, direction, status, and how it closed) are kept.

Each episode also carries the opening call's setup, thesis and stated target and stop, all null when that call is older than the plan's history, and track: the author's record over every position they have opened (alpha score, hit rate, average return), in every market and not cut to the plan's history.

Cost: 1 credit.

get/v3/calls/episodes

Request

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

Query parameters

fromnumber double

Unix seconds. Required unless episodeIds is sent.

tonumber double

Unix seconds. Default now.

episodeIdsstring[]

Up to 30. An id we do not hold, or older than the plan's history, is skipped.

handlestring

An X username, with or without the at sign.

entityIdsstring[]

Up to 30 asset family UUIDs.

status'open' | 'closed'
direction'long' | 'short'

Which way an account is positioned.

assetClass'crypto' | 'equity'

The market of the episode's asset.

order'desc' | 'asc'
limitnumber double

Default 10, maximum 30.

cursorstring

Response

Ok

nextCursorstring nullable required
hasMoreboolean required
servedFromnumber double nullable required

Changes

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