Launches
List every account's launches with revenue and referral figures, and read any launch.
Admin launch endpoints read launches across all accounts, for the admin launches table, the dashboard and the launch setup inspector.
Amounts come in pairs: *_usd in micro-USD and *_native in lamports or wei, all as integer strings.
The Admin launch object
A launch as listed in the admin launches table, with its owner, trading figures and the revenue and referral it produced.
Attributes
-
chain_idstringProxima chain id. -
launch_idstringLaunch id. -
mint_pubkeystringToken address. -
launch_platformstringLaunchpad. -
launch_methodstring | nullLaunch method. -
launch_statusstringLaunch status. -
created_atintegerCreation time, Unix seconds. -
launched_atintegerLaunch time, Unix seconds. -
archivedbooleanWhether the owner archived the launch. -
scheduled_modebooleanWhether the launch was scheduled. -
has_launch_planbooleanWhether the launch has a launch plan. -
is_importedbooleanWhether the token was imported rather than launched through Proxima. -
holder_countinteger | nullToken holder count. -
namestringToken name. -
symbolstringToken symbol. -
descriptionstringToken description. -
image_urlstring | nullToken image URL. -
token_decimalsintegerToken decimals. -
total_supplystring | nullTotal supply, as a string. -
quote_mintstring | nullQuote token address. -
websitestring | nullWebsite link. -
twitterstring | nullX link. -
telegramstring | nullTelegram link. -
kindenumlaunchfor a single launch,groupfor a launch group,memberfor a launch inside a group.Possible valueslaunchgroupmember -
group_idstring | nullLaunch group id. -
group_dispositionenum | nullOutcome of a group member.Possible valueswinnerdisposedattempt -
tag_idsarray<integer>Ids of the owner's tags on the launch. -
pnl_nativestringP&L, in lamports or wei, as an integer string. -
pnl_usdstringP&L, in micro-USD, as an integer string. -
gross_volume_nativestringGross volume, in lamports or wei, as an integer string. -
gross_volume_usdstringGross volume, in micro-USD, as an integer string. -
total_buy_nativestringTotal bought, in lamports or wei, as an integer string. -
total_buy_usdstringTotal bought, in micro-USD, as an integer string. -
total_sell_nativestringTotal sold, in lamports or wei, as an integer string. -
total_sell_usdstringTotal sold, in micro-USD, as an integer string. -
mm_pnl_nativestringMarket-making P&L, in lamports or wei, as an integer string. -
mm_pnl_usdstringMarket-making P&L, in micro-USD, as an integer string. -
extra_rewards_nativestringExtra rewards, in lamports or wei, as an integer string. -
extra_rewards_usdstringExtra rewards, in micro-USD, as an integer string. -
gross_revenue_nativestringFees Proxima earned on the launch, in lamports or wei, as an integer string. -
gross_revenue_usdstringFees Proxima earned on the launch, in micro-USD, as an integer string. -
license_keystringOwner's license key. -
referrer_license_keystring | nullLicense key of the owner's referrer. -
referrer_usernamestring | nullUsername of the owner's referrer. -
referrer_account_idstring | nullAccount id of the owner's referrer. -
referral_paid_nativestringReferral paid on the launch, in lamports or wei, as an integer string. -
referral_paid_usdstringReferral paid on the launch, in micro-USD, as an integer string. -
referral_unpaid_nativestringReferral still owed on the launch, in lamports or wei, as an integer string. -
referral_unpaid_usdstringReferral still owed on the launch, in micro-USD, as an integer string. -
referral_unpaid_statusenumsettlingwhile a queued sweep will still pay the unpaid referral.Possible valuessettledsettlingrequires_reconciliation -
revenue_net_nativestringRevenue after referral, in lamports or wei, as an integer string. -
revenue_net_usdstringRevenue after referral, in micro-USD, as an integer string. -
referral_fee_rate_currentintegerRate the owner earns on its referrals, in basis points. Do not recompute paid or net amounts with it. -
owner_account_idstring | nullOwner's account id. -
owner_usernamestring | nullOwner's username. -
owner_display_namestring | nullOwner's display name. -
owner_avatar_urlstring | nullOwner's avatar URL. -
sharedbooleanAt least one live sharing grant on the launch. -
sharingobject | nullPresent when the launch has live grants or pending invites.Child attributes 2
-
membersarray<object>Licenses the launch is shared with:grant_id,username,display_name,avatar_url,granted_by,depth,operations,export_keys_count,allow_future_wallets,expires_atandcreated_at(Unix seconds). -
pending_invitesintegerNumber of pending invites.
-
List launches
/admin/launches Returns a filtered, sorted page of launches across all accounts.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
List filters take comma-separated values. Empty filters and chain_id=all are left out of the query string.
Query parameters
-
limitinteger OptionalPage size. The API defaults to 50 and caps at 200. -
offsetinteger OptionalNumber of rows to skip. -
chain_idstring OptionalComma-separated chain ids, such assol,base. -
account_idstring OptionalRestricts the results to one owner account. -
referrer_account_idstring OptionalRestricts the results to launches of the accounts this account referred. -
searchstring OptionalFree-text search. -
launch_statusstring OptionalComma-separated launch statuses. -
platformstring OptionalComma-separated launchpads. -
launch_methodstring OptionalComma-separated launch methods:mev,block0,stagger,manual. -
is_importedboolean OptionalFilters on imported tokens. -
scheduled_modeboolean OptionalFilters on scheduled launches. -
archivedboolean OptionalFilters on archived launches. -
sharedboolean OptionalFilters on launches with a live sharing grant. -
launched_frominteger OptionalEarliest launch time, Unix seconds, inclusive. -
launched_tointeger OptionalLatest launch time, Unix seconds, inclusive. -
order_byenum OptionalSort column. The API refusesowner_username.Possible valueslaunched_atcreated_atlaunch_idlicense_keyowner_usernamepnl_usdpnl_nativegross_volume_usdgross_volume_nativegross_revenue_usdgross_revenue_nativereferral_paid_usdreferral_paid_nativeholder_countnamesymbollaunch_platformlaunch_statuschain_id -
orderenum OptionalSort direction.Possible valuesascdesc
Returns 200 OK · application/json
-
itemsarray<object>Launches on this page. See Admin launch. -
totalintegerTotal number of matching launches. -
limitintegerApplied page size. -
offsetintegerApplied offset. -
native_mixedbooleantruewhen the results span several chains, so native amounts are not in a single unit. -
unitsobjectUnit labels for the amounts in the response.Child attributes 3
-
usdstringUnit of the USD amounts. -
nativestringUnit of the native amounts. -
timestringUnit of the timestamps.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | order_by is not a sortable column; the API refuses owner_username. An order other than asc or desc answers invalid order: <order>. Sort on another order_by column, with order set to asc or desc. |
| 400 | bad_request | A chain_id, launch_status, platform or launch_method value is unknown. The message lists the accepted values. Use only the values the message lists. |
| 400 | bad_request | launched_from or launched_to is too large to be read as a date. Send the time in Unix seconds. |
| 404 | not_found | No account has this account_id. Take the account_id from List users. |
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.admin.listLaunches(query) src/lib/proxima/endpoints/admin.ts
List a user's launches
/admin/launches/{username} Returns a page of one user's launches.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
usernamestring RequiredUsername of the owner.
Query parameters
-
limitinteger OptionalPage size. The API defaults to 50 and caps at 200. -
offsetinteger OptionalNumber of rows to skip. -
chain_idstring OptionalComma-separated chain ids, such assol,base. -
searchstring OptionalFree-text search. -
launch_statusstring OptionalComma-separated launch statuses. -
platformstring OptionalComma-separated launchpads. -
launch_methodstring OptionalComma-separated launch methods:mev,block0,stagger,manual. -
is_importedboolean OptionalFilters on imported tokens. -
scheduled_modeboolean OptionalFilters on scheduled launches. -
archivedboolean OptionalFilters on archived launches. -
sharedboolean OptionalFilters on launches with a live sharing grant. -
launched_frominteger OptionalEarliest launch time, Unix seconds, inclusive. -
launched_tointeger OptionalLatest launch time, Unix seconds, inclusive. -
order_byenum OptionalSort column. The API refusesowner_username.Possible valueslaunched_atcreated_atlaunch_idlicense_keyowner_usernamepnl_usdpnl_nativegross_volume_usdgross_volume_nativegross_revenue_usdgross_revenue_nativereferral_paid_usdreferral_paid_nativeholder_countnamesymbollaunch_platformlaunch_statuschain_id -
orderenum OptionalSort direction.Possible valuesascdesc
Returns 200 OK · application/json
-
itemsarray<object>Launches on this page. See Admin launch. -
totalintegerTotal number of matching launches. -
limitintegerApplied page size. -
offsetintegerApplied offset. -
native_mixedbooleantruewhen the results span several chains, so native amounts are not in a single unit. -
unitsobjectUnit labels for the amounts in the response.Child attributes 3
-
usdstringUnit of the USD amounts. -
nativestringUnit of the native amounts. -
timestringUnit of the timestamps.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | order_by is not a sortable column; the API refuses owner_username. An order other than asc or desc answers invalid order: <order>. Sort on another order_by column, with order set to asc or desc. |
| 400 | bad_request | A chain_id, launch_status, platform or launch_method value is unknown. The message lists the accepted values. Use only the values the message lists. |
| 400 | bad_request | launched_from or launched_to is too large to be read as a date. Send the time in Unix seconds. |
| 404 | not_found | No account has this username. Use a username returned by List users. |
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.admin.listLaunchesByUsername(username, query) src/lib/proxima/endpoints/admin.ts
Retrieve a launch
/admin/get-launch-info/{launch_id} Returns the full configuration and wallets of any account's launch.
- Token
- Upgraded session token of an account with admin rights.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Same shape as the owner's GET /launch/get-launch-info/{launch_id}, readable for any launch. The admin launch setup modal shows it. Wallet secrets are not included.
Path parameters
-
launch_idstring RequiredLaunch id.
Returns 200 OK · application/json
Returns a launch info object. The main fields are listed below.
-
chain_idstringProxima chain id. -
launch_methodenumLaunch method.Possible valuesMevStaggerManualAllowlist -
funding_typeenumHow the wallets were funded.Possible valuesClassicCex -
is_graduatedbooleanWhether the token left its bonding curve. -
creator_feesintegerUncollected creator fees, in base units of the native or quote token. See Collect creator fees. -
buy_delayintegerDelay between holder buys, in milliseconds. -
devobject | nullDev wallet. -
funderobjectFunder wallet. -
holderarray<object>Holder wallets. -
front_mevarray<object>Front MEV wallets. -
back_mevarray<object>Back MEV wallets. -
temp_holderarray<object>Temporary holder wallets. -
pnl_nativestringP&L, in lamports or wei, as an integer string. -
pnl_usdstringP&L, in micro-USD, as an integer string. -
gross_volume_nativestringGross volume, in lamports or wei, as an integer string. -
gross_volume_usdstringGross volume, in micro-USD, as an integer string. -
extra_rewards_nativestringExtra rewards in native base units, as a string. -
extra_rewards_usdstringExtra rewards, in micro-USD, as an integer string. -
mm_pnl_nativestringMarket-making profit and loss in native base units, as a string. -
mm_pnl_usdstringMarket-making profit and loss, in micro-USD, as an integer string.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a valid launch id. Use a launch id returned by List launches. |
| 404 | not_found | No launch has this id. Use a launch id returned by List launches. |
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.admin.getLaunchInfo(launchId) src/lib/proxima/endpoints/admin.ts