PMWallets
中文
Leaderboard

One entity in full

Figures, badges, PnL curve, wallets and recent fills. Subscribers (active push or plan) open any entity, spending 1 daily distinct-entity unit; others only the free sample or entities they paid to unlock. A raw address you do not hold: 403 not_unlocked with handle and price. Never charges.

GET/v1/entities/{id}API key

Path parameters

idstringrequired

A 12-character entity handle (Crockford base32, e.g. 7KQ2MF9X4B1C) or a full 0x address (40 hex).

Query parameters

periodstring

Window id (30d or 7d). Default 30d.

Response

periodIdstring
entityIdstring

Handle, or the address if you hold it.

labelstring
tierstring

Allowed values: freesubscriber

revealedboolean
revealCentsinteger

Unlock price now (0 = free band).

viaPlanboolean
planPlanUsage

The caller's plan and what is left of its unlock allowance (present when signed in).

subscribedboolean
badgesstring[]
tagVersioninteger
categoriesobject[]
statsobject

The window figures (same fields as a board row, plus wr/lo/hi).

historyobject | null

Set when a notable share of markets were opened before the ledger begins.

dataSourcestring

Allowed values: livefrozen

dataPeriodIdstring
dataAsOfstring | null
statusstring

Allowed values: activequietdormant

statusAsOfstring | null
pnlCurveobject

PnL from genesis to the end of each day.

walletsobject[]
fillsEntityFill[]
tagsobject
fillSampleinteger

Row cap applied to fills (100 subscribed, else 10).

fillsDelayedMsinteger

0 when subscribed, else 900000 (15 min).

viewsobject

Subscriber tier: the distinct-entity budget after this call.

Responses

200OK
400Not a handle or 0x address, unknown handle, or unknown period.
401No valid API key (missing, malformed, unknown or revoked).
403error: not_unlocked (address you do not hold; body has entityId = handle, label, revealCents), the daily distinct-entity limit, or outside the free sample (needs a subscription or a paid unlock).
404No published stats for this entity in the window.
429Rate limited. Per IP 240/min overall and 180/min on the board and entity routes; per account 120/min (anonymous 60/min per IP) on board, entity and market reads. A retry-after header may be set.
503Temporarily unavailable; nothing was charged. Retry shortly.