Activity history
Page through the activity events recorded for an account, a launch, or the system.
Every significant action is recorded as an activity event: launches and deploys, trades, automation runs, withdrawals, wallet and key operations, funding, account changes. Each event has an event_type, an optional chain and launch, and an event-specific payload.
The feeds are cursor-paginated, newest first. Pass cursor=0 for the first page, then the previous page's next_cursor until it is null. Event id and launch_ext_id are 64-bit integers sent and kept as strings.
In the web app these feed the Logs page, the history panel of a live launch, the funder history and the admin system logs.
The Activity event object
One recorded action.
Attributes
-
idstring64-bit event ID as a string. Also the pagination cursor. -
created_atintegerTime of the event in Unix seconds (UTC). -
license_keystring | nullLicense the event belongs to;nullfor system events. Declared by the client type; the current backend does not send it. -
event_typestringDotted event type. Families:launch.*,buy,withdraw,autobuy.*,autosell.*,volume.*,fake_volume.*,cleanup.*,sniper_guard.*,mm.*,wallet.*,keys.*,funding.*,shield.*,staking.*,referral.claim,auth.*,marketplace.purchase,admin.*,system.*. -
chain_idenum | nullChain of the event, ornull.Possible valuessolbscethbaserobinhoodarcxlayer -
launch_ext_idstring | nullLaunchext_idas a string, ornullwhen the event is not tied to a launch. -
payloadobjectEvent-specific data. Keys depend onevent_type; atomic amounts are integer strings.Child attributes 7
-
tx_hashesarray<string>Transactions the action sent. -
transfersarray<object>Per-wallet legs withwallet,tx_hash,status(success,failed,planned,skipped) and amounts. -
mintstring | nullToken mint or contract address involved. -
platformstringLaunchpad involved. -
amount_native_atomicstringNative amount in base units (lamports, wei). -
originenumOnwithdrawevents: which wallets were drained.license_walletsis the legacy spelling ofglobal.Possible valueslaunchagedgloballicense_wallets -
statusstringOnwithdrawevents: lifecycle status, e.g.collecting,settling,completed.
-
List activity events
/history Lists the caller's activity events, newest first.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Backs the Logs page and the funder history. The SDK always sends cursor, using 0 for the first page; the app requests 50 events per page.
Query parameters
-
cursorstring Requirednext_cursorof the previous page, or0for the first page. -
limitinteger OptionalEvents per page, from 1 to 100. -
typestring OptionalComma-separated event types to include, e.g.launch.create,launch.deploy_mev. -
launch_ext_idstring OptionalRestrict to one launch. -
chainenum OptionalRestrict to one chain.Possible valuessolbscethbaserobinhoodxlayer -
sincestring OptionalLower bound oncreated_atin Unix seconds, inclusive.Example1790985600 -
untilstring OptionalUpper bound oncreated_atin Unix seconds, inclusive.Example1793663999
Returns 200 OK · application/json
-
eventsarray<object>Activity event objects. -
next_cursorstring | nullCursor for the next page, ornullwhen there are no more events.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain is not one of the supported chains. Send sol, bsc, eth, base, robinhood or xlayer, or omit chain. |
| 400 | bad_request | cursor is not a 64-bit integer. Send 0 for the first page, then the previous page's next_cursor. |
| 400 | bad_request | launch_ext_id is not a 64-bit integer. Send the launch ext_id as a decimal string. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.history.getHistory(query) src/lib/proxima/endpoints/history.ts
List a launch's activity events
/history/launch/{launch_id} Lists the activity events of one launch, newest first.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Backs the history panel of a live launch, which refreshes it every 2 seconds. Takes the same query parameters as List activity events except launch_ext_id; the path wins.
Path parameters
-
launch_idstring RequiredThe launchext_id.Example101920010239643
Query parameters
-
cursorstring Requirednext_cursorof the previous page, or0for the first page. -
limitinteger OptionalEvents per page, from 1 to 100. -
typestring OptionalComma-separated event types to include. -
chainenum OptionalRestrict to one chain.Possible valuessolbscethbaserobinhoodxlayer -
sincestring OptionalLower bound in Unix seconds, inclusive. -
untilstring OptionalUpper bound in Unix seconds, inclusive.
Returns 200 OK · application/json
-
eventsarray<object>Activity event objects. -
next_cursorstring | nullCursor for the next page, ornull.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | The launch ID in the path is not a 64-bit integer. Pass the launch ext_id as a decimal string. |
| 400 | bad_request | chain is not one of the supported chains. Send sol, bsc, eth, base, robinhood or xlayer, or omit chain. |
| 400 | bad_request | cursor is not a 64-bit integer. Send 0 for the first page, then the previous page's next_cursor. |
| 403 | forbidden | The caller reaches the launch through a share that does not carry history.read. Ask the owner to add history.read to your grant. |
Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.
Web client proxima.history.getLaunchHistory(launchExtId, query) src/lib/proxima/endpoints/history.ts
List system events
/admin/system-events Lists events recorded by the platform itself rather than by an account.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Backs the admin Logs page. Returns only events with no license, such as system.boot and system.session_restart.*. Takes the same query parameters as List activity events except launch_ext_id.
Query parameters
-
cursorstring Requirednext_cursorof the previous page, or0for the first page. -
limitinteger OptionalEvents per page, from 1 to 100. -
typestring OptionalComma-separated event types to include. -
chainenum OptionalRestrict to one chain.Possible valuessolbscethbaserobinhoodxlayer -
sincestring OptionalLower bound in Unix seconds, inclusive. -
untilstring OptionalUpper bound in Unix seconds, inclusive.
Returns 200 OK · application/json
-
eventsarray<object>Activity event objects. -
next_cursorstring | nullCursor for the next page, ornull. -
dropped_totalintegerEvents the writer has shed since start because its queue was full. Not read by the web app.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | chain is not one of the supported chains. Send sol, bsc, eth, base, robinhood or xlayer, or omit chain. |
| 400 | bad_request | cursor is not a 64-bit integer. Send 0 for the first page, then the previous page's next_cursor. |
| 403 | forbidden | The caller is not an admin. Call it with an admin account's session. |
Also the common errors: 401 for a missing or expired session, 403 forbidden without the admin role and 429 when rate limited.
Web client proxima.history.getSystemEvents(query) src/lib/proxima/endpoints/history.ts