The developer surface is assembling the current API contract, Realness playground sample, proof-state gate, and public source packet. API examples and score fields stay withheld until the measured payload resolves.
Developer contract read pending.
No fallback API rows, quiet-zero Realness sample, proof-state claim, or fabricated public post is shown while this loads.
Fingerprints prove scan eligibility and coverage, not forecasts. Sample: AGI, BEAM, GOOGL, IREN, MARA, META, RKLB, SYM.
Realness API
A public playground for “is this attention organic?”
The live Realness route is unavailable for this sample, so the playground degrades to snapshot context. AD withholds the route response instead of inventing a clean API read.
Statesnapshot context onlyWe don't publish verdicts we haven't proven.
sample tickerUAMYWe don't publish verdicts we haven't proven.
real AD/$not measured
organic scorepending
coordinatedpending
evidence62%
density19.1
public evidence12 readable / 43 measured
Snapshot fallbackunavailable31 counted-only
X · public social evidence · public X authorpublic X author
UAMY stock is probably at its lowest price point now or soon. It's a stock that you want to…
+ 11 more public posts in the API (12 readable). Same shape.
validation gaterealness-api-proof-state-gate-v1
proof_stateunproven
allowed usemeasurement context only
marketabilitywithheld
scorecard pinscorecard-v1:8d0be43309d7f1d0
Realness stays context-only until the B2 gate earns a veto.
Blocked: awaiting blinded operator labels.
Response spine
Realness API preview fields
Field
Meaning
ticker
Display symbol carried with the stable instrument_id.
quality_adjusted_density
Real attention per market-cap dollar: attention_density x organic_score, nullable until measured.
organic_score
0 to 1 measured anti-coordination score; null stays building, never inferred from pump risk.
manufactured_probability
0 to 1 aggregate coordination measurement, never a named accusation.
validation_gate
Scorecard proof_state, allowed feed use, and context-only withholding until proven.
attention_integrity
Evidence coverage/reliability read for the attention measurement.
top_posts[]
Bounded public post excerpts with source/evidence labels and post hashes.
posture
Always measurement_not_advice; no execution instruction.
Measurement, not advice.Realness is aggregate coordination measurement, never a named accusation.Public X authors only from provider expansions; no profile dossiers or PII exports.Public post excerpts stay bounded by provider/source receipts.
Advanced receiptsSupporting evidence, provider, and ingestion proof stays available.6 receipts
Post evidence
Curated posts declare their provenance.
Show post source and evidence labels; pin top_posts_sort.
Curated post evidence states for snapshot top posts
State
Source example
UI label
Client meaning
fixture
privacy_safe_fixture
fixture evidence
Synthetic dev/test evidence shape. Not live social text.
Channel-plan validation keeps fingerprints, counts, status, and no-subscribe posture stable before WebSocket subscriptions open.
Deep social retrieval
Deep social search shows its filter path.
Social search returns count-only retrieval and quality receipts.
receiptdeep-social-retrieval-receipt-v1
requestsocial.deep_search
contextticker/company gate
storagecount-only
Retrievedposts_retrieved
Official API posts returned after provider query and dedupe.
Context gateposts_after_direct_context_gate
Posts that mention the ticker or company context before analysis.
Quality gatesposts_after_quality_gates
Posts left after spam, source, substance, language, time, and duplicate gates.
Counts move through published gates so paid search is auditable without storing raw prompts or raw social text.
Live transports
Same tape, explicit delivery contracts.
Bounded public REST reads and the site stream are live. Direct v1 SSE and WebSocket hosts remain pending until isolated long-lived transport is published.
Public live transport surfaces for Attention API v1
decision systems after Hub key and host activation
ssecanonicalauth
const events = new EventSource(
"/api/snapshot/leaderboard/stream?limit=25&interval=5",
);
events.addEventListener("snapshot", ({ data }) => {
const frame = JSON.parse(data);
const rows = frame.leaderboard ?? [];
for (const row of rows) {
const ad = row.core_kpi_values?.attention_density ?? row.attention_density ?? null;
console.log(row.ticker, ad, row.anomaly_band);
}
});
EventSource cannot send custom headers, so the browser uses the same-origin site stream. Direct v1 SSE and WebSocket URLs stay unpublished until client isolation and an upgrade-capable canonical host are live.
Model Context Protocol
The methodology is itself a tool.
With repository access, launch the source-pinned server. Its 17 tools keep each value with its receipt.
Attention MCP tool catalog (17 tools)
Tool
What it returns
attention_leaderboard
Tickers ranked by Attention Density (social activity per $1B market cap).
attention_ticker
Attention Density detail for one ticker.
attention_bot_feed
Structured attention signals (ranking input, never an execution trigger).
attention_signals
Recent signal events with the shared core KPI receipt and cursor contract.
attention_ticker_signals
Ticker-scoped signal history with the shared core KPI receipt.
attention_buckets
Market-cap bucket cohorts ranked through the shared core KPI contract.
attention_themes
Per-theme attention overview plus top ticker cohorts with core KPI receipts.
attention_watchlist
A saved watchlist ranked through the same core KPI contract as the tape.
attention_core_kpis
The published core KPI catalog for resolving compact core_kpis receipts.
sso_contract
The published Signal Ontology (every metric's formula + inputs) + fingerprint and JSON Schema.
attention_snapshot_leaderboard
Live Attention Density ranking snapshot.
attention_as_of
Point-in-time archive replay over the tape with a no-lookahead receipt.
attention_state_changes
Bounded state-change push ledger from the local tape archive.
attention_live_diagnostics
Tape health measurable today: snapshot/cycle/ticker counts, turnover, attention regime.
scorecard_summary
The citable validation snapshot: per-signal verdict/IC/significance/power + FDR survivors.
reputation_scorecard
The citable author-graph validation: does credibility predict, hold, and persist.
attention_attestation
The single trust receipt binding SSO, scorecard, reputation, and archive integrity fingerprints.
launchcall
# Requires access to the private source repository and configured Git credentials:
uvx --from 'attention-density[mcp] @ git+https://github.com/FlyingMobula5/AttentionDensity@41aa1b1659cde4aac09ac4857d8c7aecf1edacd4' attention-density-mcp
# Alternatives:
# pipx run --spec 'attention-density[mcp] @ git+https://github.com/FlyingMobula5/AttentionDensity@41aa1b1659cde4aac09ac4857d8c7aecf1edacd4' attention-density-mcp
# python -m pip install '.[mcp]' && python -m attention_density.mcp.server
# First call — Fetch the published Signal Ontology before consuming any KPI value.
{
"tool": "sso_contract",
"arguments": {}
}
No public package or source release exists. Repository access is required. The Git command is pinned to 41aa1b1659cd.
Endpoints
KPI API surface.
Public reads are live on this origin. Keyed, metered, and long-lived rows remain path contracts until their canonical host migration is complete.
Primary KPI API paths
Surface
Method
Path
Payload
Access
KPI catalog
GET
/v1/core-kpis
five field definitions
public
API scope
GET
/v1/api-scope
payload boundary
public
Leaderboard
GET
/v1/snapshot/leaderboard
ranked KPI rows
public current snapshot
Ticker
GET
/v1/snapshot/ticker/{ticker}
single-name KPI packet
public current + replay
Realness API
GET
/v1/realness/{ticker}
measurement + withheld veto gate
public · verdict gated
Signals
GET
/v1/bot-feed/signals
typed event envelopes
Hub key · host migration pending
Full route inventory3 groups · 24 routes
01Snapshot tapecurrent and historical leaderboard payloads
Current and ?as_of ticker reads are public. The keyed-feed contract is host-pending; after activation, missing or invalid Hub keys return a typed401. MarketSchema owns keys and pricing.
Accounts open soon — measurements are free to read.
PUBLICHTTP 200
currenttickerpublic
replay?as_ofpublic
/health and /metrics are public on the canonical origin./openapi.json, /docs, and /redoc remain host-pending until the complete public route contract migrates.
401jsonhub
# Contract example — canonical keyed host migration pending.
GET /v1/bot-feed/signals?limit=1
{
"error_contract": "api-error-envelope-v1",
"error": "unauthorized",
"message": "missing or invalid API key",
"status_code": 401,
"request_id": "req_01JKEYPENDING",
"detail": "missing or invalid API key"
}
# Keys and pricing live at the hub. Accounts open soon.
Errors
Failures use one public envelope.
api-error-envelope-v1 covers validation, access, and runtime failures.
