# Allowlist

> Control and inspect the run of an allowlist launch.

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).

Base URL: `https://api-mig.proxima.tools`

## Endpoints

- `POST /launch/allowlist/pause/{launch_id}`: Pause an allowlist run
- `POST /launch/allowlist/resume/{launch_id}`: Resume an allowlist run
- `POST /launch/allowlist/migrate/{launch_id}`: Migrate an allowlist run
- `POST /launch/allowlist/lock-lp/{launch_id}`: Lock allowlist liquidity
- `GET /launch/allowlist/status/{launch_id}`: Retrieve allowlist run status
- `GET /launch/allowlist/verification/{launch_id}`: Retrieve allowlist verification

## The Allowlist status object

Progress of an allowlist run: its state, the step in flight and the curve it trades.

- `ok` (boolean): Always `true` on success.
- `state` (enum): Run state. Possible values: `draft`, `planned`, `running`, `paused`, `finished`, `failed`.
- `driving` (boolean): `true` while the backend is settling a step it has in flight.
- `last_error` (string | null): Last error the run hit.
- `progress` (object): Counters.
  - `steps_done` (integer): Steps completed.
  - `steps_total` (integer): Steps in the run.
  - `trades_done` (integer): Trades completed.
  - `trades_total` (integer): Trades in the run.
  - `migrated` (boolean): Whether the pool has migrated.
- `current_step` (object | null): The step in flight.
  - `ordinal` (integer): Position of the step in the run.
  - `action_id` (string): Step identifier.
  - `attempt` (integer): Retry count.
  - `kind` (enum): Step kind. Possible values: `hook_init`, `add_wallets`, `seal`, `config`, `pool`, `trade`, `migrate`, `verify`, `lock_lp`.
  - `status` (enum): Step status. Possible values: `planned`, `signed`, `submitted`, `unknown`, `confirmed`, `failed`.
  - `wallet_index` (integer | null): Holder index for a trade step.
  - `side` (enum | null): Trade side. Possible values: `buy`, `sell`.
  - `tokens` (string | null): Token amount, raw units.
  - `quote` (string | null): Quote amount, raw units.
  - `quote_limit` (string | null): Quote limit of the trade, raw units.
  - `final_fill` (boolean): Whether this trade is the final fill.
  - `signature` (string | null): Transaction signature.
  - `error` (string | null): Error of the step.
- `eta_ms` (integer | null): Estimated time left, in milliseconds. `null` unless running or planned.
- `eta_at_ms` (integer | null): Estimated finish time, epoch milliseconds.
- `verification` (object | null): The latest [verification report](#object-allowlist-verification-report).
- `curve` (object): The curve the run trades.
  - `inputs` (object): The curve inputs the launch was created with (`budget`, `migration_fdv`, `opening_fdv`, `supply`, fee and interval settings). Numbers may come as strings.
  - `config` (object): The curve config, values as decimal strings.
  - `group` (array<string>): Holder wallets in the allowlist.
  - `plan` (object | null): The [plan summary](#object-allowlist-plan-summary).

```json
{
  "ok": true,
  "state": "running",
  "driving": true,
  "last_error": null,
  "progress": {
    "steps_done": 41,
    "steps_total": 214,
    "trades_done": 30,
    "trades_total": 203,
    "migrated": false
  },
  "current_step": {
    "ordinal": 41,
    "action_id": "cs:101000000004217:41:a0",
    "attempt": 0,
    "kind": "trade",
    "status": "submitted",
    "wallet_index": 7,
    "side": "buy",
    "tokens": "4500000000000",
    "quote": "182000000",
    "signature": null,
    "error": null
  },
  "eta_ms": 2950000,
  "eta_at_ms": 1793660950000,
  "verification": null,
  "curve": {
    "inputs": {
      "quote_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "budget": "36000000000",
      "migration_fdv": "250000000000"
    },
    "config": {},
    "group": [
      "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
      "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
    ],
    "plan": null
  }
}
```

## The Allowlist plan summary object

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.

- `quote_mint` (string): Quote mint of the curve.
- `quote_decimals` (integer): Decimals of the quote token.
- `wallets` (integer): Number of holder wallets in the group.
- `trades` (integer): Number of trades the run makes.
- `gross_buys` (string): Quote spent on buys, raw units.
- `sales` (string): Quote received from sells, raw units.
- `net_spend` (string): Net quote spent, raw units.
- `quote_needed` (string): Quote the group must hold, raw units.
- `sol_per_wallet` (integer): SOL each wallet needs, lamports.
- `dev_sol` (integer): SOL the dev wallet needs, lamports.
- `top_ten_bps` (integer): Share of supply the top ten holders end with, in basis points.
- `top_ten_limit_bps` (integer): Ceiling on that share, in basis points.
- `duration_ms` (integer): Planned duration of the run, in milliseconds.
- `exit_estimate` (object | null): Theoretical quote one sale of the group's tokens would bring.
  - `estimate` (boolean): Always `true`: a theoretical figure, never a promise.
  - `basis` (enum): `migration`: the pool the curve opens at its threshold; `pool`: the migrated pool now. Possible values: `migration`, `pool`.
  - `fee_bps` (integer): Pool fee used, in basis points.
  - `tokens` (string): Tokens sold in the estimate, raw units.
  - `quote_out` (string): Quote the sale would bring, raw units.
  - `fee` (string): Fee paid on the sale, raw units.

```json
{
  "quote_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "quote_decimals": 6,
  "wallets": 24,
  "trades": 203,
  "gross_buys": "41250000000",
  "sales": "6120000000",
  "net_spend": "35130000000",
  "quote_needed": "36000000000",
  "sol_per_wallet": 21000000,
  "dev_sol": 95000000,
  "top_ten_bps": 3120,
  "top_ten_limit_bps": 3500,
  "duration_ms": 3450000,
  "exit_estimate": {
    "estimate": true,
    "basis": "migration",
    "fee_bps": 100,
    "tokens": "120000000000000",
    "quote_out": "28410000000",
    "fee": "287000000"
  }
}
```

## The Allowlist verification report object

The acceptance checks of an allowlist run, read from the chain at request time.

- `ok` (boolean): `true` when every check passes.
- `checks` (array<object>): Acceptance checks read from the chain: `distinct_balances`, `group_sum`, `top_ten`, `sol_floor`, `allowlist_sealed`, `hook_removed`, `authorities`, `migrated`, `liquidity_locked` and `creator_position_held`.
  - `name` (string): Check name.
  - `ok` (boolean): Whether the check passes.
  - `detail` (string): What was measured.
- `exit_estimate` (object | null): Informative exit estimate; never a check.
  - `estimate` (boolean): Always `true`: a theoretical figure, never a promise.
  - `basis` (enum): `migration`: the pool the curve opens at its threshold; `pool`: the migrated pool now. Possible values: `migration`, `pool`.
  - `fee_bps` (integer): Pool fee used, in basis points.
  - `tokens` (string): Tokens sold in the estimate, raw units.
  - `quote_out` (string): Quote the sale would bring, raw units.
  - `fee` (string): Fee paid on the sale, raw units.

```json
{
  "ok": false,
  "checks": [
    {
      "name": "migrated",
      "ok": true,
      "detail": "pool migrated to DAMM v2"
    },
    {
      "name": "liquidity_locked",
      "ok": false,
      "detail": "creator position has unlocked liquidity"
    }
  ],
  "exit_estimate": {
    "estimate": true,
    "basis": "pool",
    "fee_bps": 100,
    "tokens": "120000000000000",
    "quote_out": "27980000000",
    "fee": "282000000"
  }
}
```

### Pause an allowlist run

`POST /launch/allowlist/pause/{launch_id}`

Stops the run before its next broadcast. (Bearer JWT · beta)

- 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_id` (string, required): Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).

#### Returns 200 OK

- `ok` (boolean): Always `true` on success.
- `state` (enum): Run state after the transition. Possible values: `draft`, `planned`, `running`, `paused`, `finished`, `failed`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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` | `launch 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` | `allowlist curve launches are open to beta licenses only` | 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 in a state that allows this` | The run is not `running` (it is `draft`, `planned`, `paused` or `failed`). | Read [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) and pause only a `running` run. |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is not on Solana. The body adds `chain`. | Call it only for Solana launches (IDs starting with `101`). |
| 404 | `not_found` | `this launch is not an allowlist curve launch` | 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 finished` | The run has already finished. | Nothing is left to drive; read the outcome with [Retrieve allowlist verification](/reference/allowlist/#get-allowlist-verification). |
| 409 | `conflict` | `the run moved meanwhile` | The run changed state between the check and the update, for example because it finished or failed meanwhile. | Read [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) and act on the state it reports. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/allowlist/pause/101000000004217" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "state": "paused"
}
```

### Resume an allowlist run

`POST /launch/allowlist/resume/{launch_id}`

Drives a paused or failed run from its first unfinished step. (Bearer JWT · beta)

- 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 `running` it answers 409.

A backend restart always leaves a run paused.

#### Path parameters

- `launch_id` (string, required): Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).

#### Returns 200 OK

- `ok` (boolean): Always `true` on success.
- `state` (enum): Run state after the transition. Possible values: `draft`, `planned`, `running`, `paused`, `finished`, `failed`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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` | `launch 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` | `allowlist curve launches are open to beta licenses only` | 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 in a state that allows this` | 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](/reference/launch-execution/#launch). |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is not on Solana. The body adds `chain`. | Call it only for Solana launches (IDs starting with `101`). |
| 404 | `not_found` | `this launch is not an allowlist curve launch` | 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 still settling its last step; resume once it is idle` | The backend is still settling the step that was in flight (`driving` is `true` in the status). | Wait until [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) reports `driving: false`, then resume. |
| 409 | `conflict` | `the run is finished` | The run has already finished. | Nothing is left to drive; read the outcome with [Retrieve allowlist verification](/reference/allowlist/#get-allowlist-verification). |
| 409 | `conflict` | `the run moved meanwhile` | The run changed state between the check and the update, for example because it finished or failed meanwhile. | Read [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) and act on the state it reports. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/allowlist/resume/101000000004217" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "state": "running"
}
```

### Migrate an allowlist run

`POST /launch/allowlist/migrate/{launch_id}`

Drives a run whose trades have all settled through migration and verification. (Bearer JWT · beta)

- 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_id` (string, required): Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).

#### Returns 200 OK

- `ok` (boolean): Always `true` on success.
- `state` (enum): Run state after the transition. Possible values: `draft`, `planned`, `running`, `paused`, `finished`, `failed`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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` | `launch 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` | `allowlist curve launches are open to beta licenses only` | 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 has not started` | The run is `draft` or `planned`: the launch has not started. | Start the launch first with [Launch a token](/reference/launch-execution/#launch). |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is not on Solana. The body adds `chain`. | Call it only for Solana launches (IDs starting with `101`). |
| 404 | `not_found` | `this launch is not an allowlist curve launch` | 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 curve's trades have not all settled` | A step before the migration (setup or trade) is not confirmed yet. | Wait until every trade is confirmed in [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status), then migrate. |
| 409 | `conflict` | `the run is still settling its last step; migrate once it is idle` | The run is `paused` or `failed` and the backend is still settling its last step. | Wait until [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) reports `driving: false`, then migrate. |
| 409 | `conflict` | `the run is finished` | The run has already finished. | Nothing is left to drive; read the outcome with [Retrieve allowlist verification](/reference/allowlist/#get-allowlist-verification). |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/allowlist/migrate/101000000004217" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "state": "running"
}
```

### Lock allowlist liquidity

`POST /launch/allowlist/lock-lp/{launch_id}`

Locks the unlocked liquidity of the creator position on the migrated pool. (Bearer JWT · beta)

- 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 answers `locked: "nothing left unlocked"`; it never locks twice. While the first call is still running, the repeat answers 422 `the 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.

> Irreversible: locked liquidity cannot be withdrawn.

#### Path parameters

- `launch_id` (string, required): Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).

#### Returns 200 OK

- `ok` (boolean): Always `true` on success.
- `lock` (object): The lock action.
  - `action_id` (string): Step identifier.
  - `signature` (string): Transaction signature.
  - `settled` (boolean): `true` when the call only settled a lock already in flight; no new transaction was sent.
  - `locked` (string): `"nothing left unlocked"` when every position is already locked; nothing is sent and no other field is set.
  - `positions` (array<object>): Positions locked.
    - `position` (string): Position account.
    - `liquidity` (string): Liquidity locked in it.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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` | `launch 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` | `allowlist curve launches are open to beta licenses only` | 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 pool has not migrated yet` | The migration step is not confirmed yet. | Run [Migrate an allowlist run](/reference/allowlist/#migrate-allowlist) and lock once [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) reports `progress.migrated: true`. |
| 400 | `unsupported_chain` | `this endpoint is not supported for this chain` | The launch is not on Solana. The body adds `chain`. | Call it only for Solana launches (IDs starting with `101`). |
| 404 | `not_found` | `this launch is not an allowlist curve launch` | 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` | `position <position> is held by <holder>, not by the run's dev wallet` | 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` | `the migration's positions are unknown: a keeper migrated this pool` | 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 run is busy; try again once it settles` | The backend is driving the run or settling another lock for this launch. | Wait until [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) reports `driving: false`, then try again. |
| 422 | `unprocessable` | `the lock was refused in simulation: <reason>` | 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. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/allowlist/lock-lp/101000000004217" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "lock": {
    "action_id": "cs:101000000004217:213:a0",
    "signature": "5VfYmGc8sT3kQ2xR9nLwP4hJ7dB6aZ1uE8yNvK3tXqMr2HcW9pLs5FjD7gA4bT6nY1kR8mQzV3xC2wE5uJ9hP7a",
    "positions": [
      {
        "position": "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX",
        "liquidity": "84512039111"
      }
    ]
  }
}
```

### Retrieve allowlist run status

`GET /launch/allowlist/status/{launch_id}`

Returns the run's state, progress, step in flight and curve. (Bearer JWT · beta)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

#### Path parameters

- `launch_id` (string, required): Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).

#### Returns 200 OK

Returns an Allowlist status object.

- `ok` (boolean): Always `true` on success.
- `state` (enum): Run state. Possible values: `draft`, `planned`, `running`, `paused`, `finished`, `failed`.
- `driving` (boolean): `true` while the backend is settling a step it has in flight.
- `last_error` (string | null): Last error the run hit.
- `progress` (object): Counters.
  - `steps_done` (integer): Steps completed.
  - `steps_total` (integer): Steps in the run.
  - `trades_done` (integer): Trades completed.
  - `trades_total` (integer): Trades in the run.
  - `migrated` (boolean): Whether the pool has migrated.
- `current_step` (object | null): The step in flight.
  - `ordinal` (integer): Position of the step in the run.
  - `action_id` (string): Step identifier.
  - `attempt` (integer): Retry count.
  - `kind` (enum): Step kind. Possible values: `hook_init`, `add_wallets`, `seal`, `config`, `pool`, `trade`, `migrate`, `verify`, `lock_lp`.
  - `status` (enum): Step status. Possible values: `planned`, `signed`, `submitted`, `unknown`, `confirmed`, `failed`.
  - `wallet_index` (integer | null): Holder index for a trade step.
  - `side` (enum | null): Trade side. Possible values: `buy`, `sell`.
  - `tokens` (string | null): Token amount, raw units.
  - `quote` (string | null): Quote amount, raw units.
  - `quote_limit` (string | null): Quote limit of the trade, raw units.
  - `final_fill` (boolean): Whether this trade is the final fill.
  - `signature` (string | null): Transaction signature.
  - `error` (string | null): Error of the step.
- `eta_ms` (integer | null): Estimated time left, in milliseconds. `null` unless running or planned.
- `eta_at_ms` (integer | null): Estimated finish time, epoch milliseconds.
- `verification` (object | null): The latest [verification report](#object-allowlist-verification-report).
- `curve` (object): The curve the run trades.
  - `inputs` (object): The curve inputs the launch was created with (`budget`, `migration_fdv`, `opening_fdv`, `supply`, fee and interval settings). Numbers may come as strings.
  - `config` (object): The curve config, values as decimal strings.
  - `group` (array<string>): Holder wallets in the allowlist.
  - `plan` (object | null): The [plan summary](#object-allowlist-plan-summary).

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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` | `launch 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` | `allowlist curve launches are open to beta licenses only` | 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` | `this endpoint is not supported for this chain` | The launch is not on Solana. The body adds `chain`. | Call it only for Solana launches (IDs starting with `101`). |
| 404 | `not_found` | `this launch is not an allowlist curve launch` | The launch exists but is not an allowlist curve launch. | Call it only for a Meteora DBC launch created with `create_params.allowlist`. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/allowlist/status/101000000004217" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "state": "running",
  "driving": true,
  "last_error": null,
  "progress": {
    "steps_done": 41,
    "steps_total": 214,
    "trades_done": 30,
    "trades_total": 203,
    "migrated": false
  },
  "current_step": {
    "ordinal": 41,
    "action_id": "cs:101000000004217:41:a0",
    "attempt": 0,
    "kind": "trade",
    "status": "submitted",
    "wallet_index": 7,
    "side": "buy",
    "tokens": "4500000000000",
    "quote": "182000000",
    "signature": null,
    "error": null
  },
  "eta_ms": 2950000,
  "eta_at_ms": 1793660950000,
  "verification": null,
  "curve": {
    "inputs": {
      "quote_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "budget": "36000000000",
      "migration_fdv": "250000000000"
    },
    "config": {},
    "group": [
      "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
      "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
    ],
    "plan": null
  }
}
```

### Retrieve allowlist verification

`GET /launch/allowlist/verification/{launch_id}`

Runs the run's acceptance checks against the chain and returns the report. (Bearer JWT · beta)

- 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_id` (string, required): Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).

#### Returns 200 OK

Returns `ok` and an Allowlist verification report object under `report`.

- `ok` (boolean): Always `true` on success.
- `report` (object): The verification report.
  - `ok` (boolean): `true` when every check passes.
  - `checks` (array<object>): Acceptance checks read from the chain: `distinct_balances`, `group_sum`, `top_ten`, `sol_floor`, `allowlist_sealed`, `hook_removed`, `authorities`, `migrated`, `liquidity_locked` and `creator_position_held`.
    - `name` (string): Check name.
    - `ok` (boolean): Whether the check passes.
    - `detail` (string): What was measured.
  - `exit_estimate` (object | null): Informative exit estimate; never a check.
    - `estimate` (boolean): Always `true`: a theoretical figure, never a promise.
    - `basis` (enum): `migration`: the pool the curve opens at its threshold; `pool`: the migrated pool now. Possible values: `migration`, `pool`.
    - `fee_bps` (integer): Pool fee used, in basis points.
    - `tokens` (string): Tokens sold in the estimate, raw units.
    - `quote_out` (string): Quote the sale would bring, raw units.
    - `fee` (string): Fee paid on the sale, raw units.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `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` | `launch 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` | `allowlist curve launches are open to beta licenses only` | 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` | `this endpoint is not supported for this chain` | The launch is not on Solana. The body adds `chain`. | Call it only for Solana launches (IDs starting with `101`). |
| 404 | `not_found` | `this launch is not an allowlist curve launch` | 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 not started` | The run is `draft` or `planned`, so there is nothing on chain to verify yet. | Call it once the launch has started. |
| 422 | `unprocessable` | `<reason>` | 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](/reference/allowlist/#get-allowlist-status). |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/allowlist/verification/101000000004217" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "report": {
    "ok": false,
    "checks": [
      {
        "name": "migrated",
        "ok": true,
        "detail": "pool migrated to DAMM v2"
      },
      {
        "name": "liquidity_locked",
        "ok": false,
        "detail": "creator position has unlocked liquidity"
      }
    ],
    "exit_estimate": {
      "estimate": true,
      "basis": "pool",
      "fee_bps": 100,
      "tokens": "120000000000000",
      "quote_out": "27980000000",
      "fee": "282000000"
    }
  }
}
```
