An allowlist launch is a Meteora DBC launch on Solana whose curve only a sealed group of the launch's own holders may buy. Once the launch starts, the backend drives the run step by step (hook, allowlist, seal, pool, trades, migration, verification); these endpoints pause, resume and inspect it, and lock the migrated liquidity.
Allowlist launches are in beta: every endpoint answers 403 unless the account has beta access. Raw amounts are decimal strings (6 decimals for both the base token and USDC).
The Allowlist status object
Progress of an allowlist run: its state, the step in flight and the curve it trades.
Attributes
-
okbooleanAlwaystrueon success. -
stateenumRun state.Possible valuesdraftplannedrunningpausedfinishedfailed -
drivingbooleantruewhile the backend is settling a step it has in flight. -
last_errorstring | nullLast error the run hit. -
progressobjectCounters.Child attributes 5
-
steps_doneintegerSteps completed. -
steps_totalintegerSteps in the run. -
trades_doneintegerTrades completed. -
trades_totalintegerTrades in the run. -
migratedbooleanWhether the pool has migrated.
-
-
current_stepobject | nullThe step in flight.Child attributes 13
-
ordinalintegerPosition of the step in the run. -
action_idstringStep identifier. -
attemptintegerRetry count. -
kindenumStep kind.Possible valueshook_initadd_walletssealconfigpooltrademigrateverifylock_lp -
statusenumStep status.Possible valuesplannedsignedsubmittedunknownconfirmedfailed -
wallet_indexinteger | nullHolder index for a trade step. -
sideenum | nullTrade side.Possible valuesbuysell -
tokensstring | nullToken amount, raw units. -
quotestring | nullQuote amount, raw units. -
quote_limitstring | nullQuote limit of the trade, raw units. -
final_fillbooleanWhether this trade is the final fill. -
signaturestring | nullTransaction signature. -
errorstring | nullError of the step.
-
-
eta_msinteger | nullEstimated time left, in milliseconds.nullunless running or planned. -
eta_at_msinteger | nullEstimated finish time, epoch milliseconds. -
verificationobject | nullThe latest verification report. -
curveobjectThe curve the run trades.Child attributes 4
-
inputsobjectThe curve inputs the launch was created with (budget,migration_fdv,opening_fdv,supply, fee and interval settings). Numbers may come as strings. -
configobjectThe curve config, values as decimal strings. -
grouparray<string>Holder wallets in the allowlist. -
planobject | nullThe plan summary.
-
The planned run of an allowlist launch, as the expected funding and the run status both report it. Raw amounts are decimal strings; lamport amounts are numbers.
Attributes
-
quote_mintstringQuote mint of the curve. -
quote_decimalsintegerDecimals of the quote token. -
walletsintegerNumber of holder wallets in the group. -
tradesintegerNumber of trades the run makes. -
gross_buysstringQuote spent on buys, raw units. -
salesstringQuote received from sells, raw units. -
net_spendstringNet quote spent, raw units. -
quote_neededstringQuote the group must hold, raw units. -
sol_per_walletintegerSOL each wallet needs, lamports. -
dev_solintegerSOL the dev wallet needs, lamports. -
top_ten_bpsintegerShare of supply the top ten holders end with, in basis points. -
top_ten_limit_bpsintegerCeiling on that share, in basis points. -
duration_msintegerPlanned duration of the run, in milliseconds. -
exit_estimateobject | nullTheoretical quote one sale of the group's tokens would bring.Child attributes 6
-
estimatebooleanAlwaystrue: a theoretical figure, never a promise. -
basisenummigration: the pool the curve opens at its threshold;pool: the migrated pool now.Possible valuesmigrationpool -
fee_bpsintegerPool fee used, in basis points. -
tokensstringTokens sold in the estimate, raw units. -
quote_outstringQuote the sale would bring, raw units. -
feestringFee paid on the sale, raw units.
-
The acceptance checks of an allowlist run, read from the chain at request time.
Attributes
-
okbooleantruewhen every check passes. -
checksarray<object>Acceptance checks read from the chain:distinct_balances,group_sum,top_ten,sol_floor,allowlist_sealed,hook_removed,authorities,migrated,liquidity_lockedandcreator_position_held.Child attributes 3
-
namestringCheck name. -
okbooleanWhether the check passes. -
detailstringWhat was measured.
-
-
exit_estimateobject | nullInformative exit estimate; never a check.Child attributes 6
-
estimatebooleanAlwaystrue: a theoretical figure, never a promise. -
basisenummigration: the pool the curve opens at its threshold;pool: the migrated pool now.Possible valuesmigrationpool -
fee_bpsintegerPool fee used, in basis points. -
tokensstringTokens sold in the estimate, raw units. -
quote_outstringQuote the sale would bring, raw units. -
feestringFee paid on the sale, raw units.
-
Pause an allowlist run
/launch/allowlist/pause/{launch_id} Stops the run before its next broadcast.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry Pausing a paused run changes nothing: the repeat answers 409
the run is not in a state that allows this.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
stateenumRun state after the transition.Possible valuesdraftplannedrunningpausedfinishedfailed
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 403 | forbidden | The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access. |
| 409 | conflict | The run is not running (it is draft, planned, paused or failed). Read Retrieve allowlist run status and pause only a running run. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 404 | not_found | The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with create_params.allowlist. |
| 409 | conflict | The run has already finished. Nothing is left to drive; read the outcome with Retrieve allowlist verification. |
| 409 | conflict | The run changed state between the check and the update, for example because it finished or failed meanwhile. Read Retrieve allowlist run status and act on the state it reports. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.allowlist.pause(launchId) src/lib/proxima/endpoints/launch/allowlist.ts
Resume an allowlist run
/launch/allowlist/resume/{launch_id} Drives a paused or failed run from its first unfinished step.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry The run journals every step and only one worker drives it, so a repeat never sends a step twice; on a run already
runningit answers 409.
A backend restart always leaves a run paused.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
stateenumRun state after the transition.Possible valuesdraftplannedrunningpausedfinishedfailed
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 403 | forbidden | The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access. |
| 409 | conflict | The run is draft, planned or already running; only a paused or failed run resumes. Resume only a paused or failed run; a planned run starts with Launch a token. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 404 | not_found | The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with create_params.allowlist. |
| 409 | conflict | The backend is still settling the step that was in flight (driving is true in the status). Wait until Retrieve allowlist run status reports driving: false, then resume. |
| 409 | conflict | The run has already finished. Nothing is left to drive; read the outcome with Retrieve allowlist verification. |
| 409 | conflict | The run changed state between the check and the update, for example because it finished or failed meanwhile. Read Retrieve allowlist run status and act on the state it reports. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.allowlist.resume(launchId) src/lib/proxima/endpoints/launch/allowlist.ts
Migrate an allowlist run
/launch/allowlist/migrate/{launch_id} Drives a run whose trades have all settled through migration and verification.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry The run journals every step and only one worker drives it, so a repeat never sends the migration twice; once the run has finished it answers 409
the run is finished.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
stateenumRun state after the transition.Possible valuesdraftplannedrunningpausedfinishedfailed
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 403 | forbidden | The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access. |
| 409 | conflict | The run is draft or planned: the launch has not started. Start the launch first with Launch a token. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 404 | not_found | The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with create_params.allowlist. |
| 409 | conflict | A step before the migration (setup or trade) is not confirmed yet. Wait until every trade is confirmed in Retrieve allowlist run status, then migrate. |
| 409 | conflict | The run is paused or failed and the backend is still settling its last step. Wait until Retrieve allowlist run status reports driving: false, then migrate. |
| 409 | conflict | The run has already finished. Nothing is left to drive; read the outcome with Retrieve allowlist verification. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.allowlist.migrate(launchId) src/lib/proxima/endpoints/launch/allowlist.ts
Lock allowlist liquidity
/launch/allowlist/lock-lp/{launch_id} Locks the unlocked liquidity of the creator position on the migrated pool.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Refused with
403 read_only_token. - Retry
- Safe to retry A repeat settles a lock still in flight (
settled: true) or answerslocked: "nothing left unlocked"; it never locks twice. While the first call is still running, the repeat answers 422the run is busy; try again once it settles.
Never automatic. Refused before the migration has settled, when a keeper migrated the pool first (the positions it opened are then unknown), and when a position is held by a wallet other than the run's dev wallet.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
-
okbooleanAlwaystrueon success. -
lockobjectThe lock action.Child attributes 7
-
action_idstringStep identifier. -
signaturestringTransaction signature. -
settledbooleantruewhen the call only settled a lock already in flight; no new transaction was sent. -
lockedstring"nothing left unlocked"when every position is already locked; nothing is sent and no other field is set. -
positionsarray<object>Positions locked.Child attributes 2
-
positionstringPosition account. -
liquiditystringLiquidity locked in it.
-
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 403 | forbidden | The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access. |
| 422 | unprocessable | The migration step is not confirmed yet. Run Migrate an allowlist run and lock once Retrieve allowlist run status reports progress.migrated: true. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 404 | not_found | The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with create_params.allowlist. |
| 422 | unprocessable | A position with unlocked liquidity is held by a wallet other than the run's dev wallet. Lock that position yourself from the wallet that holds its NFT. |
| 422 | unprocessable | A keeper migrated the pool before the run did, so the positions the migration opened are unknown. Lock the creator position outside Proxima, from the wallet that holds its NFT. |
| 422 | unprocessable | The backend is driving the run or settling another lock for this launch. Wait until Retrieve allowlist run status reports driving: false, then try again. |
| 422 | unprocessable | The lock transaction failed simulation; nothing was sent. Fix the cause given in message, for example the dev wallet's SOL for fees, then try again. |
Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.
Web client proxima.launch.allowlist.lockLp(launchId) src/lib/proxima/endpoints/launch/allowlist.ts
Retrieve allowlist run status
/launch/allowlist/status/{launch_id} Returns the run's state, progress, step in flight and curve.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
Returns an Allowlist status object.
-
okbooleanAlwaystrueon success. -
stateenumRun state.Possible valuesdraftplannedrunningpausedfinishedfailed -
drivingbooleantruewhile the backend is settling a step it has in flight. -
last_errorstring | nullLast error the run hit. -
progressobjectCounters.Child attributes 5
-
steps_doneintegerSteps completed. -
steps_totalintegerSteps in the run. -
trades_doneintegerTrades completed. -
trades_totalintegerTrades in the run. -
migratedbooleanWhether the pool has migrated.
-
-
current_stepobject | nullThe step in flight.Child attributes 13
-
ordinalintegerPosition of the step in the run. -
action_idstringStep identifier. -
attemptintegerRetry count. -
kindenumStep kind.Possible valueshook_initadd_walletssealconfigpooltrademigrateverifylock_lp -
statusenumStep status.Possible valuesplannedsignedsubmittedunknownconfirmedfailed -
wallet_indexinteger | nullHolder index for a trade step. -
sideenum | nullTrade side.Possible valuesbuysell -
tokensstring | nullToken amount, raw units. -
quotestring | nullQuote amount, raw units. -
quote_limitstring | nullQuote limit of the trade, raw units. -
final_fillbooleanWhether this trade is the final fill. -
signaturestring | nullTransaction signature. -
errorstring | nullError of the step.
-
-
eta_msinteger | nullEstimated time left, in milliseconds.nullunless running or planned. -
eta_at_msinteger | nullEstimated finish time, epoch milliseconds. -
verificationobject | nullThe latest verification report. -
curveobjectThe curve the run trades.Child attributes 4
-
inputsobjectThe curve inputs the launch was created with (budget,migration_fdv,opening_fdv,supply, fee and interval settings). Numbers may come as strings. -
configobjectThe curve config, values as decimal strings. -
grouparray<string>Holder wallets in the allowlist. -
planobject | nullThe plan summary.
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 403 | forbidden | The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 404 | not_found | The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with create_params.allowlist. |
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.launch.allowlist.status(launchId) src/lib/proxima/endpoints/launch/allowlist.ts
Retrieve allowlist verification
/launch/allowlist/verification/{launch_id} Runs the run's acceptance checks against the chain and returns the report.
- Token
- Upgraded session token, bound to a license.
- Read-only tokens
- Allowed.
- Retry
- Safe to retry Each call reads the chain again and stores the report as the run's latest
verification; nothing is sent.
Path parameters
-
launch_idstring RequiredLaunch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (101Solana,201BSC,202Base,204Ethereum).Example101000000004217
Returns 200 OK · application/json
Returns ok and an Allowlist verification report object under report.
-
okbooleanAlwaystrueon success. -
reportobjectThe verification report.Child attributes 12
-
okbooleantruewhen every check passes. -
checksarray<object>Acceptance checks read from the chain:distinct_balances,group_sum,top_ten,sol_floor,allowlist_sealed,hook_removed,authorities,migrated,liquidity_lockedandcreator_position_held.Child attributes 3
-
namestringCheck name. -
okbooleanWhether the check passes. -
detailstringWhat was measured.
-
-
exit_estimateobject | nullInformative exit estimate; never a check.Child attributes 6
-
estimatebooleanAlwaystrue: a theoretical figure, never a promise. -
basisenummigration: the pool the curve opens at its threshold;pool: the migrated pool now.Possible valuesmigrationpool -
fee_bpsintegerPool fee used, in basis points. -
tokensstringTokens sold in the estimate, raw units. -
quote_outstringQuote the sale would bring, raw units. -
feestringFee paid on the sale, raw units.
-
-
Errors
| Status | Code | When and what to do |
|---|---|---|
| 400 | bad_request | launch_id is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it. |
| 404 | not_found | No launch with this ID belongs to the license in your token. Check the launch ID and that your token is upgraded onto the license that owns the launch. |
| 403 | forbidden | The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access. |
| 400 | unsupported_chain | The launch is not on Solana. The body adds chain. Call it only for Solana launches (IDs starting with 101). |
| 404 | not_found | The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with create_params.allowlist. |
| 409 | conflict | The run is draft or planned, so there is nothing on chain to verify yet. Call it once the launch has started. |
| 422 | unprocessable | The checks could not be read from the chain, for example an RPC read failed or an account the run created no longer exists. Retry in a few seconds; the last stored report stays available as verification in Retrieve allowlist run status. |
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.launch.allowlist.verification(launchId) src/lib/proxima/endpoints/launch/allowlist.ts