PMWallets
中文
Live fills

Follow an entity (live fills)

Pushes the entity's fills to your WebSocket/webhook. Unlock its address first (402 address_not_unlocked). CHARGES 1 cent now for the first hour, then hourly until canceled (free within plan push slots). Spends 1 daily distinct-entity unit. Starts ~96 s (65 blocks) behind the head.

POST/v1/account/subscriptionsAPI keySpends balance

Request body

entityIdstringrequired

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

channelsstring[]default:ws

Where to deliver. Default ["ws"].

acceptInactiveboolean

Subscribe even if the entity has had no fill for 7 days (otherwise 409).

Response

idstring
userIdstring
chaininteger
entityIdstring

The 0x address once paid for and still held; a handle otherwise (never-charged or plan-locked rows).

labelstring
channelsstring[]
statusstring

Allowed values: activepausedcanceled

pausedReasonstring | null

e.g. insufficient_balance, webhook_disabled, no_webhook, plan_ended, plan_limit, address_locked.

fromBlockinteger

Fills strictly after this block are delivered.

syncedBlockinteger
tierstring
priceCentsinteger

Hourly price frozen on the subscription.

billedThroughstring | null

Prepaid up to here.

planCoveredboolean

The last billed hour was covered by a plan push slot (free).

activationsinteger
createdAtstring
canceledAtstring | null
followedAtstring | null
categoriesobject[]

List endpoint only.

lastFillTsstring | null

List endpoint only.

fills24hinteger | null

List endpoint only.

Responses

201Subscribed, first hour paid (HTTP 201). Hours with no feed are not charged; pauses when the balance runs out. At most 200 active.
400Bad entityId/channels, or 200 active subscriptions already.
401No valid API key (missing, malformed, unknown or revoked).
402error: address_not_unlocked (unlock it first), or not enough balance for the first hour (priceCentsPerHour, balanceCents). Nothing charged.
403Daily distinct-entity limit reached.
404Entity is not in any published window.
409Dormant entity (resend with acceptInactive: true), already subscribed, a concurrent create, or the only channel is a missing/switched-off webhook. Nothing charged.
503Fill feed or chain head unavailable; nothing charged.