Skip to main content
GET
cURL
What are app fees?
An API key is required. A wallet linked to your integrator returns its whole ledger, including balanceAfter; any other wallet returns the events your integrator caused on it, plus deposits and settled withdrawals — a narrower result, not an error. For current balances rather than history, use Get App Fee Balances.

Headers

x-api-key
string

API key. Required.

Path Parameters

wallet
string
required

Wallet address. A wallet linked to your integrator returns its full ledger; any other returns the events your integrator caused on it, plus deposits and settled withdrawals, which are public on-chain.

Query Parameters

requestId
string

Return only events belonging to this request.

requestIds
string

Comma-separated request ids, at most 20 per call. Use a type and time range instead for a reconciliation sweep.

type
string

Comma-separated event types to filter by. Events matching any of the given types are returned. Omit for all. Supported values: fee-credit, fee-sponsorship-payment, fee-sponsorship-refund, gasless-refund, balance-withdraw, balance-deposit, gas-sponsorship-payment, fixed-rate-credit, fixed-rate-debit, fixed-bps-pnl, fast-fill-hold, fast-fill-release, admin-manual-adjustment.

chainId
number | null

Restrict to one chain.

currency
string | null

Restrict to one currency. Pair with chainId for non-EVM currencies.

startTimestamp
number | null

Only events created at or after this unix timestamp, in seconds.

endTimestamp
number | null

Only events created at or before this unix timestamp, in seconds.

limit
number | null
default:20

Maximum number of events to return per page.

Required range: 1 <= x <= 50
continuation
string | null

Pagination cursor returned by a previous response. Pass it back to fetch the next page.

Response

Default Response

wallet
string
events
object[]
continuation
string | null