Skip to main content
A Ledger Activity row is a single financial event on an account’s ledger — a payment, withdrawal, refund, transfer, on-chain deposit, swap, or card transaction. Each row is derived from the underlying ledger lines and carries a typed resource and source so you can present and link the event without extra lookups. Use Ledger Activity to build a statement or transaction feed for an account or user. Reconcile against your own records with amount (signed, in the currency’s smallest precision units) and posted_at, and use available_at to know when inflows became withdrawable.

​
Endpoints

EndpointRequest
List Financial ActivityGET /financial-activity

​
Attributes

​
amount
string
required
Signed amount in the currency’s smallest precision units.
​
available_at
string | null
required
ISO 8601 timestamp these funds became (or are scheduled to become) withdrawable: the posted time for already-settled funds, or 00:00:00 UTC on the scheduled release date for pending funds. Present only on inflows entering the balance (payments, top-ups, incoming transfers/affiliate); null on withdrawals, refunds, disputes and on-chain rows. The available_after/before filters window on its UTC settlement date.
​
created_at
string | null
required
​
currency
object
required

Properties

​
code
string
required
​
precision
string
required
Precision factor for the currency, for example 100000000 for USD.
​
id
string
required
​
line_type
string
required
​
object
string
required
Available options: ledger_activity
​
posted_at
string
required
​
resource
account or user or ledger_account or payment_method or payout_method or card_transaction | null
required
​
source
object | null
required

Properties

​
amount_float
number | null
Withdrawal amount as a decimal number in the destination currency (withdrawal sources only; requires payout:withdrawal:read).
​
chain
string | null
Chain the deposit landed on, for example plasma (onchain_transaction sources only).
​
claim_url
string | null
Public claim URL for the airdrop link (airdrop_link sources only).
​
created_at
string | null
Withdrawal creation time as an ISO 8601 timestamp (withdrawal sources only; requires payout:withdrawal:read).
​
estimated_arrival
string | null
Estimated arrival as an ISO 8601 timestamp (withdrawal sources only; requires payout:withdrawal:read).
​
from_amount
string | null
Amount converted out of from_currency as a decimal string (swap sources only).
​
from_currency
string | null
Lowercase currency code converted from (swap sources only).
​
id
string
required
​
object
string
required
​
payer_name
string | null
Name of the entity processing the payout (withdrawal sources only; requires payout:withdrawal:read).
​
payout_destination
object | null
Payout destination display info (withdrawal sources only).

Properties

​
icon_url
string | null
​
payer_name
string | null
​
payout_token_nickname
string | null
Saved payout destination nickname (withdrawal sources only).
​
sender_address
string | null
Sender wallet address or onramp provider identifier (onchain_transaction sources only).
​
status
string | null
Lifecycle status. On withdrawal sources this is the withdrawal status (requires payout:withdrawal:read); on airdrop_link sources it is the claim-link status (ungated).
​
to_amount
string | null
Amount received in to_currency as a decimal string (swap sources only).
​
to_currency
string | null
Lowercase currency code converted to (swap sources only).
​
tx_hash
string | null
On-chain transaction hash (onchain_transaction and swap sources only).
LedgerActivity
{
	"object": "ledger_activity",
	"id": "line_cGF5bWVudF9ncm9zczpsaTpwZXRhbHBvc3Q6YWM6bGVkZ2VyOmxlOjE6djppazpyZWNlaXB0",
	"line_type": "payment_gross",
	"amount": "4800000000",
	"currency": {
		"code": "usd",
		"precision": "100000000"
	},
	"posted_at": "2026-06-14T18:49:49Z",
	"available_at": "2026-06-17T00:00:00Z",
	"created_at": "2026-06-14T18:49:49Z",
	"resource": {
		"object": "user",
		"id": "user_4Hk2mZ9qLpXa",
		"name": "Jordan Avery",
		"username": "jordanavery",
		"profile_picture_url": "https://cdn.whop.com/users/jordan-avery.png"
	},
	"source": {
		"object": "payment",
		"id": "pay_8QcR2mZ9qLpXa"
	}
}