Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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.

GET /launch/sol/ansem/config

Returns the costs and tier thresholds of a pump.fun Ansem launch.

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

Parameters

No parameters.

Returns 200 OK · application/json

  • 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.
    Child attributes 2
    • 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

StatusCodeWhen and what to do
422 upstream_failure 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.

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.getAnsemConfig() src/lib/proxima/endpoints/launch/launch.ts

GET /launch/{chain_id}/otcdesks/rewards

Lists the tokens an OTC desks launch can reward its holders in.

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. A basket holds between basket_min and basket_max distinct mints.

Path parameters

  • chain_id enum Required
    Chain to query.
    Possible values solethbscbaserobinhoodmonadarcxlayer

Returns 200 OK · application/json

  • rotation array<object>
    Rewards on rotation.
    Child attributes 7
    • mint string
      Reward mint.
    • symbol string | null
      Symbol.
    • basket_eligible boolean
      Can be part of a basket.
    • kind enum | null
      Asset kind.
      Possible values stockfundcommodityprivatecrypto
    • 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

StatusCodeWhen and what to do
400 bad_request 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.

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.getOtcdesksRewards(chainId) src/lib/proxima/endpoints/launch/launch.ts

List quote tokens

Bearer JWT
GET /launch/{chain_id}/quote-tokens

Lists the quote tokens a platform can pair a new token with.

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 solethbscbaserobinhoodmonadarcxlayer

Query parameters

  • platform string Required
    Platform ID, for example pumpfun or stonkfun.
    Examplestonkfun

Returns 200 OK · application/json

  • quotes array<object>
    Accepted quote tokens.
    Child attributes 9
    • 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 cryptorwa
    • 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

StatusCodeWhen and what to do
400 bad_request platform is not a Solana launch platform ID. Pass a Solana platform ID such as pumpfun, meteoradbc or stonkfun.
422 unprocessable 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.

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.getQuoteTokens(chainId, platform) src/lib/proxima/endpoints/launch/launch.ts

Check a quote token

Bearer JWT
GET /launch/{chain_id}/quote-check

Checks whether a token of your choosing can be used as the quote of a platform.

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.

Path parameters

  • chain_id enum Required
    Chain to query. Only sol is served.
    Possible values solethbscbaserobinhoodmonadarcxlayer

Query parameters

  • platform enum Required
    Platform the quote is checked for.
    Possible values pumpfunlaunchlabmeteoradbcmeteoradamm
  • mint string Required
    Quote token to check.
    ExampleEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
  • 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 · application/json

  • 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.
  • traits object
    Token traits.
    Child attributes 3
    • 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.
    Child attributes 5
    • 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

StatusCodeWhen and what to do
400 bad_request 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 is not a valid Solana address. Send the quote token's mint address in base58.
400 bad_request config is not a valid Solana address. Send the config account address in base58, or leave config out.
400 bad_request platform is not pumpfun, launchlab, meteoradbc or meteoradamm. Use one of those platforms; others take only the quotes listed by List quote tokens.

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.checkQuote(chainId, platform, mint, config?) src/lib/proxima/endpoints/launch/launch.ts

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

Checks whether a token can be the quote of a pump.fun launch.

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 solethbscbaserobinhoodmonadarcxlayer

Query parameters

  • mint string Required
    Quote token to check.
    ExampleEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Returns 200 OK · application/json

  • 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.
  • 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.
    Child attributes 5
    • 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

StatusCodeWhen and what to do
400 bad_request 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 is not a valid Solana address. Send the quote token's mint address in base58.

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.checkPumpfunQuote(chainId, mint) src/lib/proxima/endpoints/launch/launch.ts

GET /launch/robinhood/flywheel/quote-check

Checks whether a token can be the quote of a Flywheel launch on Robinhood.

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

Query parameters

  • mint string Required
    Quote token address.
    Example0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c

Returns 200 OK · application/json

  • 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

StatusCodeWhen and what to do
400 bad_request mint is not a valid EVM address. Send the token's 0x address.

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.checkFlywheelQuote(mint) src/lib/proxima/endpoints/launch/launch.ts

GET /launch/{chain_id}/launchlab/platform

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

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 solethbscbaserobinhoodmonadarcxlayer

Query parameters

  • config string Required
    LaunchLab platform config account.
    ExampleDkA5nngzxcYj2gDvnLfaYvURufYaB19AMV6QDASrecvT
  • quotes string Optional
    Comma-separated quote mints to price, at most 20 once duplicates are dropped. Without it, quotes comes back empty.
    ExampleSo11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v

Returns 200 OK · application/json

  • 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.
    Child attributes 4
    • 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

StatusCodeWhen and what to do
400 bad_request 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 is not a valid Solana address. Send the platform config account address in base58.
400 bad_request An entry of quotes is not a valid Solana address. Send base58 mint addresses separated by commas.
400 bad_request quotes names more than 20 distinct mints. Ask for at most 20 quotes per call.
400 bad_request 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.

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.getLaunchlabPlatform(chainId, config, quotes) src/lib/proxima/endpoints/launch/launch.ts

GET /launch/{chain_id}/meteoradbc/configs

Lists usable Meteora DBC configs quoted in a given token.

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 solethbscbaserobinhoodmonadarcxlayer

Query parameters

  • quote string Required
    Quote mint. SOL and USDC are refused.
    ExampleJUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
  • limit integer Optional Default 20
    Most configs to return, from 1 to 100; values outside are clamped. The app sends 20.

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • quote string
    Quote mint.
  • scanned integer
    Configs scanned.
  • configs array<object>
    Usable configs.
    Child attributes 6
    • 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

StatusCodeWhen and what to do
400 bad_request 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 is not a valid Solana address. Send the quote mint address in base58.
400 bad_request 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 The scan of Meteora's DBC configs failed at the RPC. The body also carries service: "rpc". Retry after a short wait.

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.getDbcConfigs(chainId, quote) src/lib/proxima/endpoints/launch/launch.ts

List Flap quotes

Bearer JWT
GET /launch/{chain_id}/flap/quotes

Lists the quote tokens a Flap launch can use, optionally for a given vault.

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 bscrobinhoodarc

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 stocksbuyback

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • chain_id string
    Chain queried.
  • vault_factory string
    Vault factory checked.
  • quotes array<object>
    Quote tokens.
    Child attributes 5
    • 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 cryptorwa
    • supported boolean | null
      The quote can be used with the requested vault.

Errors

StatusCodeWhen and what to do
400 bad_request 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 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 vault_factory is not an EVM address. Send the factory as a 0x-prefixed 20-byte address.
400 bad_request vault_kind is neither stocks nor buyback. Set vault_kind to stocks or buyback, or pass vault_factory instead.
422 upstream_failure 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.

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.getFlapQuotes(chainId, query?) src/lib/proxima/endpoints/launch/launch.ts

GET /launch/{chain_id}/flap/stocks

Lists the tokenized stocks a Flap stocks vault can hold.

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 bscrobinhoodarc

Returns 200 OK · application/json

  • ok boolean
    true when the request succeeded.
  • chain_id string
    Chain queried.
  • assets array<object>
    Stock tokens.
    Child attributes 2
    • address string
      Token address.
    • name string
      Name.

Errors

StatusCodeWhen and what to do
400 bad_request 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 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.

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.getFlapStocks(chainId) src/lib/proxima/endpoints/launch/launch.ts

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

Lists the tokens a Flap launch can pay dividends in, for a given quote.

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 bscrobinhoodarc

Query parameters

  • quote string Optional
    Quote token address. Omit for the native quote.

Returns 200 OK · application/json

  • 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.
    Child attributes 5
    • 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 cryptorwa
    • supported boolean
      Usable with this quote.

Errors

StatusCodeWhen and what to do
400 bad_request 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 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 quote token Proxima knows on this chain. Pick an address returned by List Flap quotes.
400 bad_request quote is a known token that Flap does not take as a quote on this chain. Pick an address returned by List Flap quotes.
400 bad_request quote was omitted on a chain where Flap takes no native quote. Pass the launch's quote token, taken from List Flap quotes.

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.getFlapDividendTokens(chainId, quote?) src/lib/proxima/endpoints/launch/launch.ts

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

Returns the fields a Flap vault factory expects, with its standing and policies.

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 bscrobinhoodarc

Query parameters

  • factory string Optional
    Vault factory address.
  • kind enum Optional
    Built-in vault kind.
    Possible values stocksbuyback

Returns 200 OK · application/json

  • 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.
    Child attributes 4
    • 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.

Errors

StatusCodeWhen and what to do
400 bad_request 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 factory is not an EVM address. Send the factory as a 0x-prefixed 20-byte address.
400 bad_request 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 runs on this chain but its vault launches are off (Arc). Call it with chain_id set to bsc or robinhood.
400 bad_request 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 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 The chain's RPC failed while reading the factory. The body adds service: "evm_rpc". Retry in a few seconds.

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.getFlapVaultSchema(chainId, query) src/lib/proxima/endpoints/launch/launch.ts