Concepts

What API v3 returns, one real example each. The endpoint pages carry every field.

What happened                         What accounts are doing
-------------                         -----------------------
entity (one id per asset family)      account or channel
   │ named by                            │ posts
   ▼                                     ▼
event ─threaded into─▶ storyline      call ─make up─▶ call episode
                          │ grouped into                 │ counted by
                          ▼                              ▼
                         arc            positioning (one asset, now)
                                        call book (whole market, hourly)

Where attention is: mindshare (assets), trending contracts (addresses)
Who to read:        standing (accounts)

Entity and Asset Family

An entity is anything Elfa gives an id: a token, equity, project, person or organisation. Entity filters take the id, never a name.

An asset family is one asset in all its forms, under one id:

q=btc                    ─▶  Bitcoin
q=wbtc                   ─▶  Bitcoin
q=0x2260fa…c599 (WBTC)   ─▶  Bitcoin
                             one id: b23e0b47-deec-4161-b49c-7e2652f07fe6

Filter on Bitcoin's id and you get its wrapped and bridged forms too. See Entities.

Event

One thing that happened, written up from the posts that reported it, with the entities it names and links to the posts. Never the posts' text.

US Treasury sanctions A7 Network over more than $17 billion in transfers
  eventClass    market          eventType     regulatory
  implication   bearish         alertAction   alert
  about         A7A5 (token)
  from posts    @WuBlockchain, @hupzy_agent, wublockchainenglish

eventClass	Is
market	A development reported across posts: a launch, a listing, a sanction, a macro story
asset	Posts about one asset, nothing wider
call	Several accounts taking positions on one asset

Only events worth showing are served: alert (impactful) or monitor (worth watching). See Events.

Storyline

One development followed over days: its events in order, each tagged with how it relates (origin, update, contradiction, …).

US Treasury and FinCEN target A7 network over sanctions evasion
  status    open
  events    5576024c…  origin    1 Oct 22:31 UTC
            df5e5c1a…  update    2 Oct 07:56 UTC   ← the sanctions event

open while events that add something arrive, dormant after three quiet days. Call events never join one. See Storylines.

Arc

Storylines that belong to one larger movement. Most storylines never join one.

Strategy Bitcoin treasury expansion and capital-raising episode
  storylines   Strategy says it has no fixed Bitcoin holdings target
               Strategy buys about 1,665 BTC, raising holdings to 847,666

See Arcs.

Call

One post in which an account or channel takes or changes a position:

callAction	The post…
open	takes a new long or short position
reaffirm	repeats a position already held
add	adds to it
trim	takes some off
reverse	flips it: closes the long and opens a short, or the reverse
close	closes it
stopOut	closes it because the stop was hit

@clintoptions, 1 Oct 17:24 UTC: open     SPY   (a long)
@clintoptions, 1 Oct 17:35 UTC: reaffirm SPY
@clintoptions, 1 Oct 17:40 UTC: trim     SPY
@clintoptions, 1 Oct 17:59 UTC: close    SPY

A call can also say how (setup) and why (thesis). See Calls.

Call Episode

One position, from the post that opened it to whatever closed it. The four calls above are one episode:

@clintoptions  long SPY  closed
  opened 1 Oct 17:24 UTC at 760.91 USD    closed 1 Oct 17:59 UTC at 760.91 USD
  closeReason: close
  calls: open -> reaffirm -> trim -> close

	Call	Call episode
Is	One post	One position
Carries	callAction, setup, thesis, the post id	Direction, prices, how it ended, opening terms, the author's track
Links by	episodeId	calls[].callId

An account holds at most one open episode per direction on an asset. See Call Episodes.

Call Book

The open episodes across a whole market, crypto or equities, hour by hour. Each account counts once.

2 Oct 08:55 UTC, live    long      accounts   crowdingPercentile
Crypto book              97.3%     9,778      99.4
Equity book              95.5%     2,652      17.1

The accounts we follow lean long almost always, so read crowdingPercentile: the lean against the book's last 28 days. Here crypto is unusually long; equities less than usual. See Call Books.

Positioning

Open longs and shorts on one asset, now. Counts, so assets compare by size.

Bitcoin, 2 Oct 2026:   openLong 3,252   openShort 402

See Positioning.

Mindshare and Hot

Mindshare is an asset's share of its market's attention in a period. Hot marks one whose last hour runs well ahead of its last four.

Equities, 4h, 2 Oct 2026:   1. NVDA   5.7%   (last hour 11.3%)   hot: true
                            2. MU     2.7%   (last hour  3.8%)   hot: true
                            3. PUMP   2.6%   (last hour  2.5%)   hot: false

Nvidia's last hour is twice its four-hour share: hot. ProPetro is nearly as loud over four hours but flat in the last: not. See Mindshare.

Trending Contracts

Raw contract addresses ranked by how many posts pasted them, named where we know the deployment. It finds tokens before they have a name.

1. oreoU2P8bN6jkk3jbaiVxYnG1dCXcYxwhwyK9jSybcp   113 posts   ORE (solana)
3. 4MMQY9bwkxxTtsK3W227Q5ABT6yFY8Pmn9Ze7wmAXKY8    77 posts   unnamed

See Trending Contracts.

Standing

How much other accounts engage with an account: a percentile from 0 to 1. Attention, not accuracy: for how its calls went, read its track.

Top accounts by standing, 2 Oct 2026:   1. blknoiz06   2. solana   3. elonmusk

See People.

History and servedFrom

Your plan sets how far back you can read: 30 days, 60 days or 2 years. Ask for more and the range is cut, not refused. A PAYG key on 2 October 2026:

GET /v3/events?from=1785801600       asked from 4 Aug 2026
-> "servedFrom": 1788307200          answered from 2 Sep 2026, 00:00 UTC

See History.