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

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

## Endpoints

- `GET /admin/launches`: List launches
- `GET /admin/launches/{username}`: List a user's launches
- `GET /admin/get-launch-info/{launch_id}`: Retrieve a launch

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

- `chain_id` (string): Proxima chain id.
- `launch_id` (string): Launch id.
- `mint_pubkey` (string): Token address.
- `launch_platform` (string): Launchpad.
- `launch_method` (string | null): Launch method.
- `launch_status` (string): Launch status.
- `created_at` (integer): Creation time, Unix seconds.
- `launched_at` (integer): Launch time, Unix seconds.
- `archived` (boolean): Whether the owner archived the launch.
- `scheduled_mode` (boolean): Whether the launch was scheduled.
- `has_launch_plan` (boolean): Whether the launch has a launch plan.
- `is_imported` (boolean): Whether the token was imported rather than launched through Proxima.
- `holder_count` (integer | null): Token holder count.
- `name` (string): Token name.
- `symbol` (string): Token symbol.
- `description` (string): Token description.
- `image_url` (string | null): Token image URL.
- `token_decimals` (integer): Token decimals.
- `total_supply` (string | null): Total supply, as a string.
- `quote_mint` (string | null): Quote token address.
- `website` (string | null): Website link.
- `twitter` (string | null): X link.
- `telegram` (string | null): Telegram link.
- `kind` (enum): `launch` for a single launch, `group` for a launch group, `member` for a launch inside a group. Possible values: `launch`, `group`, `member`.
- `group_id` (string | null): Launch group id.
- `group_disposition` (enum | null): Outcome of a group member. Possible values: `winner`, `disposed`, `attempt`.
- `tag_ids` (array<integer>): Ids of the owner's tags on the launch.
- `pnl_native` (string): P&L, in lamports or wei, as an integer string.
- `pnl_usd` (string): P&L, in micro-USD, as an integer string.
- `gross_volume_native` (string): Gross volume, in lamports or wei, as an integer string.
- `gross_volume_usd` (string): Gross volume, in micro-USD, as an integer string.
- `total_buy_native` (string): Total bought, in lamports or wei, as an integer string.
- `total_buy_usd` (string): Total bought, in micro-USD, as an integer string.
- `total_sell_native` (string): Total sold, in lamports or wei, as an integer string.
- `total_sell_usd` (string): Total sold, in micro-USD, as an integer string.
- `mm_pnl_native` (string): Market-making P&L, in lamports or wei, as an integer string.
- `mm_pnl_usd` (string): Market-making P&L, in micro-USD, as an integer string.
- `extra_rewards_native` (string): Extra rewards, in lamports or wei, as an integer string.
- `extra_rewards_usd` (string): Extra rewards, in micro-USD, as an integer string.
- `gross_revenue_native` (string): Fees Proxima earned on the launch, in lamports or wei, as an integer string.
- `gross_revenue_usd` (string): Fees Proxima earned on the launch, in micro-USD, as an integer string.
- `license_key` (string): Owner's license key.
- `referrer_license_key` (string | null): License key of the owner's referrer.
- `referrer_username` (string | null): Username of the owner's referrer.
- `referrer_account_id` (string | null): Account id of the owner's referrer.
- `referral_paid_native` (string): Referral paid on the launch, in lamports or wei, as an integer string.
- `referral_paid_usd` (string): Referral paid on the launch, in micro-USD, as an integer string.
- `referral_unpaid_native` (string): Referral still owed on the launch, in lamports or wei, as an integer string.
- `referral_unpaid_usd` (string): Referral still owed on the launch, in micro-USD, as an integer string.
- `referral_unpaid_status` (enum): `settling` while a queued sweep will still pay the unpaid referral. Possible values: `settled`, `settling`, `requires_reconciliation`.
- `revenue_net_native` (string): Revenue after referral, in lamports or wei, as an integer string.
- `revenue_net_usd` (string): Revenue after referral, in micro-USD, as an integer string.
- `referral_fee_rate_current` (integer): Rate the owner earns on its referrals, in basis points. Do not recompute paid or net amounts with it.
- `owner_account_id` (string | null): Owner's account id.
- `owner_username` (string | null): Owner's username.
- `owner_display_name` (string | null): Owner's display name.
- `owner_avatar_url` (string | null): Owner's avatar URL.
- `shared` (boolean): At least one live sharing grant on the launch.
- `sharing` (object | null): Present when the launch has live grants or pending invites.
  - `members` (array<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_at` and `created_at` (Unix seconds).
  - `pending_invites` (integer): Number of pending invites.

```json
{
  "chain_id": "sol",
  "launch_id": "18234",
  "mint_pubkey": "Pp3T3fAScMGZUxEMhYc34Bju7BTD5kF1z36adQsuMjdF",
  "launch_platform": "pumpfun",
  "launch_method": "Mev",
  "launch_status": "Finalized",
  "created_at": 1791980000,
  "launched_at": 1791980400,
  "archived": false,
  "scheduled_mode": false,
  "has_launch_plan": false,
  "is_imported": false,
  "holder_count": 211,
  "name": "Sample Token",
  "symbol": "SMPL",
  "description": "An example launch.",
  "image_url": null,
  "token_decimals": 6,
  "total_supply": "1000000000",
  "quote_mint": "So11111111111111111111111111111111111111112",
  "website": null,
  "twitter": null,
  "telegram": null,
  "kind": "launch",
  "group_id": null,
  "group_disposition": null,
  "tag_ids": [],
  "pnl_native": "4120000000",
  "pnl_usd": "768000000",
  "gross_volume_native": "96400000000",
  "gross_volume_usd": "17980000000",
  "total_buy_native": "46140000000",
  "total_buy_usd": "8606000000",
  "total_sell_native": "50260000000",
  "total_sell_usd": "9374000000",
  "mm_pnl_native": "0",
  "mm_pnl_usd": "0",
  "extra_rewards_native": "0",
  "extra_rewards_usd": "0",
  "gross_revenue_native": "2210000000",
  "gross_revenue_usd": "412000000",
  "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
  "referrer_license_key": "AFFILIATE01-Qm4Tz8Lp2Xc7Vb9Nw",
  "referrer_username": "affiliate01",
  "referrer_account_id": "3d6201aa-c053-4969-af46-2ba4b92d54ac",
  "referral_paid_native": "331500000",
  "referral_paid_usd": "61800000",
  "referral_unpaid_native": "0",
  "referral_unpaid_usd": "0",
  "referral_unpaid_status": "settled",
  "revenue_net_native": "1878500000",
  "revenue_net_usd": "350200000",
  "referral_fee_rate_current": 1500,
  "owner_account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
  "owner_username": "demouser",
  "owner_display_name": "Demo User",
  "owner_avatar_url": null,
  "shared": false,
  "sharing": null
}
```

### List launches

`GET /admin/launches`

Returns a filtered, sorted page of launches across all accounts. (Admin JWT · internal)

- 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

- `limit` (integer, optional, default "50"): Page size. The API defaults to 50 and caps at 200.
- `offset` (integer, optional, default "0"): Number of rows to skip.
- `chain_id` (string, optional): Comma-separated chain ids, such as `sol,base`.
- `account_id` (string, optional): Restricts the results to one owner account.
- `referrer_account_id` (string, optional): Restricts the results to launches of the accounts this account referred.
- `search` (string, optional): Free-text search.
- `launch_status` (string, optional): Comma-separated launch statuses.
- `platform` (string, optional): Comma-separated launchpads.
- `launch_method` (string, optional): Comma-separated launch methods: `mev`, `block0`, `stagger`, `manual`.
- `is_imported` (boolean, optional): Filters on imported tokens.
- `scheduled_mode` (boolean, optional): Filters on scheduled launches.
- `archived` (boolean, optional): Filters on archived launches.
- `shared` (boolean, optional): Filters on launches with a live sharing grant.
- `launched_from` (integer, optional): Earliest launch time, Unix seconds, inclusive.
- `launched_to` (integer, optional): Latest launch time, Unix seconds, inclusive.
- `order_by` (enum, optional, default "launched_at"): Sort column. The API refuses `owner_username`. Possible values: `launched_at`, `created_at`, `launch_id`, `license_key`, `owner_username`, `pnl_usd`, `pnl_native`, `gross_volume_usd`, `gross_volume_native`, `gross_revenue_usd`, `gross_revenue_native`, `referral_paid_usd`, `referral_paid_native`, `holder_count`, `name`, `symbol`, `launch_platform`, `launch_status`, `chain_id`.
- `order` (enum, optional, default "desc"): Sort direction. Possible values: `asc`, `desc`.

#### Returns 200 OK

- `items` (array<object>): Launches on this page. See [Admin launch](#object-admin-launch).
- `total` (integer): Total number of matching launches.
- `limit` (integer): Applied page size.
- `offset` (integer): Applied offset.
- `native_mixed` (boolean): `true` when the results span several chains, so native amounts are not in a single unit.
- `units` (object): Unit labels for the amounts in the response.
  - `usd` (string): Unit of the USD amounts.
  - `native` (string): Unit of the native amounts.
  - `time` (string): Unit of the timestamps.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid order_by: <order_by>` | `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` | `invalid <field>: <value> (accepted: <values>)` | 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` | `<field> is not a unix-seconds timestamp: <value>` | `launched_from` or `launched_to` is too large to be read as a date. | Send the time in Unix seconds. |
| 404 | `not_found` | `account not found` | No account has this `account_id`. | Take the `account_id` from [List users](/reference/admin-users/#list-users). |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/launches" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "items": [
    {
      "chain_id": "sol",
      "launch_id": "18234",
      "mint_pubkey": "Pp3T3fAScMGZUxEMhYc34Bju7BTD5kF1z36adQsuMjdF",
      "launch_platform": "pumpfun",
      "launch_method": "Mev",
      "launch_status": "Finalized",
      "created_at": 1791980000,
      "launched_at": 1791980400,
      "archived": false,
      "scheduled_mode": false,
      "has_launch_plan": false,
      "is_imported": false,
      "holder_count": 211,
      "name": "Sample Token",
      "symbol": "SMPL",
      "description": "An example launch.",
      "image_url": null,
      "token_decimals": 6,
      "total_supply": "1000000000",
      "quote_mint": "So11111111111111111111111111111111111111112",
      "website": null,
      "twitter": null,
      "telegram": null,
      "kind": "launch",
      "group_id": null,
      "group_disposition": null,
      "tag_ids": [],
      "pnl_native": "4120000000",
      "pnl_usd": "768000000",
      "gross_volume_native": "96400000000",
      "gross_volume_usd": "17980000000",
      "total_buy_native": "46140000000",
      "total_buy_usd": "8606000000",
      "total_sell_native": "50260000000",
      "total_sell_usd": "9374000000",
      "mm_pnl_native": "0",
      "mm_pnl_usd": "0",
      "extra_rewards_native": "0",
      "extra_rewards_usd": "0",
      "gross_revenue_native": "2210000000",
      "gross_revenue_usd": "412000000",
      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
      "referrer_license_key": "AFFILIATE01-Qm4Tz8Lp2Xc7Vb9Nw",
      "referrer_username": "affiliate01",
      "referrer_account_id": "3d6201aa-c053-4969-af46-2ba4b92d54ac",
      "referral_paid_native": "331500000",
      "referral_paid_usd": "61800000",
      "referral_unpaid_native": "0",
      "referral_unpaid_usd": "0",
      "referral_unpaid_status": "settled",
      "revenue_net_native": "1878500000",
      "revenue_net_usd": "350200000",
      "referral_fee_rate_current": 1500,
      "owner_account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
      "owner_username": "demouser",
      "owner_display_name": "Demo User",
      "owner_avatar_url": null,
      "shared": false,
      "sharing": null
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0,
  "native_mixed": false,
  "units": {
    "usd": "micro_usd",
    "native": "lamports",
    "time": "unix_seconds"
  }
}
```

### List a user's launches

`GET /admin/launches/{username}`

Returns a page of one user's launches. (Admin JWT · internal)

- Token: Upgraded session token of an account with admin rights.
- Read-only tokens: allowed.
- Retry: Safe to retry.

> Not called by the current web app.

#### Path parameters

- `username` (string, required): Username of the owner.

#### Query parameters

- `limit` (integer, optional, default "50"): Page size. The API defaults to 50 and caps at 200.
- `offset` (integer, optional, default "0"): Number of rows to skip.
- `chain_id` (string, optional): Comma-separated chain ids, such as `sol,base`.
- `search` (string, optional): Free-text search.
- `launch_status` (string, optional): Comma-separated launch statuses.
- `platform` (string, optional): Comma-separated launchpads.
- `launch_method` (string, optional): Comma-separated launch methods: `mev`, `block0`, `stagger`, `manual`.
- `is_imported` (boolean, optional): Filters on imported tokens.
- `scheduled_mode` (boolean, optional): Filters on scheduled launches.
- `archived` (boolean, optional): Filters on archived launches.
- `shared` (boolean, optional): Filters on launches with a live sharing grant.
- `launched_from` (integer, optional): Earliest launch time, Unix seconds, inclusive.
- `launched_to` (integer, optional): Latest launch time, Unix seconds, inclusive.
- `order_by` (enum, optional, default "launched_at"): Sort column. The API refuses `owner_username`. Possible values: `launched_at`, `created_at`, `launch_id`, `license_key`, `owner_username`, `pnl_usd`, `pnl_native`, `gross_volume_usd`, `gross_volume_native`, `gross_revenue_usd`, `gross_revenue_native`, `referral_paid_usd`, `referral_paid_native`, `holder_count`, `name`, `symbol`, `launch_platform`, `launch_status`, `chain_id`.
- `order` (enum, optional, default "desc"): Sort direction. Possible values: `asc`, `desc`.

#### Returns 200 OK

- `items` (array<object>): Launches on this page. See [Admin launch](#object-admin-launch).
- `total` (integer): Total number of matching launches.
- `limit` (integer): Applied page size.
- `offset` (integer): Applied offset.
- `native_mixed` (boolean): `true` when the results span several chains, so native amounts are not in a single unit.
- `units` (object): Unit labels for the amounts in the response.
  - `usd` (string): Unit of the USD amounts.
  - `native` (string): Unit of the native amounts.
  - `time` (string): Unit of the timestamps.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid order_by: <order_by>` | `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` | `invalid <field>: <value> (accepted: <values>)` | 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` | `<field> is not a unix-seconds timestamp: <value>` | `launched_from` or `launched_to` is too large to be read as a date. | Send the time in Unix seconds. |
| 404 | `not_found` | `unknown username: <username>` | No account has this username. | Use a username returned by [List users](/reference/admin-users/#list-users). |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/launches/{username}" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "items": [
    {
      "chain_id": "sol",
      "launch_id": "18234",
      "mint_pubkey": "Pp3T3fAScMGZUxEMhYc34Bju7BTD5kF1z36adQsuMjdF",
      "launch_platform": "pumpfun",
      "launch_method": "Mev",
      "launch_status": "Finalized",
      "created_at": 1791980000,
      "launched_at": 1791980400,
      "archived": false,
      "scheduled_mode": false,
      "has_launch_plan": false,
      "is_imported": false,
      "holder_count": 211,
      "name": "Sample Token",
      "symbol": "SMPL",
      "description": "An example launch.",
      "image_url": null,
      "token_decimals": 6,
      "total_supply": "1000000000",
      "quote_mint": "So11111111111111111111111111111111111111112",
      "website": null,
      "twitter": null,
      "telegram": null,
      "kind": "launch",
      "group_id": null,
      "group_disposition": null,
      "tag_ids": [],
      "pnl_native": "4120000000",
      "pnl_usd": "768000000",
      "gross_volume_native": "96400000000",
      "gross_volume_usd": "17980000000",
      "total_buy_native": "46140000000",
      "total_buy_usd": "8606000000",
      "total_sell_native": "50260000000",
      "total_sell_usd": "9374000000",
      "mm_pnl_native": "0",
      "mm_pnl_usd": "0",
      "extra_rewards_native": "0",
      "extra_rewards_usd": "0",
      "gross_revenue_native": "2210000000",
      "gross_revenue_usd": "412000000",
      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
      "referrer_license_key": "AFFILIATE01-Qm4Tz8Lp2Xc7Vb9Nw",
      "referrer_username": "affiliate01",
      "referrer_account_id": "3d6201aa-c053-4969-af46-2ba4b92d54ac",
      "referral_paid_native": "331500000",
      "referral_paid_usd": "61800000",
      "referral_unpaid_native": "0",
      "referral_unpaid_usd": "0",
      "referral_unpaid_status": "settled",
      "revenue_net_native": "1878500000",
      "revenue_net_usd": "350200000",
      "referral_fee_rate_current": 1500,
      "owner_account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
      "owner_username": "demouser",
      "owner_display_name": "Demo User",
      "owner_avatar_url": null,
      "shared": false,
      "sharing": null
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0,
  "native_mixed": false,
  "units": {
    "usd": "micro_usd",
    "native": "lamports",
    "time": "unix_seconds"
  }
}
```

### Retrieve a launch

`GET /admin/get-launch-info/{launch_id}`

Returns the full configuration and wallets of any account's launch. (Admin JWT · internal)

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

> The web app treats a body with `ok: false` as no launch.

#### Path parameters

- `launch_id` (string, required): Launch id.

#### Returns 200 OK

Returns a launch info object. The main fields are listed below.

- `chain_id` (string): Proxima chain id.
- `launch_method` (enum): Launch method. Possible values: `Mev`, `Stagger`, `Manual`, `Allowlist`.
- `funding_type` (enum): How the wallets were funded. Possible values: `Classic`, `Cex`.
- `is_graduated` (boolean): Whether the token left its bonding curve.
- `creator_fees` (integer): Uncollected creator fees, in base units of the native or quote token. See [Collect creator fees](/reference/launch-fees/#collect-fees).
- `buy_delay` (integer): Delay between holder buys, in milliseconds.
- `dev` (object | null): Dev wallet.
- `funder` (object): Funder wallet.
- `holder` (array<object>): Holder wallets.
- `front_mev` (array<object>): Front MEV wallets.
- `back_mev` (array<object>): Back MEV wallets.
- `temp_holder` (array<object>): Temporary holder wallets.
- `pnl_native` (string): P&L, in lamports or wei, as an integer string.
- `pnl_usd` (string): P&L, in micro-USD, as an integer string.
- `gross_volume_native` (string): Gross volume, in lamports or wei, as an integer string.
- `gross_volume_usd` (string): Gross volume, in micro-USD, as an integer string.
- `extra_rewards_native` (string): Extra rewards in native base units, as a string.
- `extra_rewards_usd` (string): Extra rewards, in micro-USD, as an integer string.
- `mm_pnl_native` (string): Market-making profit and loss in native base units, as a string.
- `mm_pnl_usd` (string): Market-making profit and loss, in micro-USD, as an integer string.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | `launch_id` is not a valid launch id. | Use a launch id returned by [List launches](/reference/admin-launches/#list-launches). |
| 404 | `not_found` | `launch not found` | No launch has this id. | Use a launch id returned by [List launches](/reference/admin-launches/#list-launches). |

#### Example request

```bash
curl "https://api-mig.proxima.tools/admin/get-launch-info/{launch_id}" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "chain_id": "sol",
  "launch_method": "Mev",
  "funding_type": "Classic",
  "is_graduated": false,
  "creator_fees": 0,
  "buy_delay": 0,
  "dev": {
    "key": {
      "pubkey": "NEHongC3s1wu2512RY9PeCSKxSafTewh4LaBtZLUwqYa"
    },
    "native_balance": "120000000",
    "token_balance": "35000000000000"
  },
  "funder": {
    "key": {
      "pubkey": "mEQxMmVdmn9yzhgz4iHCejoj6QuKuCwXmc56ZNVRcrNk"
    },
    "native_balance": "2500000000"
  },
  "holder": [
    {
      "key": {
        "pubkey": "nFSZLpyf9UfANbyDzSf6igfD9CmTe975LeakYJEWiw4"
      },
      "native_balance": "80000000",
      "token_balance": "21000000000000"
    }
  ],
  "front_mev": [],
  "back_mev": [],
  "temp_holder": [],
  "pnl_native": "4120000000",
  "pnl_usd": "768000000",
  "gross_volume_native": "96400000000",
  "gross_volume_usd": "17980000000",
  "extra_rewards_native": "0",
  "extra_rewards_usd": "0",
  "mm_pnl_native": "0",
  "mm_pnl_usd": "0"
}
```
