# Launch platforms

> Look up platform configs, quote tokens and options before creating a launch.

Read-only lookups the create form makes before a launch exists: which quote tokens a platform accepts, whether a given quote is safe to pair with, platform configurations and the options of partner integrations. None of them create or change anything.

Most take the platform as a query parameter and return `eligible: false` with a `reason` rather than an error when a choice is refused.

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

## Endpoints

- `GET /launch/sol/ansem/config`: Retrieve the Ansem config
- `GET /launch/{chain_id}/otcdesks/rewards`: List OTC desk rewards
- `GET /launch/{chain_id}/quote-tokens`: List quote tokens
- `GET /launch/{chain_id}/quote-check`: Check a quote token
- `GET /launch/{chain_id}/pumpfun/quote-check`: Check a pump.fun quote
- `GET /launch/robinhood/flywheel/quote-check`: Check a Flywheel quote
- `GET /launch/{chain_id}/launchlab/platform`: Retrieve a LaunchLab platform
- `GET /launch/{chain_id}/meteoradbc/configs`: List Meteora DBC configs
- `GET /launch/{chain_id}/flap/quotes`: List Flap quotes
- `GET /launch/{chain_id}/flap/stocks`: List Flap stock assets
- `GET /launch/{chain_id}/flap/dividend-tokens`: List Flap dividend tokens
- `GET /launch/{chain_id}/flap/vault-schema`: Retrieve a Flap vault schema

### Retrieve the Ansem config

`GET /launch/sol/ansem/config`

Returns the costs and tier thresholds of a pump.fun Ansem launch. (Bearer JWT)

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

#### Returns 200 OK

- `available` (boolean): Ansem launches can be created right now.
- `funding_sol` (string): Funding required, in SOL. Number or numeric string.
- `gas_sol` (string): Gas reserve, in SOL. Number or numeric string.
- `airdrop_buy_sol` (string): Default airdrop buy, in SOL. Number or numeric string.
- `airdrop_buy_min_sol` (string): Smallest airdrop buy, in SOL. Number or numeric string.
- `airdrop_buy_max_sol` (string): Largest airdrop buy, in SOL. Number or numeric string.
- `tier_thresholds` (object): Thresholds of the paid tiers.
  - `gold` (string): Gold tier threshold.
  - `diamond` (string): Diamond tier threshold.
- `ansem_price_usd` (string): Price used for the thresholds, in USD. Number or numeric string.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 422 | `upstream_failure` | `ansem api issue: /config returned <status>: <body>` | The Ansem launchpad API could not be reached, answered an error or sent a config Proxima could not read. The body adds `service: "ansem"`. | Retry in a few seconds; once read, the config is cached for 30 seconds. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/sol/ansem/config" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "available": true,
  "funding_sol": "0.35",
  "gas_sol": "0.02",
  "airdrop_buy_sol": "0.5",
  "airdrop_buy_min_sol": "0.1",
  "airdrop_buy_max_sol": "5",
  "tier_thresholds": {
    "gold": "250",
    "diamond": "1000"
  },
  "ansem_price_usd": "0.0042"
}
```

### List OTC desk rewards

`GET /launch/{chain_id}/otcdesks/rewards`

Lists the tokens an OTC desks launch can reward its holders in. (Bearer JWT)

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

Pass the chosen `reward_mint` (or `reward_basket`) as `otcdesks` when you [create the launch](/reference/launches/#create-launch). A basket holds between `basket_min` and `basket_max` distinct mints.

#### Path parameters

- `chain_id` (enum, required): Chain to query. Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Returns 200 OK

- `rotation` (array<object>): Rewards on rotation.
  - `mint` (string): Reward mint.
  - `symbol` (string | null): Symbol.
  - `basket_eligible` (boolean): Can be part of a basket.
  - `kind` (enum | null): Asset kind. Possible values: `stock`, `fund`, `commodity`, `private`, `crypto`.
  - `company` (string | null): Company name.
  - `logo` (string | null): Logo URL.
  - `decimals` (integer | null): Decimals.
- `custom` (array<object>): Other rewards, shaped like `rotation`.
- `stocks` (array<object>): Stock rewards, shaped like `rotation`.
- `basket_min` (integer): Fewest mints in a basket.
- `basket_max` (integer): Most mints in a basket.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `this endpoint only supports sol, got <chain_id>` | `chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead. | Call it with `chain_id` set to `sol`; OTC desks launches exist on Solana only. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/sol/otcdesks/rewards" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "rotation": [
    {
      "mint": "2jJhjeLE7KA64hNmGp5pwvb7cySPnTnFxvDuzMXyyirB",
      "symbol": "NVDAx",
      "basket_eligible": true,
      "kind": "stock",
      "company": "NVIDIA",
      "logo": null,
      "decimals": 8
    }
  ],
  "custom": [
    {
      "mint": "BFFE4HJtnBJHQ6yEKcDsfUSxZpLCe52DevzQbjCgbKpD",
      "symbol": "GLDx",
      "basket_eligible": true,
      "kind": "commodity",
      "company": null,
      "logo": null,
      "decimals": 8
    }
  ],
  "basket_min": 2,
  "basket_max": 10
}
```

### List quote tokens

`GET /launch/{chain_id}/quote-tokens`

Lists the quote tokens a platform can pair a new token with. (Bearer JWT)

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

Only Solana is served: the API answers `/launch/sol/quote-tokens`, and any other `chain_id` gets an empty `404`.

#### Path parameters

- `chain_id` (enum, required): Chain to query. Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Query parameters

- `platform` (string, required): Platform ID, for example `pumpfun` or `stonkfun`.

#### Returns 200 OK

- `quotes` (array<object>): Accepted quote tokens.
  - `mint` (string): Mint of the quote token.
  - `symbol` (string): Symbol.
  - `name` (string): Name.
  - `decimals` (integer): Decimals.
  - `token_program` (string): Token program that owns the mint.
  - `kind` (enum): Crypto asset or tokenized real-world asset. Possible values: `crypto`, `rwa`.
  - `native` (boolean): The quote is the chain's native token.
  - `category` (string): Stonkfun shelf label. Absent when their catalog has not loaded.
  - `logo` (string): Absolute logo URL. Only for `platform=stonkfun`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `Unknown launch platform` | `platform` is not a Solana launch platform ID. | Pass a Solana platform ID such as `pumpfun`, `meteoradbc` or `stonkfun`. |
| 422 | `unprocessable` | `Failed to read Pumpfun quote config` | `platform` is `pumpfun` and pump.fun's quote config could not be read from the chain. | Retry in a few seconds; the config is cached once it has been read. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/sol/quote-tokens?platform=stonkfun" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "quotes": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "name": "Solana",
      "decimals": 9,
      "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "kind": "crypto",
      "native": true
    },
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
      "kind": "crypto",
      "native": false
    }
  ]
}
```

### Check a quote token

`GET /launch/{chain_id}/quote-check`

Checks whether a token of your choosing can be used as the quote of a platform. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry. Each call reads the chain again; recording an accepted quote twice changes nothing.

Solana only. A refusal answers `eligible: false` with the reason a create would give. An accepted quote comes with its traits, the platform venue, the raise and a simulated round trip, and is recorded as a known quote token. With `platform` set to `pumpfun` the answer has the shape of [Check a pump.fun quote](#check-pumpfun-quote).

#### Path parameters

- `chain_id` (enum, required): Chain to query. Only `sol` is served. Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Query parameters

- `platform` (enum, required): Platform the quote is checked for. Possible values: `pumpfun`, `launchlab`, `meteoradbc`, `meteoradamm`.
- `mint` (string, required): Quote token to check.
- `config` (string, optional): `launchlab`: the platform config the launch opens under, which sets the raise; without it the raise is 85 SOL's worth of the quote. `meteoradbc`: the DBC config the quote settles in, required; without it the answer is a refusal. Ignored by the other platforms.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `eligible` (boolean): The token can be the quote.
- `mint` (string): Token checked.
- `reason` (string): Why the token was refused. Only when `eligible` is `false`.
- `asset` (object): The quote token, shaped like the items of [List quote tokens](#list-quote-tokens).
- `traits` (object): Token traits.
  - `taxed_bps` (integer): Transfer tax, in basis points.
  - `permanent_delegate` (boolean): The mint has a permanent delegate.
  - `freeze_authority` (boolean): The mint has a freeze authority.
- `venue` (object): Facts of the platform: `dbc_config` and `badge` for `meteoradbc`; `badge` for `meteoradamm`; `global_config` for `launchlab`, plus `platform_config`, `platform_fee_bps`, `creator_fee_bps` and `base_token_2022` when `config` is sent. `badge` is the venue's badge account for the quote, `null` when there is none.
- `raise` (string): Raise the round trip is measured on, in quote base units: the DBC config's migration threshold, the LaunchLab platform's default raise, or 85 SOL's worth of the quote.
- `round_trip` (object): Simulated buy and sell of the quote with native, to measure the loss.
  - `quote_atoms` (string): Quote amount simulated, in base units.
  - `native_spent` (string): Native spent buying it, in base units.
  - `native_recovered` (string): Native recovered selling it back, in base units.
  - `loss_bps` (integer): Loss of the round trip, in basis points.
  - `max_loss_bps` (integer): Highest loss accepted, in basis points.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `this endpoint only supports sol, got <chain_id>` | `chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead. | Call it with `chain_id` set to `sol`. |
| 400 | `bad_request` | `mint must be a pubkey` | `mint` is not a valid Solana address. | Send the quote token's mint address in base58. |
| 400 | `bad_request` | `config must be a pubkey` | `config` is not a valid Solana address. | Send the config account address in base58, or leave `config` out. |
| 400 | `bad_request` | `<platform> takes no quote of the caller's choosing` | `platform` is not `pumpfun`, `launchlab`, `meteoradbc` or `meteoradamm`. | Use one of those platforms; others take only the quotes listed by [List quote tokens](#list-quote-tokens). |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/sol/quote-check?platform=meteoradbc&mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "eligible": true,
  "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "asset": {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6,
    "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "kind": "crypto",
    "native": false
  },
  "traits": {
    "taxed_bps": 0,
    "permanent_delegate": false,
    "freeze_authority": true
  },
  "venue": {
    "dbc_config": "GoLaX2BGrP7x3TXMxahjvPfRTeKsMDVd3vMhQT7y3X3x",
    "badge": null
  },
  "raise": "69000000000",
  "round_trip": {
    "quote_atoms": "1000000",
    "native_spent": "5514000",
    "native_recovered": "5489000",
    "loss_bps": 45,
    "max_loss_bps": 300
  }
}
```

### Check a pump.fun quote

`GET /launch/{chain_id}/pumpfun/quote-check`

Checks whether a token can be the quote of a pump.fun launch. (Bearer JWT)

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

A refusal still answers 200, with `eligible: false` and its `reason`. A quote pump.fun already lists comes back with `listed: true`; an unlisted one adds its own market, the opening reserve, the graduation raise and a simulated round trip. A failed chain read is also a refusal, with the read error as `reason`: check again a few seconds later before treating the token as ineligible.

#### Path parameters

- `chain_id` (enum, required): Chain to query. Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Query parameters

- `mint` (string, required): Quote token to check.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `eligible` (boolean): The token can be the quote.
- `mint` (string): Token checked. Only on refusals.
- `reason` (string): Why the token was refused.
- `listed` (boolean): pump.fun already lists the token as a quote.
- `asset` (object): The quote token, shaped like the items of [List quote tokens](#list-quote-tokens).
- `quote_of_quote` (string): Unlisted only: the token the quote itself trades against.
- `migrated` (boolean): Unlisted only: the quote's own market has migrated.
- `opening_quote_reserve` (string): Unlisted only: opening quote reserve, in base units.
- `graduation_raise` (string): Unlisted only: raise needed to graduate, in base units.
- `round_trip` (object): Simulated buy and sell of the quote with native, to measure the loss.
  - `quote_atoms` (string): Quote amount simulated, in base units.
  - `native_spent` (string): Native spent buying it, in base units.
  - `native_recovered` (string): Native recovered selling it back, in base units.
  - `loss_bps` (integer): Loss of the round trip, in basis points.
  - `max_loss_bps` (integer): Highest loss accepted, in basis points.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `this endpoint only supports sol, got <chain_id>` | `chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead. | Call it with `chain_id` set to `sol`. |
| 400 | `bad_request` | `mint must be a pubkey` | `mint` is not a valid Solana address. | Send the quote token's mint address in base58. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/sol/pumpfun/quote-check?mint=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "eligible": true,
  "listed": true,
  "asset": {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "symbol": "USDC",
    "name": "USD Coin",
    "decimals": 6,
    "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
    "kind": "crypto",
    "native": false
  }
}
```

### Check a Flywheel quote

`GET /launch/robinhood/flywheel/quote-check`

Checks whether a token can be the quote of a Flywheel launch on Robinhood. (Bearer JWT)

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

#### Query parameters

- `mint` (string, required): Quote token address.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `eligible` (boolean): The token can be the quote.
- `reason` (string): Why the token was refused. Only when `eligible` is `false`, and then `asset` and `graduation_threshold` are absent.
- `asset` (object): The quote token: `mint`, `symbol`, `name`, `decimals`, `kind`, `native`.
- `graduation_threshold` (string): Graduation threshold, in quote base units.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `mint must be an EVM address` | `mint` is not a valid EVM address. | Send the token's `0x` address. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/robinhood/flywheel/quote-check?mint=0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "eligible": true,
  "asset": {
    "mint": "0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c",
    "symbol": "USDG",
    "name": "Global Dollar",
    "decimals": 6,
    "kind": "crypto",
    "native": false
  },
  "graduation_threshold": "25000000000"
}
```

### Retrieve a LaunchLab platform

`GET /launch/{chain_id}/launchlab/platform`

Returns what a Raydium LaunchLab platform config allows, with the raise terms of each requested quote. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry. Each call reads the chain again; recording an accepted quote twice changes nothing.

#### Path parameters

- `chain_id` (enum, required): Chain to query. Only `sol` is served. Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Query parameters

- `config` (string, required): LaunchLab platform config account.
- `quotes` (string, optional): Comma-separated quote mints to price, at most 20 once duplicates are dropped. Without it, `quotes` comes back empty.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `platform_config` (string): Config checked.
- `platform_fee_bps` (integer): Platform fee, in basis points.
- `creator_fee_bps` (integer): Creator fee, in basis points.
- `restricts_quotes` (boolean): The platform only admits some quotes.
- `restricts_curve` (boolean): The platform fixes the curve.
- `allowed_quotes` (array<string> | null): Quotes the platform admits; `null` when it admits any.
- `quotes` (array<object>): Terms for each requested quote.
  - `mint` (string): Quote mint.
  - `allowed` (boolean): The platform admits this quote.
  - `reason` (string): Why the quote is refused, such as `this platform does not allow this quote`. Only when `allowed` is `false`.
  - `raise` (object): Raise terms in quote base units: `min`, `max` (`null` when uncapped), `fixed` (set when only one raise is allowed) and `default` (`null` when nothing prices the quote).

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `this endpoint only supports sol, got <chain_id>` | `chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead. | Call it with `chain_id` set to `sol`. |
| 400 | `bad_request` | `config must be a pubkey` | `config` is not a valid Solana address. | Send the platform config account address in base58. |
| 400 | `bad_request` | `<quote> is not a pubkey` | An entry of `quotes` is not a valid Solana address. | Send base58 mint addresses separated by commas. |
| 400 | `bad_request` | `at most 20 quotes at once` | `quotes` names more than 20 distinct mints. | Ask for at most 20 quotes per call. |
| 400 | `bad_request` | `<reason>` | The platform config could not be read from the chain or is not a LaunchLab platform config. The message is the reader's reason. | Check that `config` is a LaunchLab platform config account, then retry. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/sol/launchlab/platform?config=DkA5nngzxcYj2gDvnLfaYvURufYaB19AMV6QDASrecvT&quotes=So11111111111111111111111111111111111111112%2CEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "platform_config": "DkA5nngzxcYj2gDvnLfaYvURufYaB19AMV6QDASrecvT",
  "platform_fee_bps": 100,
  "creator_fee_bps": 50,
  "restricts_quotes": false,
  "restricts_curve": false,
  "allowed_quotes": null,
  "quotes": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "allowed": true,
      "raise": {
        "min": "30000000000",
        "max": null,
        "fixed": null,
        "default": "85000000000"
      }
    },
    {
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "allowed": true,
      "raise": {
        "min": "5000000000",
        "max": "50000000000",
        "fixed": null,
        "default": null
      }
    }
  ]
}
```

### List Meteora DBC configs

`GET /launch/{chain_id}/meteoradbc/configs`

Lists usable Meteora DBC configs quoted in a given token. (Bearer JWT)

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

#### Path parameters

- `chain_id` (enum, required): Chain to query. Only `sol` is served. Possible values: `sol`, `eth`, `bsc`, `base`, `robinhood`, `monad`, `arc`, `xlayer`.

#### Query parameters

- `quote` (string, required): Quote mint. SOL and USDC are refused.
- `limit` (integer, optional, default "20"): Most configs to return, from 1 to 100; values outside are clamped. The app sends `20`.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `quote` (string): Quote mint.
- `scanned` (integer): Configs scanned.
- `configs` (array<object>): Usable configs.
  - `config` (string): Config account.
  - `migration_quote_threshold` (string): Quote raised before migration, in base units.
  - `fee_bps` (integer): Trading fee, in basis points.
  - `migration_fee_option` (integer): Meteora migration fee option.
  - `locked_lp_bps` (integer): Share of LP locked at migration, in basis points.
  - `token_type` (integer): Meteora token type.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `this endpoint only supports sol, got <chain_id>` | `chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead. | Call it with `chain_id` set to `sol`. |
| 400 | `bad_request` | `quote must be a pubkey` | `quote` is not a valid Solana address. | Send the quote mint address in base58. |
| 400 | `bad_request` | `SOL and USDC configs are listed by the picker, not here` | `quote` is SOL or USDC, which have too many configs to scan. | Use this endpoint only for quotes other than SOL and USDC. |
| 422 | `upstream_failure` | `rpc api issue: <error>` | The scan of Meteora's DBC configs failed at the RPC. The body also carries `service: "rpc"`. | Retry after a short wait. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/sol/meteoradbc/configs?quote=JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "quote": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN",
  "scanned": 412,
  "configs": [
    {
      "config": "B6XtJH99y9YHmEiYMcUv6AtHFEDFzR6xDwvE8ofDYknM",
      "migration_quote_threshold": "40000000000",
      "fee_bps": 100,
      "migration_fee_option": 1,
      "locked_lp_bps": 10000,
      "token_type": 0
    }
  ]
}
```

### List Flap quotes

`GET /launch/{chain_id}/flap/quotes`

Lists the quote tokens a Flap launch can use, optionally for a given vault. (Bearer JWT)

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

#### Path parameters

- `chain_id` (enum, required): Chain to query. Flap runs on BSC, Robinhood and Arc. Possible values: `bsc`, `robinhood`, `arc`.

#### Query parameters

- `vault_factory` (string, optional): Vault factory the quotes must support.
- `vault_kind` (enum, optional): Built-in vault kind the quotes must support. Possible values: `stocks`, `buyback`.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `chain_id` (string): Chain queried.
- `vault_factory` (string): Vault factory checked.
- `quotes` (array<object>): Quote tokens.
  - `address` (string | null): Quote token address; `null` for the native token.
  - `symbol` (string): Symbol.
  - `name` (string): Name.
  - `kind` (enum): Crypto asset or tokenized real-world asset. Possible values: `crypto`, `rwa`.
  - `supported` (boolean | null): The quote can be used with the requested vault.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `flap is not deployed on <chain_id>` | `chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead. | Call it with `chain_id` set to `bsc`, `robinhood` or `arc`. |
| 400 | `bad_request` | `flap vault launches are not enabled on <chain_id>` | `vault_factory` or `vault_kind` was sent on a chain where Flap vault launches are off (Arc). | Drop the vault parameters, or use `bsc` or `robinhood` for a vault launch. |
| 400 | `bad_request` | `bad vault_factory: <reason>` | `vault_factory` is not an EVM address. | Send the factory as a `0x`-prefixed 20-byte address. |
| 400 | `bad_request` | `unknown vault_kind: <vault_kind>` | `vault_kind` is neither `stocks` nor `buyback`. | Set `vault_kind` to `stocks` or `buyback`, or pass `vault_factory` instead. |
| 422 | `upstream_failure` | `evm_rpc api issue: <detail>` | A vault was named and the chain's RPC failed while reading which quotes its factory takes. The body adds `service: "evm_rpc"`. | Retry in a few seconds. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/bsc/flap/quotes" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "chain_id": "bsc",
  "quotes": [
    {
      "address": null,
      "symbol": "BNB",
      "name": "BNB",
      "kind": "crypto",
      "supported": true
    },
    {
      "address": "0xcce967904e6db57ae72838ba12b60ccc1f76081c",
      "symbol": "USD1",
      "name": "USD1",
      "kind": "crypto",
      "supported": true
    }
  ]
}
```

### List Flap stock assets

`GET /launch/{chain_id}/flap/stocks`

Lists the tokenized stocks a Flap stocks vault can hold. (Bearer JWT)

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

#### Path parameters

- `chain_id` (enum, required): Chain to query. Flap runs on BSC, Robinhood and Arc. Possible values: `bsc`, `robinhood`, `arc`.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `chain_id` (string): Chain queried.
- `assets` (array<object>): Stock tokens.
  - `address` (string): Token address.
  - `name` (string): Name.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `flap is not deployed on <chain_id>` | `chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead. | Call it with `chain_id` set to `bsc` or `robinhood`. |
| 400 | `bad_request` | `flap vault launches are not enabled on <chain_id>` | Flap runs on this chain but its vault launches are off (Arc), so it has no stocks vault. | Call it with `chain_id` set to `bsc` or `robinhood`. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/bsc/flap/stocks" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "chain_id": "bsc",
  "assets": [
    {
      "address": "0xda8984160efb2fc27e207d259da92f381b9ef2a4",
      "name": "Tesla xStock"
    }
  ]
}
```

### List Flap dividend tokens

`GET /launch/{chain_id}/flap/dividend-tokens`

Lists the tokens a Flap launch can pay dividends in, for a given quote. (Bearer JWT)

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

#### Path parameters

- `chain_id` (enum, required): Chain to query. Flap runs on BSC, Robinhood and Arc. Possible values: `bsc`, `robinhood`, `arc`.

#### Query parameters

- `quote` (string, optional): Quote token address. Omit for the native quote.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `chain_id` (string): Chain queried.
- `quote` (object): The quote: `address` (`null` for native), `symbol`, `name`, `decimals`, `kind`, `native`.
- `dividend_tokens` (array<object>): Dividend choices.
  - `value` (string): `quote`, `self`, or a token address. Use it as the dividend token of the create params.
  - `symbol` (string | null): Symbol.
  - `name` (string | null): Name.
  - `kind` (enum | null): Asset kind. Possible values: `crypto`, `rwa`.
  - `supported` (boolean): Usable with this quote.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `flap is not deployed on <chain_id>` | `chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead. | Call it with `chain_id` set to `bsc`, `robinhood` or `arc`. |
| 400 | `bad_request` | `quote token must be an address: <reason>` | `quote` is not an EVM address. | Send the quote as a `0x`-prefixed address, or omit it for the native quote. |
| 400 | `bad_request` | `<quote> is not a known quote token on <chain_id>` | `quote` is not a quote token Proxima knows on this chain. | Pick an `address` returned by [List Flap quotes](/reference/launch-platforms/#list-flap-quotes). |
| 400 | `bad_request` | `flap does not support the <symbol> quote on <chain_id>` | `quote` is a known token that Flap does not take as a quote on this chain. | Pick an `address` returned by [List Flap quotes](/reference/launch-platforms/#list-flap-quotes). |
| 400 | `bad_request` | `flap requires an explicit quote token on <chain_id>` | `quote` was omitted on a chain where Flap takes no native quote. | Pass the launch's quote token, taken from [List Flap quotes](/reference/launch-platforms/#list-flap-quotes). |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/bsc/flap/dividend-tokens" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "chain_id": "bsc",
  "quote": {
    "address": null,
    "symbol": "BNB",
    "name": "BNB",
    "decimals": 18,
    "kind": "crypto",
    "native": true
  },
  "dividend_tokens": [
    {
      "value": "quote",
      "symbol": "BNB",
      "name": "BNB",
      "kind": "crypto",
      "supported": true
    },
    {
      "value": "self",
      "symbol": null,
      "name": null,
      "kind": null,
      "supported": true
    }
  ]
}
```

### Retrieve a Flap vault schema

`GET /launch/{chain_id}/flap/vault-schema`

Returns the fields a Flap vault factory expects, with its standing and policies. (Bearer JWT)

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

Pass either `factory` for a custom vault factory or `kind` for a built-in vault.

#### Path parameters

- `chain_id` (enum, required): Chain to query. Flap runs on BSC, Robinhood and Arc. Possible values: `bsc`, `robinhood`, `arc`.

#### Query parameters

- `factory` (string, optional): Vault factory address.
- `kind` (enum, optional): Built-in vault kind. Possible values: `stocks`, `buyback`.

#### Returns 200 OK

- `ok` (boolean): `true` when the request succeeded.
- `chain_id` (string): Chain queried.
- `factory` (string): Factory described.
- `spec_version` (string): Schema version.
- `description` (string): What the vault does.
- `is_array` (boolean): The vault takes a list of entries.
- `fields` (array<object>): Fields to fill.
  - `name` (string): Field name.
  - `type` (string): Solidity type.
  - `decimals` (integer): Decimals of numeric fields.
  - `description` (string): What the field is.
- `standing` (object): Registry standing: `registered`, `official`, `risk_level`, `policy`, `policy_description`.
- `policies` (array<object>): Constraints on the fields: `target`, `operator`, `value`, `description`.
- `quotes` (array<object> | null): Quotes the vault supports, shaped like [List Flap quotes](#list-flap-quotes).

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `pass factory=0x… , or kind=stocks\|buyback for an official one` | Neither `factory` nor a `kind` of `stocks` or `buyback` was sent. | Pass `factory` with a vault factory address, or `kind` set to `stocks` or `buyback`. |
| 400 | `bad_request` | `bad factory: <reason>` | `factory` is not an EVM address. | Send the factory as a `0x`-prefixed 20-byte address. |
| 400 | `bad_request` | `flap is not deployed on <chain_id>` | `chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead. | Call it with `chain_id` set to `bsc` or `robinhood`. |
| 400 | `bad_request` | `flap vault launches are not enabled on <chain_id>` | Flap runs on this chain but its vault launches are off (Arc). | Call it with `chain_id` set to `bsc` or `robinhood`. |
| 400 | `bad_request` | `factory <factory> declares no vaultDataSchema: <reason>` | The factory declares no schema. | Check the factory address; a factory older than the vault spec cannot be configured through this form. |
| 400 | `bad_request` | `vault factory registry read failed: <reason>` | The vault factory registry or its policy could not be read for this factory. The policy read answers `vault factory policy read failed: <reason>`. | Check that `factory` is a Flap vault factory on this chain, then retry. |
| 422 | `upstream_failure` | `evm_rpc api issue: <detail>` | The chain's RPC failed while reading the factory. The body adds `service: "evm_rpc"`. | Retry in a few seconds. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/bsc/flap/vault-schema" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "chain_id": "bsc",
  "factory": "0x2c308ac680fcbf1585e33a509bf33d738214f059",
  "spec_version": "1",
  "description": "Buys back the token with its tax.",
  "is_array": false,
  "fields": [
    {
      "name": "interval",
      "type": "uint256",
      "decimals": 0,
      "description": "Seconds between buybacks."
    }
  ],
  "standing": {
    "registered": true,
    "official": true,
    "risk_level": "low",
    "policy": "open"
  },
  "policies": [],
  "quotes": null
}
```
