API access3 classes
Reliable delivery of the public measurement surface.
api.snapshot1 Tokenrequest
api.batch_ticker2 Tokensticker in batch
api.history3 Tokensrequest
LISTENING TO THE TAPE…
Token model
Tokens meter delivery and interpretation.
Scores, interesting posts, methodology, and the public scorecard stay open. Tokens meter authenticated API delivery, Vega reads, and deeper social search.
UNITProduct Tokens
- Free surface
- scores · posts · methodology · scorecard
- Metered lanes
- API · Vega · deep social
- Billing state
- ledger first · checkout later
Tokens are product usage units, not provider tokens, API authentication keys, or crypto assets.
Metered lanes
Three paid paths, one unit.
Every request class has a public Token cost before billing exists. Cached reads still record the event; fresh reads also record provider costs.
Vega interpretations2 classes
Specialist reads over already assembled attention context.
vega.post_read4 Tokenspost
vega.ticker_read8 Tokensread
Deep social search1 classes
Expanded official-API retrieval before Vega synthesis.
social.deep_search25 Tokensticker search
Token estimator
Model a session before checkout exists.
Change request counts to see how API delivery, Vega interpretations, and deep social search convert into product Tokens.
Modeled profileSample sessionpreset request mix
Estimate id
estimate-v1:ccefb2d5local calculation · no ledger writePricingcontract backed
Estimatelocal only
Ledgerpending durable writes
Checkoutdisabled
Estimated Token total6 active request classes
After modeled sessioncovered by modeled balance
API access28 Tokens41% of modeled spend
Vega interpretations16 Tokens23% of modeled spend
Deep social search25 Tokens36% of modeled spend
API delivery units19 unitsmetered every request
Cache-eligible Vega reads3 readsreuse until context changes
Expanded social searches1 searchofficial API plus model path
Provider-cost exposure4 eventsmodel/API cost only when fresh
| Request class | Count | Lane | Token delta | Unit | Cache | Provider cost | Gate |
|---|---|---|---|---|---|---|---|
| api.snapshot | 12 | API access | -12 Tokens | request | meter every authenticated API request | API delivery only | not generated output |
| api.history | 2 | API access | -6 Tokens | request | meter every authenticated historical/as-of request | API delivery only | not generated output |
| api.batch_ticker | 5 | API access | -10 Tokens | ticker in batch | meter per ticker included in the batch payload | API delivery only | not generated output |
| vega.ticker_read | 1 | Vega interpretations | -8 Tokens | read | cache until material attention context changes | model cost when fresh | drop-on-violation gate |
| vega.post_read | 2 | Vega interpretations | -8 Tokens | post | cache by post id/hash plus ticker context version | model cost when fresh | drop-on-violation gate |
| social.deep_search | 1 | Deep social search | -25 Tokens | ticker search | cache by ticker/query/window until material attention context changes | official API + model cost | drop-on-violation gate |
Execution path
A paid read has a visible lifecycle.
Tokens meter the path from request class to context identity, compliance gate, and future accounting row. Checkout stays disabled until the durable ledger exists.
The public pricing catalog fixes the Token unit before a request runs.
Ticker, snapshot, post/query hashes, and methodology fingerprints identify context.
Cached reads reuse output; fresh reads record provider costs; Vega output can be dropped.
Future durable writes store accounting fields, not raw social text or raw author IDs.
API access
API delivery spends Tokens by request class.
The public site stays open. Authenticated API usage pays for freshness, history, batch delivery, webhooks, and machine-readable SSO payloads.
| Request class | Token cost | Surface | Coverage |
|---|---|---|---|
| api.snapshot | 1 Token per request | current snapshot, ticker, theme, scorecard, or SSO API read | Builder API · Pro API · Institutional / Partner API |
| api.history | 3 Tokens per request | point-in-time, candle, leaderboard history, ticker history, or archive-window read | Pro API · Institutional / Partner API |
| api.batch_ticker | 2 Tokens per ticker in batch | watched ticker or batch payload | Pro API · Institutional / Partner API |
Freesite scores · posts · methodology · scorecard
MeteredREST · SSE · websocket · batch/history exports
Not soldraw social data · raw author IDs · advice
Vega interpretations
Vega reads reuse proprietary context.
The paid interpretation lane spends Tokens on grounded reads over the assembled attention tape, curated posts, cache identity, and compliance gate.
cached8 Tokens
cached ticker-level Vega interpretation
8 Tokens per paid ticker-level Vega read; cached reads reuse the existing compliant output and record model_cost as 0
- request
- vega.ticker_read
- model call
- cached output reuse
- ledger
- user_id · request_class · token_delta · ticker · context_pack_id
- privacy
- Store the context_pack_id and cache key, not a raw user prompt.
fresh8 Tokens
fresh ticker-level Vega interpretation
8 Tokens per fresh ticker-level Vega read over the assembled attention context
- request
- vega.ticker_read
- model call
- fresh provider call
- ledger
- user_id · request_class · token_delta · ticker · context_pack_id
- privacy
- The ledger stores the context pack reference, model, cost, and compliance result, not the raw prompt.
cached_or_fresh4 Tokens
post-level Vega deep dive
4 Tokens per curated-post Vega read; cached reads still record the request with cache_status=cached
- request
- vega.post_read
- model call
- fresh provider call
- ledger
- user_id · request_class · token_delta · ticker · post_hash
- privacy
- Use post hashes and bounded excerpts; never store raw author IDs or handles.
Compliancedrop on violation
Disclaimer required: yes. Failed outputs return no paid result: yes. Cached reads are still metered: yes.
Access tiers
The public product remains useful.
The paid layer is reliability, freshness, history, exports, webhooks, and context compute. The trust surface stays visible.
Public siteFree
The free funnel: scores, interesting posts, methodology, and proof-in-public content.
- metering
- none
- freshness
- site-rendered current snapshot and digest; no API delivery SLA
- history
- current public snapshot only
- webhooks
- none
Builder API1 Token
Reliable programmatic delivery of the free public measurement surface.
- metering
- metered per authenticated API request
- freshness
- current snapshot reads and SSO payloads
- history
- latest snapshot plus short rolling histories for app displays
- webhooks
- none
Pro API1 Token · 3 Tokens · 2 Tokens
API access for active builders, power users, and bot terminals that need history and delivery guarantees.
- metering
- metered per snapshot, history, and batch ticker request
- freshness
- current REST, SSE, and websocket reads with higher limits
- history
- point-in-time reads, candles, ticker history, and bounded archive windows
- webhooks
- filtered webhook alerts
Institutional / Partner API1 Token · 3 Tokens · 2 Tokens
The archive and standard as a partner-grade API product without selling raw social data.
- metering
- contracted Token schedule over the same API request classes
- freshness
- custom cadence, higher throughput, and partner delivery windows
- history
- full point-in-time archive subject to contracted retention controls
- webhooks
- webhooks, audit logs, and partner delivery
Example ledger
A Token event is an accounting row.
These examples show how usage will be recorded once the durable ledger is live: request class, count, Token delta, cache status, and provider-cost posture.
| Example | Request class | Token delta | Cache | Provider cost |
|---|---|---|---|---|
| API monitoring pass | 12 x api.snapshot (request) | -12 Tokens | not_applicable | API delivery only |
| Archive replay | 3 x api.history (request) | -9 Tokens | not_applicable | API delivery only |
| Vega evidence pass | 1 x vega.ticker_read (read) · 2 x vega.post_read (post) | -16 Tokens | cached_or_fresh | fresh read records model cost |
| Deep social sweep | 1 x social.deep_search (ticker search) | -25 Tokens | cached_or_fresh | fresh search records official API + model cost |
Public receipts
The Token model has inspectable contracts.
Each paid path is backed by a public machine-readable contract before checkout exists. The app sells delivery and interpretation around proprietary context, not raw social data.
| Layer | Path | Proves | State |
|---|---|---|---|
| Pricing | /v1/tokens/pricing | request classes, Token units, and cache policy | public |
| API packaging | /v1/tokens/api-packaging | free site surface vs Token-metered delivery | public |
| Methodology | /v1/tokens/methodology | how cached and fresh reads spend Tokens | public |
| Compliance | /v1/tokens/compliance-policy | Vega output gate and drop-on-violation status | public |
| Context identity | /v1/tokens/context-pack/schema | stable cache identity without raw prompts or handles | public |
| Ledger event | /v1/tokens/ledger/schema | Token deltas, provider costs, and compliance status | contract first |
| Deep social | /v1/tokens/social-deep-dive/spec | expanded official-API retrieval and evidence caps | contract first |
01Token ledger event contract is public
02Durable DB ledger follows before checkout
03Compliance gate required for every Vega output