Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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.

One recorded action.

Attributes

  • id string
    64-bit event ID as a string. Also the pagination cursor.
  • created_at integer
    Time of the event in Unix seconds (UTC).
  • license_key string | null
    License the event belongs to; null for system events. Declared by the client type; the current backend does not send it.
  • event_type string
    Dotted 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_id enum | null
    Chain of the event, or null.
    Possible values solbscethbaserobinhoodarcxlayer
  • launch_ext_id string | null
    Launch ext_id as a string, or null when the event is not tied to a launch.
  • payload object
    Event-specific data. Keys depend on event_type; atomic amounts are integer strings.
    Child attributes 7
    • tx_hashes array<string>
      Transactions the action sent.
    • transfers array<object>
      Per-wallet legs with wallet, tx_hash, status (success, failed, planned, skipped) and amounts.
    • mint string | null
      Token mint or contract address involved.
    • platform string
      Launchpad involved.
    • amount_native_atomic string
      Native amount in base units (lamports, wei).
    • origin enum
      On withdraw events: which wallets were drained. license_wallets is the legacy spelling of global.
      Possible values launchagedgloballicense_wallets
    • status string
      On withdraw events: lifecycle status, e.g. collecting, settling, completed.
GET /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

  • cursor string Required Default 0
    next_cursor of the previous page, or 0 for the first page.
  • limit integer Optional Default 50
    Events per page, from 1 to 100.
  • type string Optional
    Comma-separated event types to include, e.g. launch.create,launch.deploy_mev.
  • launch_ext_id string Optional
    Restrict to one launch.
  • chain enum Optional
    Restrict to one chain.
    Possible values solbscethbaserobinhoodxlayer
  • since string Optional
    Lower bound on created_at in Unix seconds, inclusive.
    Example1790985600
  • until string Optional
    Upper bound on created_at in Unix seconds, inclusive.
    Example1793663999

Returns 200 OK · application/json

  • events array<object>
  • next_cursor string | null
    Cursor for the next page, or null when there are no more events.

Errors

StatusCodeWhen 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

GET /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_id string Required
    The launch ext_id.
    Example101920010239643

Query parameters

  • cursor string Required Default 0
    next_cursor of the previous page, or 0 for the first page.
  • limit integer Optional Default 50
    Events per page, from 1 to 100.
  • type string Optional
    Comma-separated event types to include.
  • chain enum Optional
    Restrict to one chain.
    Possible values solbscethbaserobinhoodxlayer
  • since string Optional
    Lower bound in Unix seconds, inclusive.
  • until string Optional
    Upper bound in Unix seconds, inclusive.

Returns 200 OK · application/json

  • events array<object>
  • next_cursor string | null
    Cursor for the next page, or null.

Errors

StatusCodeWhen 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 JWT internal
GET /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

  • cursor string Required Default 0
    next_cursor of the previous page, or 0 for the first page.
  • limit integer Optional Default 50
    Events per page, from 1 to 100.
  • type string Optional
    Comma-separated event types to include.
  • chain enum Optional
    Restrict to one chain.
    Possible values solbscethbaserobinhoodxlayer
  • since string Optional
    Lower bound in Unix seconds, inclusive.
  • until string Optional
    Upper bound in Unix seconds, inclusive.

Returns 200 OK · application/json

  • events array<object>
  • next_cursor string | null
    Cursor for the next page, or null.
  • dropped_total integer
    Events the writer has shed since start because its queue was full. Not read by the web app.

Errors

StatusCodeWhen 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