{
  "openapi": "3.1.0",
  "info": {
    "title": "Proxima API",
    "version": "2026-11-22",
    "description": "REST API behind the Proxima app. Guides: https://api-docs.proxima.tools/."
  },
  "servers": [
    {
      "url": "https://api-mig.proxima.tools",
      "description": "Production"
    },
    {
      "url": "https://api.proximatool.dev",
      "description": "Development"
    }
  ],
  "tags": [
    {
      "name": "Platform",
      "description": "Check API health and load the platform constants the web app configures itself from.",
      "x-proxima-group": "Platform"
    },
    {
      "name": "Authentication",
      "description": "Exchange a Turnkey login for a Proxima session token, bind it to a license and manage sessions.",
      "x-proxima-group": "Accounts"
    },
    {
      "name": "Two-factor authentication",
      "description": "Enroll a TOTP app or a wallet as second factor and choose which actions require it.",
      "x-proxima-group": "Accounts"
    },
    {
      "name": "Licenses",
      "description": "Create, validate and bind license keys, and manage the license profile, settings and saved media.",
      "x-proxima-group": "Accounts"
    },
    {
      "name": "Keys",
      "description": "List, export, import and batch-edit the secret keys of a license's wallets.",
      "x-proxima-group": "Accounts"
    },
    {
      "name": "Referrals",
      "description": "Manage referral codes, track referral and cashback earnings, and collect them on-chain.",
      "x-proxima-group": "Accounts"
    },
    {
      "name": "Wallets",
      "description": "Create, list, delete and restore the trading wallets of your account, and manage watched addresses.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Funders",
      "description": "Manage the funder wallets that pay for funding your trading wallets.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Wallet folders",
      "description": "Group trading wallets into named, colored folders.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Generate activity",
      "description": "Run buy-and-sell loops on selected wallets so they build an on-chain trading history.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Funding",
      "description": "Send native tokens from a funder to many wallets, directly or through an exchange.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Withdrawals",
      "description": "Quote and execute withdrawals from your wallets to one address, on the same chain or across chains through an exchange.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Wallet activity",
      "description": "Enroll wallets in activity farms that trade on their own across chains for a set duration.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Shield",
      "description": "Deploy and close a license's private copy of the Proxima on-chain program on Solana.",
      "x-proxima-group": "Wallets"
    },
    {
      "name": "Launches",
      "description": "Create, configure and inspect token launches and their wallet plans.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch platforms",
      "description": "Look up platform configs, quote tokens and options before creating a launch.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch execution",
      "description": "Fund the wallets of a launch, launch it and follow its progress.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch trading",
      "description": "Quote, buy, sell, transfer, burn and lock the token of a live launch from its wallets.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch fees",
      "description": "Collect creator fees, manage fee shares and recipients, and handle holder dividends.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch scripts",
      "description": "Save a launch plan as a script, launch it and steer it while it runs.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch tags",
      "description": "Create colored tags and attach them to launches.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch funding",
      "description": "Price what a launch needs funded, fit holder buys to balances, recover stranded funds and convert funding into the launch's quote token.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Sniper Guard",
      "description": "Watch a launch for buys from outside wallets and react when they cross a threshold.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Allowlist",
      "description": "Control and inspect the run of an allowlist launch.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Liquidity Pool",
      "description": "Inspect, burn or reclaim the pool liquidity a launch holds on Uniswap (EVM) and Meteora DAMM (Solana) launches.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Printr Staking",
      "description": "Stake a Printr launch's tokens from its wallets, list the positions and claim their rewards.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Launch Sharing",
      "description": "Share one launch with other accounts through invites, and manage the grants that result.",
      "x-proxima-group": "Launches"
    },
    {
      "name": "Auto Buy",
      "description": "Run buy strategies on a launched token from the launch's wallets.",
      "x-proxima-group": "Automation"
    },
    {
      "name": "Auto Sell",
      "description": "Run sell strategies on a launched token from the launch's wallets.",
      "x-proxima-group": "Automation"
    },
    {
      "name": "Volume Bot",
      "description": "Generate trading volume on a launch with buy-and-sell round trips from its wallets.",
      "x-proxima-group": "Automation"
    },
    {
      "name": "Cleanup",
      "description": "Move a launch's tokens from one set of its wallets to another over randomized rounds.",
      "x-proxima-group": "Automation"
    },
    {
      "name": "Market Overview",
      "description": "Read daily on-chain activity per chain and per launchpad, and the daily trench score.",
      "x-proxima-group": "Market data"
    },
    {
      "name": "Prices",
      "description": "Read the USD price of each chain's native asset and of the quote tokens launches trade against.",
      "x-proxima-group": "Market data"
    },
    {
      "name": "Charts",
      "description": "Issue the short-lived tokens that authenticate the charts datafeed.",
      "x-proxima-group": "Market data"
    },
    {
      "name": "Activity history",
      "description": "Page through the activity events recorded for an account, a launch, or the system.",
      "x-proxima-group": "Market data"
    },
    {
      "name": "Dashboard",
      "description": "Aggregate the caller's activity events into volume, fee and count totals.",
      "x-proxima-group": "Market data"
    },
    {
      "name": "X Tracker",
      "description": "Follow X accounts in real time, organize them in lists, and research tweets for token deploys.",
      "x-proxima-group": "Market data"
    },
    {
      "name": "Marketplace catalog",
      "description": "Browse aged wallets for sale, with filter bounds, funding sources and native token prices.",
      "x-proxima-group": "Marketplace"
    },
    {
      "name": "Marketplace orders",
      "description": "Reserve wallets with a quote, pay for it, take delivery and review past purchases.",
      "x-proxima-group": "Marketplace"
    },
    {
      "name": "Support",
      "description": "Open, read and answer support conversations backed by Zammad through the Proxima support worker.",
      "x-proxima-group": "Realtime & services"
    },
    {
      "name": "Datafeed HTTP",
      "description": "HTTP reads on the market datafeed: coin header stats, the screener, wallet explorer reads, token thumbnails and client telemetry.",
      "x-proxima-group": "Realtime & services"
    },
    {
      "name": "Status & health",
      "description": "Read the public OneUptime status page and probe the API's health and latency.",
      "x-proxima-group": "Realtime & services"
    },
    {
      "name": "External integrations",
      "description": "Raw calls outside the REST client: the DexScreener profile order and the pump.fun charity directory.",
      "x-proxima-group": "Realtime & services"
    },
    {
      "name": "Image proxy",
      "description": "Load token and media images from Proxima's image proxy instead of third-party CDNs.",
      "x-proxima-group": "Realtime & services"
    },
    {
      "name": "Users and licenses",
      "description": "List accounts with their metrics, create licenses, and change fees, referrers, keys and status.",
      "x-proxima-group": "Admin"
    },
    {
      "name": "Admin launches",
      "description": "List every account's launches with revenue and referral figures, and read any launch.",
      "x-proxima-group": "Admin"
    },
    {
      "name": "Admin referrals",
      "description": "Manage referral codes and read referral performance across accounts.",
      "x-proxima-group": "Admin"
    },
    {
      "name": "Analytics",
      "description": "Aggregate revenue, P&L, launches and user activity for the admin dashboard.",
      "x-proxima-group": "Admin"
    },
    {
      "name": "Retention",
      "description": "Track how users progress, return and drop off over their lifetime.",
      "x-proxima-group": "Admin"
    },
    {
      "name": "Fee sinks",
      "description": "Inspect the rotating fee-receiver pool and trigger sweeps, rotations and drains.",
      "x-proxima-group": "Admin"
    }
  ],
  "paths": {
    "/health": {
      "get": {
        "operationId": "platform.check-health",
        "summary": "Check API health",
        "description": "Returns a liveness flag and the server time.\n\nNot called by the current web app.",
        "tags": [
          "Platform"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` when the API is up."
                    },
                    "ts": {
                      "type": "integer",
                      "description": "Server time, in Unix milliseconds."
                    }
                  },
                  "required": [
                    "ok",
                    "ts"
                  ]
                },
                "example": {
                  "ok": true,
                  "ts": 1793613600123
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/platform/#check-health"
        }
      }
    },
    "/get-constants": {
      "get": {
        "operationId": "platform.retrieve-constants",
        "summary": "Retrieve platform constants",
        "description": "Returns the platform configuration for the current license.\n\nThe web app loads constants once a license is selected and refetches them every 30 seconds. It reads chain and platform availability, launch and funding bounds, the Shield funder minimum and the `fee_activation` switch that opens the Rewards section.",
        "tags": [
          "Platform"
        ],
        "responses": {
          "200": {
            "description": "Returns a [Constants](#object-constants) object.",
            "content": {
              "application/json": {
                "example": {
                  "launch_scripts_only": false,
                  "fee_activation": {
                    "active": true,
                    "referral": true
                  },
                  "funding": {
                    "buyback_min_fund_multiplier": 1.2,
                    "max_funding_delay": 60,
                    "min_holder_base_funding": 0.01
                  },
                  "aged_wallets": {
                    "max_delay": 30,
                    "max_loops": 5,
                    "min_balance_multiplier": 1.5
                  },
                  "launch": {
                    "min_buy_delay_mev": 0,
                    "max_buy_delay_mev": 10,
                    "min_buy_delay_stagger": 1,
                    "max_buy_delay_stagger": 60,
                    "min_holders_count": 1,
                    "max_holders_count": 50,
                    "max_total_buy_percentage": {
                      "pumpfun": 80
                    },
                    "default_front_to_back_delay_ms": 400,
                    "default_back_to_temp_delay_ms": 800,
                    "max_mev_step_delay_ms": 5000,
                    "autosell": {
                      "max_autosell_session_duration": 3600,
                      "min_replication_factor": 1,
                      "max_replication_factor": 10,
                      "min_swap_back_rate": 0.1,
                      "min_timed_exact_in_delay": 1,
                      "max_timed_exact_in_delay": 300
                    }
                  },
                  "chains": {
                    "sol": {
                      "network_type": "svm",
                      "chainId": "sol",
                      "name": "Solana",
                      "symbol": "SOL",
                      "decimals": 9,
                      "live": true,
                      "dexs": {
                        "pumpfun": {
                          "id": "pumpfun",
                          "name": "Pump.fun",
                          "decimals": 6,
                          "live": true,
                          "available_quotes": [
                            "So11111111111111111111111111111111111111112"
                          ],
                          "max_total_buy_percentage": 80,
                          "max_dev_buy_percentage": 80
                        }
                      },
                      "lock_token": false
                    },
                    "bsc": {
                      "network_type": "evm",
                      "chainId": "bsc",
                      "name": "BNB Chain",
                      "symbol": "BNB",
                      "decimals": 18,
                      "live": true,
                      "dexs": {
                        "fourmeme": {
                          "id": "fourmeme",
                          "name": "Four.meme",
                          "decimals": 18,
                          "live": true
                        }
                      },
                      "tokens": {
                        "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c": {
                          "symbol": "BNB",
                          "decimals": "1000000000000000000"
                        }
                      },
                      "lock_token": {
                        "fee_bps": 100,
                        "min_native_balance": 0.01
                      },
                      "volume_bundle": true
                    }
                  },
                  "ocp": {
                    "minimum_funder_balance": 7000000000
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/platform/#retrieve-constants"
        }
      }
    },
    "/auth/exchange": {
      "post": {
        "operationId": "authentication.exchange-token",
        "summary": "Exchange a Turnkey token",
        "description": "Trades a Turnkey session JWT for a Proxima session token.\n\nCreates the user on first login, opens a session (recording IP, location and user agent) and returns the account's licenses. When the account owns exactly one license and it is active, the returned token is already upgraded and `license_key` is set; otherwise the token is a base token and the client picks a license, then calls [Upgrade a session token](#upgrade-token).\n\nThe web app calls this right after every Turnkey login.",
        "tags": [
          "Authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "turnkey_jwt": {
                    "type": "string",
                    "description": "Turnkey session JWT. It is the credential for this call."
                  }
                },
                "required": [
                  "turnkey_jwt"
                ]
              },
              "example": {
                "turnkey_jwt": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiZTFiN2M1YTMifQ.ZXhhbXBsZS1zaWduYXR1cmU"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "token": {
                      "type": "string",
                      "description": "Proxima JWT to send as `Authorization: Bearer <token>`."
                    },
                    "session_id": {
                      "type": "string",
                      "description": "Id of the new session."
                    },
                    "user_id": {
                      "type": "string",
                      "description": "Proxima user id."
                    },
                    "role": {
                      "type": "string",
                      "description": "Role of the user: `PUBLIC` or `ADMIN`."
                    },
                    "expires_at": {
                      "type": "integer",
                      "description": "Session expiry, in Unix seconds."
                    },
                    "licenses": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Licenses owned by the account, as [License summary](/reference/licenses/#object-license-summary) objects."
                    },
                    "license_key": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "License the token is bound to when it was upgraded automatically, else `null`."
                    }
                  },
                  "required": [
                    "ok",
                    "token",
                    "session_id",
                    "user_id",
                    "role",
                    "expires_at",
                    "licenses",
                    "license_key"
                  ]
                },
                "example": {
                  "ok": true,
                  "token": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIzZjZjMWEyZS04YjRkLTRjN2EtOWUyMS01ZDBiN2Y4YTZjMTMifQ.dGhpcy1pcy1ub3QtYS1yZWFsLXNpZ25hdHVyZQ",
                  "session_id": "3f6c1a2e-8b4d-4c7a-9e21-5d0b7f8a6c13",
                  "user_id": "a91d4e70-2c3b-4f6e-8d15-7b9c0e2f4a68",
                  "role": "PUBLIC",
                  "expires_at": 1794218400,
                  "license_key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                  "licenses": [
                    {
                      "key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                      "account_id": "5e2b8c41-7d9a-4e3f-b6c0-1a4d7f9e2b35",
                      "username": "nova",
                      "display_name": "Nova",
                      "avatar_url": "https://cdn.example.com/profile-avatars/2f9c4e1a.png",
                      "banner_url": null,
                      "banner_theme": "orbit",
                      "tier": "pro",
                      "is_active": true
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "`unauthorized`: The Turnkey JWT has expired. Log in with Turnkey again and send the new session JWT.\n\n`unauthorized`: The Turnkey JWT signature does not verify. A malformed JWT gets the same status with a message starting with `invalid turnkey jwt`. Send the session JWT exactly as Turnkey returned it.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "summary": "The Turnkey JWT has expired.",
                    "value": {
                      "ok": false,
                      "code": "unauthorized",
                      "message": "turnkey jwt expired"
                    }
                  },
                  "unauthorized_2": {
                    "summary": "The Turnkey JWT signature does not verify. A malformed JWT gets the same status with a message starting with `invalid turnkey jwt`.",
                    "value": {
                      "ok": false,
                      "code": "unauthorized",
                      "message": "turnkey jwt signature verification failed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call opens a new session. A session whose token was lost expires on its own, or end it with [Revoke a session](/reference/authentication/#revoke-session)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#exchange-token"
        }
      }
    },
    "/auth/upgrade": {
      "post": {
        "operationId": "authentication.upgrade-token",
        "summary": "Upgrade a session token",
        "description": "Issues a token bound to one license of the session.\n\nAccepts a base or an upgraded token. Regular users can only upgrade to a license they own; admins can upgrade to any active license, which the admin \"Connect as\" action relies on. The new token expires with the session.\n\nThe web app calls this after the user picks a license at login, after signup, and when switching license.",
        "tags": [
          "Authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "license_key": {
                    "type": "string",
                    "description": "License to bind the token to."
                  }
                },
                "required": [
                  "license_key"
                ]
              },
              "example": {
                "license_key": "NOVA-x7Kp2QmZr9Tb4Lw8E"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "token": {
                      "type": "string",
                      "description": "Upgraded Proxima JWT."
                    },
                    "license_key": {
                      "type": "string",
                      "description": "License the token is bound to."
                    },
                    "role": {
                      "type": "string",
                      "description": "Role of the user: `PUBLIC` or `ADMIN`."
                    },
                    "expires_at": {
                      "type": "integer",
                      "description": "Token expiry, in Unix seconds. Equal to the session expiry."
                    }
                  },
                  "required": [
                    "ok",
                    "token",
                    "license_key",
                    "role",
                    "expires_at"
                  ]
                },
                "example": {
                  "ok": true,
                  "token": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIzZjZjMWEyZS04YjRkLTRjN2EtOWUyMS01ZDBiN2Y4YTZjMTMifQ.dGhpcy1pcy1ub3QtYS1yZWFsLXNpZ25hdHVyZQ",
                  "license_key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                  "role": "PUBLIC",
                  "expires_at": 1794218400
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The license key format is invalid. Send a key returned by [List the account's licenses](/reference/licenses/#list-account-licenses).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The license key format is invalid.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid license_key format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license is inactive. Upgrade onto another license from [List the account's licenses](/reference/licenses/#list-account-licenses).\n\n`forbidden`: The license does not belong to the caller. Admins can upgrade onto any license. Associate the license first with [Associate a license](/reference/licenses/#associate-license).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license is inactive.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "license_key is inactive"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The license does not belong to the caller. Admins can upgrade onto any license.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "license_key does not belong to this user"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The license key does not exist. Send a key returned by [List the account's licenses](/reference/licenses/#list-account-licenses).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The license key does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "license_key not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Only issues a new token for the same session."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#upgrade-token"
        }
      }
    },
    "/auth/me": {
      "get": {
        "operationId": "authentication.retrieve-current-session",
        "summary": "Retrieve the current session",
        "description": "Returns the user, session and license behind the current token.\n\nWorks with base and upgraded tokens. The web app calls it at startup to validate a stored token; if the call fails, it clears the stored session.",
        "tags": [
          "Authentication"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "user_id": {
                      "type": "string",
                      "description": "Proxima user id."
                    },
                    "turnkey_user_id": {
                      "type": "string",
                      "description": "Turnkey user id."
                    },
                    "role": {
                      "type": "string",
                      "description": "Role of the user: `PUBLIC` or `ADMIN`."
                    },
                    "session_id": {
                      "type": "string",
                      "description": "Id of the current session."
                    },
                    "license_key": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "License the token is bound to, or `null` for a base token."
                    }
                  },
                  "required": [
                    "user_id",
                    "turnkey_user_id",
                    "role",
                    "session_id",
                    "license_key"
                  ]
                },
                "example": {
                  "user_id": "a91d4e70-2c3b-4f6e-8d15-7b9c0e2f4a68",
                  "turnkey_user_id": "e1b7c5a3-9d2f-4b6e-8c4a-3f7d1e9b5a20",
                  "role": "PUBLIC",
                  "session_id": "3f6c1a2e-8b4d-4c7a-9e21-5d0b7f8a6c13",
                  "license_key": "NOVA-x7Kp2QmZr9Tb4Lw8E"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#retrieve-current-session"
        }
      }
    },
    "/auth/ws-token": {
      "get": {
        "operationId": "authentication.create-realtime-token",
        "summary": "Create a realtime connection token",
        "description": "Returns a short-lived Centrifugo connection token for the session's account.\n\nThe realtime client requests a fresh token each time it connects or reconnects to the Centrifugo websocket.",
        "tags": [
          "Authentication"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "type": "string",
                      "description": "Centrifugo connection JWT. The SDK method returns this string directly."
                    }
                  },
                  "required": [
                    "token"
                  ]
                },
                "example": {
                  "token": "eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIzZjZjMWEyZS04YjRkLTRjN2EtOWUyMS01ZDBiN2Y4YTZjMTMifQ.dGhpcy1pcy1ub3QtYS1yZWFsLXNpZ25hdHVyZQ"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-client-only": true,
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#create-realtime-token"
        }
      }
    },
    "/auth/sessions": {
      "get": {
        "operationId": "authentication.list-sessions",
        "summary": "List sessions",
        "description": "Lists the sessions of the current account.\n\nThe Sessions settings page uses this list to show active devices and to revoke them.",
        "tags": [
          "Authentication"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "sessions": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [Session](#object-session) objects."
                    }
                  },
                  "required": [
                    "sessions"
                  ]
                },
                "example": {
                  "sessions": [
                    {
                      "id": "3f6c1a2e-8b4d-4c7a-9e21-5d0b7f8a6c13",
                      "is_current": true,
                      "ip": "203.0.113.42",
                      "country": "FR",
                      "region": "Ile-de-France",
                      "city": "Paris",
                      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0 Safari/537.36",
                      "active": true,
                      "created_at": 1793440800,
                      "updated_at": 1793613000,
                      "last_used_at": 1793613000,
                      "expires_at": 1794045600
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#list-sessions"
        }
      }
    },
    "/auth/sessions/{session_id}/revoke": {
      "post": {
        "operationId": "authentication.revoke-session",
        "summary": "Revoke a session",
        "description": "Ends one session of the current account.\n\nEvery token issued for the session stops working. The web app revokes the current session on logout, and revokes other sessions from the Sessions settings page; \"revoke all\" sends one request per session.\n\nRevocation is immediate and cannot be undone. The user must log in again on that device.",
        "tags": [
          "Authentication"
        ],
        "parameters": [
          {
            "name": "session_id",
            "in": "path",
            "required": true,
            "description": "Id (UUID) of the session to revoke.",
            "schema": {
              "type": "string"
            },
            "example": "c4f7a2d9-1e6b-4a83-9f5c-2d8e0b7a3c61"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "session_id": {
                      "type": "string",
                      "description": "Id of the revoked session."
                    }
                  },
                  "required": [
                    "ok",
                    "session_id"
                  ]
                },
                "example": {
                  "ok": true,
                  "session_id": "c4f7a2d9-1e6b-4a83-9f5c-2d8e0b7a3c61"
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No session with this id belongs to the caller. Use an id from [List sessions](/reference/authentication/#list-sessions).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No session with this id belongs to the caller.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "session not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Revoking a session that is already revoked succeeds again. If it was the session you are calling with, the retry fails with `401 invalid_session`, which confirms the revocation."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#revoke-session"
        }
      }
    },
    "/.well-known/jwks.json": {
      "get": {
        "operationId": "authentication.retrieve-jwks",
        "summary": "Retrieve the signing keys",
        "description": "Returns the public keys that verify Proxima JWTs.\n\nA standard JWKS document. Proxima tokens are signed with ES256 (P-256).\n\nNot called by the current web app.",
        "tags": [
          "Authentication"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "keys": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "kty": {
                            "type": "string",
                            "description": "Key type, `EC`."
                          },
                          "crv": {
                            "type": "string",
                            "description": "Curve, `P-256`."
                          },
                          "alg": {
                            "type": "string",
                            "description": "Algorithm, `ES256`."
                          },
                          "use": {
                            "type": "string",
                            "description": "Key use, `sig`."
                          },
                          "kid": {
                            "type": "string",
                            "description": "Key id, matched against the `kid` header of a token."
                          },
                          "x": {
                            "type": "string",
                            "description": "Base64url X coordinate."
                          },
                          "y": {
                            "type": "string",
                            "description": "Base64url Y coordinate."
                          }
                        },
                        "required": [
                          "kty",
                          "crv",
                          "alg",
                          "use",
                          "kid",
                          "x",
                          "y"
                        ]
                      },
                      "description": "Signing keys."
                    }
                  },
                  "required": [
                    "keys"
                  ]
                },
                "example": {
                  "keys": [
                    {
                      "kty": "EC",
                      "crv": "P-256",
                      "alg": "ES256",
                      "use": "sig",
                      "kid": "px-2026-10",
                      "x": "f83OJ3D2xF1Bg8vub9tLe1gHMzV76e8Tus9uPHvRVEU",
                      "y": "x_FEzRu9m36HLN_tue659LNpXW6pCyStikYjKIWI5a0"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#retrieve-jwks"
        }
      }
    },
    "/auth/wallet/resolve-org": {
      "post": {
        "operationId": "authentication.resolve-wallet-organization",
        "summary": "Resolve a wallet's organization",
        "description": "Finds the Turnkey sub-organization a wallet authenticator belongs to.\n\nSend `wallet_address` or `public_key`. The login page calls this before a wallet login to pass the sub-organization to Turnkey. The Connections settings call it before linking a wallet, to refuse one already linked to another Proxima account.",
        "tags": [
          "Authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet_address": {
                    "type": "string",
                    "description": "Wallet address: `0x` address on EVM, base58 on Solana. Preferred, as it needs no signature."
                  },
                  "public_key": {
                    "type": "string",
                    "description": "Lowercase hex public key, used when `wallet_address` is not sent."
                  }
                }
              },
              "example": {
                "wallet_address": "7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "found": {
                      "type": "boolean",
                      "description": "Whether the wallet is linked to an account."
                    },
                    "sub_org_id": {
                      "type": "string",
                      "description": "Turnkey sub-organization id. Present only when `found` is `true`."
                    }
                  },
                  "required": [
                    "found"
                  ]
                },
                "example": {
                  "found": true,
                  "sub_org_id": "7d3e9b2a-4c1f-4e8d-a6b5-0f2c9e7d1a34"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: Neither `wallet_address` nor `public_key` was sent. Send the wallet address, or the public key of the wallet authenticator.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "Neither `wallet_address` nor `public_key` was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_address or public_key required"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 30 lookups per minute from the same IP. Wait a minute before looking up again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 30 lookups per minute from the same IP.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for resolve_wallet_org, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#resolve-wallet-organization"
        }
      }
    },
    "/auth/email/resolve-org": {
      "post": {
        "operationId": "authentication.resolve-email-organization",
        "summary": "Resolve an email's organization",
        "description": "Finds the Turnkey sub-organization an email login belongs to.\n\nEmails are compared case-insensitively, so a differently-cased address logs into the existing account instead of creating a duplicate. The login page calls this before an email code login.",
        "tags": [
          "Authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "Email address."
                  }
                },
                "required": [
                  "email"
                ]
              },
              "example": {
                "email": "jane@example.com"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "found": {
                      "type": "boolean",
                      "description": "Whether an account uses this email."
                    },
                    "sub_org_id": {
                      "type": "string",
                      "description": "Turnkey sub-organization id. Present only when `found` is `true`."
                    }
                  },
                  "required": [
                    "found"
                  ]
                },
                "example": {
                  "found": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `email` is empty. Send the email address the user signs in with.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`email` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "email required"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 30 lookups per minute from the same IP. Wait a minute before looking up again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 30 lookups per minute from the same IP.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for resolve_email_org, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#resolve-email-organization"
        }
      }
    },
    "/auth/wallet/register": {
      "post": {
        "operationId": "authentication.register-wallet",
        "summary": "Register a wallet authenticator",
        "description": "Adds a wallet authenticator to Proxima's wallet index for the current user.\n\nThe Connections settings call this when the user adds a wallet as a login method, before creating the matching Turnkey API key. Registering a wallet the caller already registered succeeds with `inserted: false`.",
        "tags": [
          "Authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "public_key": {
                    "type": "string",
                    "description": "Public key of the wallet authenticator."
                  },
                  "sub_org_id": {
                    "type": "string",
                    "description": "Turnkey sub-organization of the current user."
                  },
                  "wallet_address": {
                    "type": "string",
                    "description": "Wallet address. EVM addresses are stored lowercased."
                  },
                  "chain": {
                    "type": "string",
                    "enum": [
                      "evm",
                      "solana"
                    ],
                    "description": "Wallet type."
                  },
                  "is_primary": {
                    "type": "boolean",
                    "description": "`true` for the wallet used at signup, `false` for wallets added later.",
                    "default": "false"
                  }
                },
                "required": [
                  "public_key",
                  "sub_org_id",
                  "wallet_address",
                  "chain"
                ]
              },
              "example": {
                "public_key": "02a1633cafcc01ebfb6d78e39f687a1f0995c62fc95f51ead10a02ee0be551b5dc",
                "sub_org_id": "7d3e9b2a-4c1f-4e8d-a6b5-0f2c9e7d1a34",
                "wallet_address": "0x8f3c2a91d4e7b6058c1f9a2e3d4b5c6a7e8f9012",
                "chain": "evm",
                "is_primary": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "inserted": {
                      "type": "boolean",
                      "description": "`false` when the wallet was already registered for this user."
                    }
                  },
                  "required": [
                    "ok",
                    "inserted"
                  ]
                },
                "example": {
                  "ok": true,
                  "inserted": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: A field is empty: `public_key`, `sub_org_id` or `wallet_address`. The message names the first empty one, for example `sub_org_id required`. Send every field with a non-empty value.\n\n`bad_request`: `chain` is not `evm` or `solana`. Send `evm` or `solana`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "A field is empty: `public_key`, `sub_org_id` or `wallet_address`. The message names the first empty one, for example `sub_org_id required`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "public_key required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`chain` is not `evm` or `solana`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "chain must be 'evm' or 'solana'"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The wallet is already linked to another account. Unregister it from the other account first, or use another wallet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The wallet is already linked to another account.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "this wallet is already linked to another account"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 20 registrations per minute for the user. Wait a minute before registering again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 20 registrations per minute for the user.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for register_wallet, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Registering a wallet already linked to the caller succeeds with `inserted: false`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#register-wallet"
        }
      }
    },
    "/auth/wallet/unregister": {
      "post": {
        "operationId": "authentication.unregister-wallet",
        "summary": "Unregister a wallet authenticator",
        "description": "Removes a wallet authenticator of the current user from the wallet index.\n\nCalled after the matching Turnkey API key is deleted. A wallet that is not registered returns `deleted: false` instead of an error, so retries are safe.",
        "tags": [
          "Authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "public_key": {
                    "type": "string",
                    "description": "Public key of the wallet authenticator."
                  }
                },
                "required": [
                  "public_key"
                ]
              },
              "example": {
                "public_key": "02a1633cafcc01ebfb6d78e39f687a1f0995c62fc95f51ead10a02ee0be551b5dc"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "deleted": {
                      "type": "boolean",
                      "description": "Whether a registration was removed."
                    }
                  },
                  "required": [
                    "ok",
                    "deleted"
                  ]
                },
                "example": {
                  "ok": true,
                  "deleted": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `public_key` is empty. Send the public key of the wallet authenticator to remove.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`public_key` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "public_key required"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 20 removals per minute for the user. Wait a minute before trying again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 20 removals per minute for the user.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for unregister_wallet, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Removing a wallet that is no longer linked succeeds with `deleted: false`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/authentication/#unregister-wallet"
        }
      }
    },
    "/2fa/status": {
      "get": {
        "operationId": "two-factor.retrieve-status",
        "summary": "Retrieve 2FA status",
        "description": "Returns the second-factor configuration of the account.\n\nThe 2FA settings page loads this first, and only loads actions and backup codes when `enabled` is `true`.",
        "tags": [
          "Two-factor authentication"
        ],
        "responses": {
          "200": {
            "description": "Returns a [Two-factor status](#object-two-factor-status) object.",
            "content": {
              "application/json": {
                "example": {
                  "enabled": true,
                  "method": "totp",
                  "protect_all": false,
                  "wallet_address": null,
                  "wallet_chain": null,
                  "protected_labels": [
                    "wallet.withdraw",
                    "keys.export"
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#retrieve-status"
        }
      }
    },
    "/2fa/actions": {
      "get": {
        "operationId": "two-factor.list-actions",
        "summary": "List protectable actions",
        "description": "Lists every action 2FA can protect, with its current state.",
        "tags": [
          "Two-factor authentication"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "protect_all": {
                      "type": "boolean",
                      "description": "Whether every action is protected."
                    },
                    "twofa_enabled": {
                      "type": "boolean",
                      "description": "Whether 2FA is enabled."
                    },
                    "actions": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [Protected action](#object-protected-action) objects."
                    }
                  },
                  "required": [
                    "protect_all",
                    "twofa_enabled",
                    "actions"
                  ]
                },
                "example": {
                  "protect_all": false,
                  "twofa_enabled": true,
                  "actions": [
                    {
                      "label": "wallet.withdraw",
                      "description": "Withdraw funds from your wallets",
                      "enabled": true
                    },
                    {
                      "label": "wallet.export_funder",
                      "description": "Export a funder wallet's private key",
                      "enabled": false
                    },
                    {
                      "label": "launch.reveal_key",
                      "description": "Export a launch wallet's private key",
                      "enabled": false
                    },
                    {
                      "label": "keys.export",
                      "description": "View or export your wallets' private keys",
                      "enabled": true
                    },
                    {
                      "label": "launch.share",
                      "description": "Share one of your launches with another license",
                      "enabled": false
                    },
                    {
                      "label": "twofa.change_settings",
                      "description": "Change your 2FA settings",
                      "enabled": false
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#list-actions"
        }
      }
    },
    "/2fa/actions/toggle": {
      "post": {
        "operationId": "two-factor.toggle-action",
        "summary": "Toggle an action's protection",
        "description": "Turns 2FA protection on or off for one action.\n\nThe challenge label is `twofa.change_settings`. When the change would lift `keys.export` protection for a user whose license can manage keys, the label is `keys.export` instead, and it is asked even if `twofa.change_settings` is not protected.",
        "tags": [
          "Two-factor authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string",
                    "description": "Action label, one of the labels from [List protectable actions](#list-actions)."
                  },
                  "enabled": {
                    "type": "boolean",
                    "description": "`true` to protect the action, `false` to stop protecting it."
                  }
                },
                "required": [
                  "label",
                  "enabled"
                ]
              },
              "example": {
                "label": "launch.share",
                "enabled": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "label": {
                      "type": "string",
                      "description": "Updated label."
                    },
                    "enabled": {
                      "type": "boolean",
                      "description": "New state."
                    }
                  },
                  "required": [
                    "ok",
                    "label",
                    "enabled"
                  ]
                },
                "example": {
                  "ok": true,
                  "label": "launch.share",
                  "enabled": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The label is unknown. Use a label returned by [List protectable actions](/reference/two-factor/#list-actions).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The label is unknown.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown action label"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "twofa.change_settings",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "`enabled` sets the state, so repeating the call changes nothing. A challenge answer works once, so a protected retry needs a new challenge."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#toggle-action"
        }
      }
    },
    "/2fa/protect-all": {
      "post": {
        "operationId": "two-factor.set-protect-all",
        "summary": "Set Protect everything",
        "description": "Requires 2FA on every protectable action, or goes back to per-action settings.\n\nThe web app sends `enabled: true` right after a successful enrollment.\n\nThe challenge label is `twofa.change_settings`. When the change would lift `keys.export` protection for a user whose license can manage keys, the label is `keys.export` instead, and it is asked even if `twofa.change_settings` is not protected.",
        "tags": [
          "Two-factor authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "`true` to protect every action."
                  }
                },
                "required": [
                  "enabled"
                ]
              },
              "example": {
                "enabled": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "protect_all": {
                      "type": "boolean",
                      "description": "New state."
                    }
                  },
                  "required": [
                    "ok",
                    "protect_all"
                  ]
                },
                "example": {
                  "ok": true,
                  "protect_all": true
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "twofa.change_settings",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "`enabled` sets the state, so repeating the call changes nothing. A challenge answer works once, so a protected retry needs a new challenge."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#set-protect-all"
        }
      }
    },
    "/2fa/totp/enroll/start": {
      "post": {
        "operationId": "two-factor.start-totp-enrollment",
        "summary": "Start TOTP enrollment",
        "description": "Generates a TOTP secret for the user to add to an authenticator app.\n\nNothing is stored yet: the secret only takes effect once [Confirm TOTP enrollment](#confirm-totp-enrollment) succeeds. The web app shows `otpauth_url` as a QR code.",
        "tags": [
          "Two-factor authentication"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "secret": {
                      "type": "string",
                      "description": "Base32 TOTP secret."
                    },
                    "otpauth_url": {
                      "type": "string",
                      "description": "`otpauth://` URI for authenticator apps (SHA1, 6 digits)."
                    },
                    "issuer": {
                      "type": "string",
                      "description": "Issuer shown in the app, `Proxima`."
                    },
                    "account": {
                      "type": "string",
                      "description": "Account label shown in the app: the license key, or `user-<id>` for a base token."
                    }
                  },
                  "required": [
                    "secret",
                    "otpauth_url",
                    "issuer",
                    "account"
                  ]
                },
                "example": {
                  "secret": "KZXW6YTBOJ2GKZLTMVZXIZLSMFWWK3TU",
                  "otpauth_url": "otpauth://totp/Proxima:NOVA-x7Kp2QmZr9Tb4Lw8E?secret=KZXW6YTBOJ2GKZLTMVZXIZLSMFWWK3TU&issuer=Proxima&algorithm=SHA1&digits=6&period=30",
                  "issuer": "Proxima",
                  "account": "NOVA-x7Kp2QmZr9Tb4Lw8E"
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 5 starts per minute. Wait a minute, then start again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 5 starts per minute.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for twofa_totp_start, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Nothing is stored until [Confirm TOTP enrollment](/reference/two-factor/#confirm-totp-enrollment) succeeds. Use the secret from the latest response."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#start-totp-enrollment"
        }
      }
    },
    "/2fa/totp/enroll/confirm": {
      "post": {
        "operationId": "two-factor.confirm-totp-enrollment",
        "summary": "Confirm TOTP enrollment",
        "description": "Verifies a code for the new secret and enables TOTP as second factor.",
        "tags": [
          "Two-factor authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "secret": {
                    "type": "string",
                    "description": "Secret returned by [Start TOTP enrollment](#start-totp-enrollment)."
                  },
                  "code": {
                    "type": "string",
                    "description": "Current 6-digit code from the authenticator app."
                  }
                },
                "required": [
                  "secret",
                  "code"
                ]
              },
              "example": {
                "secret": "KZXW6YTBOJ2GKZLTMVZXIZLSMFWWK3TU",
                "code": "492015"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "method": {
                      "type": "string",
                      "description": "Enrolled method, `totp`."
                    }
                  },
                  "required": [
                    "ok",
                    "method"
                  ]
                },
                "example": {
                  "ok": true,
                  "method": "totp"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `secret` is empty. Send the `secret` returned by [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).\n\n`bad_request`: `code` is not six digits. Send the six-digit code shown by the authenticator app.\n\n`bad_request`: `secret` is not valid base32. Send the `secret` exactly as returned by [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`secret` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "secret required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`code` is not six digits.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "code must be 6 digits"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`secret` is not valid base32.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid base32 character"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "`unauthorized`: The code does not match the secret. Codes change every 30 seconds, and one step of clock drift is accepted. Check the device clock, then send the code the app shows now.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "summary": "The code does not match the secret. Codes change every 30 seconds, and one step of clock drift is accepted.",
                    "value": {
                      "ok": false,
                      "code": "unauthorized",
                      "message": "invalid totp code"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 10 attempts per minute. Wait a minute before trying again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 10 attempts per minute.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for twofa_totp_confirm, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Confirming again stores the same secret. If the code has rotated in the meantime, the retry fails with `401`: check `method` with [Retrieve 2FA status](/reference/two-factor/#retrieve-status)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#confirm-totp-enrollment"
        }
      }
    },
    "/2fa/wallet/enroll/start": {
      "post": {
        "operationId": "two-factor.start-wallet-enrollment",
        "summary": "Start wallet enrollment",
        "description": "Returns a message for the wallet to sign to become the second factor.",
        "tags": [
          "Two-factor authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet_address": {
                    "type": "string",
                    "description": "Wallet address: base58 on Solana, `0x` address on EVM."
                  },
                  "chain": {
                    "type": "string",
                    "enum": [
                      "solana",
                      "evm"
                    ],
                    "description": "Wallet type."
                  }
                },
                "required": [
                  "wallet_address",
                  "chain"
                ]
              },
              "example": {
                "wallet_address": "7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P",
                "chain": "solana"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "twoFaAlgoId": {
                      "type": "string",
                      "description": "Challenge id to send back on confirm."
                    },
                    "challenge": {
                      "type": "string",
                      "description": "Message the wallet must sign."
                    },
                    "wallet_address": {
                      "type": "string",
                      "description": "Normalized address. EVM addresses are lowercased with a `0x` prefix."
                    },
                    "chain": {
                      "type": "string",
                      "enum": [
                        "solana",
                        "evm"
                      ],
                      "description": "Wallet type."
                    }
                  },
                  "required": [
                    "twoFaAlgoId",
                    "challenge",
                    "wallet_address",
                    "chain"
                  ]
                },
                "example": {
                  "twoFaAlgoId": "b2c9e4f1-6a3d-4d8b-9e7c-1f5a3b8d2c46",
                  "challenge": "Proxima 2FA enrollment\nWallet: 7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P\nAlgoId: b2c9e4f1-6a3d-4d8b-9e7c-1f5a3b8d2c46",
                  "wallet_address": "7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P",
                  "chain": "solana"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain` is not `solana` or `evm`. Send `solana` or `evm`.\n\n`bad_request`: `wallet_address` is empty. Send the address of the wallet to enroll.\n\n`bad_request`: The address is not valid for `chain`. For an EVM wallet the message is `invalid evm address: <reason>`. Send a base58 public key for `solana`, or a 20-byte hex address for `evm`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain` is not `solana` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid wallet chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`wallet_address` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_address required"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The address is not valid for `chain`. For an EVM wallet the message is `invalid evm address: <reason>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid solana address: <reason>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 10 starts per minute. Wait a minute, then start again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 10 starts per minute.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for twofa_wallet_start, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call issues a new challenge and stores nothing else. Sign the challenge from the latest response."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#start-wallet-enrollment"
        }
      }
    },
    "/2fa/wallet/enroll/confirm": {
      "post": {
        "operationId": "two-factor.confirm-wallet-enrollment",
        "summary": "Confirm wallet enrollment",
        "description": "Verifies the challenge signature and enables the wallet as second factor.",
        "tags": [
          "Two-factor authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "twoFaAlgoId": {
                    "type": "string",
                    "description": "Challenge id returned by [Start wallet enrollment](#start-wallet-enrollment)."
                  },
                  "signature": {
                    "type": "string",
                    "description": "Signature of `challenge` by the wallet."
                  }
                },
                "required": [
                  "twoFaAlgoId",
                  "signature"
                ]
              },
              "example": {
                "twoFaAlgoId": "b2c9e4f1-6a3d-4d8b-9e7c-1f5a3b8d2c46",
                "signature": "4kXr9WmT2bQn7YcHs5Ld3GpZf8Jv6Ae1KuN2Bt7Ew4Mh9Zx3Vr5Cy8Pk2Ds6Gq1Lb4Hn7Wt3Jm9Nf5Re2Uz8Ka6Vb3Qs"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "method": {
                      "type": "string",
                      "description": "Enrolled method, `wallet`."
                    },
                    "wallet_address": {
                      "type": "string",
                      "description": "Enrolled wallet."
                    },
                    "chain": {
                      "type": "string",
                      "enum": [
                        "solana",
                        "evm"
                      ],
                      "description": "Wallet type."
                    }
                  },
                  "required": [
                    "ok",
                    "method",
                    "wallet_address",
                    "chain"
                  ]
                },
                "example": {
                  "ok": true,
                  "method": "wallet",
                  "wallet_address": "7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P",
                  "chain": "solana"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `twoFaAlgoId` is not a valid id. Send the `twoFaAlgoId` returned by [Start wallet enrollment](/reference/two-factor/#start-wallet-enrollment).\n\n`bad_request`: `signature` is not hex, base58 or base64. Send the signature as the wallet returned it.\n\n`bad_request`: The decoded signature has the wrong length: 64 bytes for a Solana wallet, 65 for an EVM wallet (message `evm signature must be 65 bytes, got <length>`). Send the complete signature returned by the wallet.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`twoFaAlgoId` is not a valid id.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid twoFaAlgoId"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`signature` is not hex, base58 or base64.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid signature encoding"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The decoded signature has the wrong length: 64 bytes for a Solana wallet, 65 for an EVM wallet (message `evm signature must be 65 bytes, got <length>`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "ed25519 signature must be 64 bytes, got <length>"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "`unauthorized`: The challenge expired (after 5 minutes), was already used, or was issued to another user. Start again with [Start wallet enrollment](/reference/two-factor/#start-wallet-enrollment) and sign the new challenge.\n\n`unauthorized`: `twoFaAlgoId` identifies a step-up challenge, not an enrollment challenge. Send the `twoFaAlgoId` returned by [Start wallet enrollment](/reference/two-factor/#start-wallet-enrollment).\n\n`unauthorized`: The signature was not made over the challenge by the wallet being enrolled. On EVM the message is `wallet signature does not match`. Sign the `challenge` string exactly as returned, with the wallet whose address you sent.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unauthorized": {
                    "summary": "The challenge expired (after 5 minutes), was already used, or was issued to another user.",
                    "value": {
                      "ok": false,
                      "code": "unauthorized",
                      "message": "enrollment challenge expired or unknown"
                    }
                  },
                  "unauthorized_2": {
                    "summary": "`twoFaAlgoId` identifies a step-up challenge, not an enrollment challenge.",
                    "value": {
                      "ok": false,
                      "code": "unauthorized",
                      "message": "not an enrollment challenge"
                    }
                  },
                  "unauthorized_3": {
                    "summary": "The signature was not made over the challenge by the wallet being enrolled. On EVM the message is `wallet signature does not match`.",
                    "value": {
                      "ok": false,
                      "code": "unauthorized",
                      "message": "invalid wallet signature"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 10 attempts per minute. Wait a minute before trying again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 10 attempts per minute.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for twofa_wallet_confirm, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A successful call consumes the challenge, so a retry fails with `401`. Check `method` and `wallet_address` with [Retrieve 2FA status](/reference/two-factor/#retrieve-status)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#confirm-wallet-enrollment"
        }
      }
    },
    "/2fa/disable": {
      "post": {
        "operationId": "two-factor.disable",
        "summary": "Disable 2FA",
        "description": "Removes the second factor from the account.\n\nEvery protected action, including key exports and withdrawals, stops asking for a second factor.\n\nThe challenge label is `twofa.change_settings`. When the change would lift `keys.export` protection for a user whose license can manage keys, the label is `keys.export` instead, and it is asked even if `twofa.change_settings` is not protected.",
        "tags": [
          "Two-factor authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "confirm": {
                    "type": "boolean",
                    "description": "Must be `true`. The SDK always sends it."
                  }
                },
                "required": [
                  "confirm"
                ]
              },
              "example": {
                "confirm": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "enabled": {
                      "type": "boolean",
                      "description": "Always `false`."
                    }
                  },
                  "required": [
                    "ok",
                    "enabled"
                  ]
                },
                "example": {
                  "ok": true,
                  "enabled": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `confirm` is not `true`. Send `confirm: true`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`confirm` is not `true`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "confirm=true required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "twofa.change_settings",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Once 2FA is off, a retry succeeds without a challenge and changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#disable"
        }
      }
    },
    "/2fa/backup-codes/status": {
      "get": {
        "operationId": "two-factor.retrieve-backup-code-status",
        "summary": "Retrieve backup code status",
        "description": "Returns how many backup codes exist and how many are unused.",
        "tags": [
          "Two-factor authentication"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "twofa_enabled": {
                      "type": "boolean",
                      "description": "Whether 2FA is enabled."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Number of codes in the current set."
                    },
                    "remaining": {
                      "type": "integer",
                      "description": "Unused codes left."
                    },
                    "last_generated_at": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "When the current set was generated (UTC timestamp), or `null` if none was."
                    }
                  },
                  "required": [
                    "twofa_enabled",
                    "total",
                    "remaining",
                    "last_generated_at"
                  ]
                },
                "example": {
                  "twofa_enabled": true,
                  "total": 10,
                  "remaining": 8,
                  "last_generated_at": "2026-10-14T08:31:52.204118"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#retrieve-backup-code-status"
        }
      }
    },
    "/2fa/backup-codes/regenerate": {
      "post": {
        "operationId": "two-factor.regenerate-backup-codes",
        "summary": "Regenerate backup codes",
        "description": "Replaces all backup codes with a new set and returns it.\n\nThe codes are only returned in this response. The web app shows them once and offers a text file download.\n\nPrevious backup codes stop working immediately.\n\nThe challenge label is `twofa.change_settings`.",
        "tags": [
          "Two-factor authentication"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "confirm": {
                    "type": "boolean",
                    "description": "Must be `true`. The SDK always sends it."
                  }
                },
                "required": [
                  "confirm"
                ]
              },
              "example": {
                "confirm": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "codes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "New single-use backup codes."
                    },
                    "count": {
                      "type": "integer",
                      "description": "Number of codes."
                    }
                  },
                  "required": [
                    "ok",
                    "codes",
                    "count"
                  ]
                },
                "example": {
                  "ok": true,
                  "codes": [
                    "3f9a1-c07be",
                    "8d2e4-71af0",
                    "b56c9-2e8d1",
                    "04fa7-9c3b2",
                    "e19d8-5a6c4",
                    "7c0b3-d4e92",
                    "5a8f1-0b7c6",
                    "c2e60-8f1a9",
                    "91b4d-3e7f5",
                    "6d7a2-c9e03"
                  ],
                  "count": 10
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `confirm` is not `true`. Send `confirm: true`.\n\n`bad_request`: No 2FA method is enabled. Enroll an authenticator app or a wallet first, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`confirm` is not `true`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "confirm=true required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "No 2FA method is enabled.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "enable a 2FA method before generating backup codes"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 5 regenerations per minute. Wait a minute before regenerating again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 5 regenerations per minute.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for twofa_backup_regenerate, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "twofa.change_settings",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call replaces the whole set. A retry invalidates the codes of a lost response and returns the only valid set."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/two-factor/#regenerate-backup-codes"
        }
      }
    },
    "/license/validate-license-key": {
      "get": {
        "operationId": "licenses.validate-license-key",
        "summary": "Validate a license key",
        "description": "Checks that a license key exists, is active and is not yet bound to an account.\n\nThe login page calls this before letting the user sign in with a key, including a key saved by a signup made while logged out. The client only reads the HTTP status and maps it to a message.",
        "tags": [
          "Licenses"
        ],
        "parameters": [
          {
            "name": "key",
            "in": "query",
            "required": true,
            "description": "License key to check.",
            "schema": {
              "type": "string"
            },
            "example": "NOVA-x7Kp2QmZr9Tb4Lw8E"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`. Any other outcome is an error status."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: Invalid license key format. Send the key exactly as issued: 10 to 50 letters, digits or dashes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "Invalid license key format.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid license_key format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license key is inactive. Use another key. An inactive license cannot be associated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license key is inactive.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "license_key is inactive"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The license key does not exist. Check the key for typos.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The license key does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "license_key not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The license key is already associated to an account. Sign in with the account that owns it, or have that account release it with [Dissociate a license](/reference/licenses/#dissociate-license).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The license key is already associated to an account.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "license_key already associated"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 10 checks per minute from the same IP. Wait a minute before checking again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 10 checks per minute from the same IP.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for validate_license_key, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#validate-license-key"
        }
      }
    },
    "/license/signup": {
      "post": {
        "operationId": "licenses.create-license",
        "summary": "Sign up for a license",
        "description": "Creates a license with a username and a referral code.\n\nThe key is the uppercased username, a dash and 17 random characters. The referral code's owner becomes the license's referrer, and one use of the code is consumed.\n\nWhen the user is signed in, the web app then associates the key with the account and upgrades the token. Otherwise it saves the key in a cookie and sends the user to the login page.\n\nThe license key is the credential of the license. Store it securely.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string",
                    "description": "Unique handle. The web app accepts 3-24 letters and digits."
                  },
                  "referral_code": {
                    "type": "string",
                    "description": "Referral code of an existing license. Case-insensitive."
                  }
                },
                "required": [
                  "username",
                  "referral_code"
                ]
              },
              "example": {
                "username": "nova",
                "referral_code": "orbit-labs"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "license_key": {
                      "type": "string",
                      "description": "The new license key."
                    },
                    "referrer_key": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Referrer license, or `null`."
                    },
                    "codes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Referral codes issued to the new license."
                    }
                  },
                  "required": [
                    "license_key",
                    "referrer_key",
                    "codes"
                  ]
                },
                "example": {
                  "license_key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                  "referrer_key": null,
                  "codes": [
                    "nova"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `username` breaks a rule: letters, digits and hyphens, 3 to 50 characters, starting and ending with a letter or digit. The message names the broken rule, for example `username must be 3-50 chars`. Pick a username that follows these rules.\n\n`bad_request`: Another license already uses this username. Pick another username.\n\n`bad_request`: `referral_code` is missing or empty. Send the referral code the user was invited with.\n\n`bad_request`: The referral code does not exist, has no uses left, has expired, is inactive, or belongs to an inactive license. Ask the referrer for a valid code.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`username` breaks a rule: letters, digits and hyphens, 3 to 50 characters, starting and ending with a letter or digit. The message names the broken rule, for example `username must be 3-50 chars`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "username must be letters, numbers, or hyphens"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Another license already uses this username.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "username already exists"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`referral_code` is missing or empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "referral_code is required"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The referral code does not exist, has no uses left, has expired, is inactive, or belongs to an inactive license.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid, exhausted, expired, or inactive referral code"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 5 signups in 10 minutes from the same IP, or more than 30 per hour with the same code (message names `license_signup_code`). Wait before signing up again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 5 signups in 10 minutes from the same IP, or more than 30 per hour with the same code (message names `license_signup_code`).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for license_signup, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "The username is unique, so a retry cannot create a second license: it fails with `username already exists` when the first call went through. The license key is only returned by that first call."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#create-license"
        }
      }
    },
    "/auth/licenses": {
      "get": {
        "operationId": "licenses.list-account-licenses",
        "summary": "List the account's licenses",
        "description": "Lists the licenses bound to the current account.\n\nWorks with base and upgraded tokens. The web app uses it for the license picker and the account licenses list.",
        "tags": [
          "Licenses"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "licenses": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [License summary](#object-license-summary) objects."
                    }
                  },
                  "required": [
                    "licenses"
                  ]
                },
                "example": {
                  "licenses": [
                    {
                      "key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                      "account_id": "5e2b8c41-7d9a-4e3f-b6c0-1a4d7f9e2b35",
                      "username": "nova",
                      "display_name": "Nova",
                      "avatar_url": "https://cdn.example.com/profile-avatars/2f9c4e1a.png",
                      "banner_url": null,
                      "banner_theme": "orbit",
                      "tier": "pro",
                      "is_active": true
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#list-account-licenses"
        }
      }
    },
    "/auth/licenses/associate": {
      "post": {
        "operationId": "licenses.associate-license",
        "summary": "Associate a license",
        "description": "Binds an unowned license key to the current account.\n\nThe first account to claim a license wins. Associating a license the caller already owns succeeds with `already_associated: true`. The web app calls this at login with a key, and after signup.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "license_key": {
                    "type": "string",
                    "description": "License key to claim."
                  }
                },
                "required": [
                  "license_key"
                ]
              },
              "example": {
                "license_key": "NOVA-x7Kp2QmZr9Tb4Lw8E"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "license_key": {
                      "type": "string",
                      "description": "Associated license. Present when the license was newly bound."
                    },
                    "already_associated": {
                      "type": "boolean",
                      "description": "`true` when the caller already owned the license."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true,
                  "license_key": "NOVA-x7Kp2QmZr9Tb4Lw8E"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The license key format is invalid. Send the key exactly as issued: 10 to 50 letters, digits or dashes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The license key format is invalid.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid license_key format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license is inactive. Use another key. An inactive license cannot be associated.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license is inactive.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "license_key is inactive"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The license key does not exist. Check the key with [Validate a license key](/reference/licenses/#validate-license-key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The license key does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "license_key not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The license is associated to another account. Have the current owner release it with [Dissociate a license](/reference/licenses/#dissociate-license) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The license is associated to another account.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "license_key already associated to another user"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Associating a license you already own succeeds with `already_associated: true`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#associate-license"
        }
      }
    },
    "/auth/licenses/assign": {
      "post": {
        "operationId": "licenses.assign-license",
        "summary": "Assign a license",
        "description": "Binds an unowned license to the current account, or to another account for admins.\n\nWithout `target_account_id` the license is assigned to the caller. Admins pass `target_account_id` from the admin account editor. A license owned by someone else must be dissociated first.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "license_key": {
                    "type": "string",
                    "description": "License key to assign."
                  },
                  "target_account_id": {
                    "type": "string",
                    "description": "Admin only. Account to assign the license to."
                  }
                },
                "required": [
                  "license_key"
                ]
              },
              "example": {
                "license_key": "NOVALABS-Qw4Rt8Yp2Zx6Cv9Bn",
                "target_account_id": "5e2b8c41-7d9a-4e3f-b6c0-1a4d7f9e2b35"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "license_key": {
                      "type": "string",
                      "description": "Assigned license."
                    },
                    "user_id": {
                      "type": "string",
                      "description": "User the license is now bound to."
                    },
                    "already_associated": {
                      "type": "boolean",
                      "description": "`true` when the target already owned the license."
                    }
                  },
                  "required": [
                    "ok",
                    "license_key",
                    "user_id"
                  ]
                },
                "example": {
                  "ok": true,
                  "license_key": "NOVALABS-Qw4Rt8Yp2Zx6Cv9Bn",
                  "user_id": "a91d4e70-2c3b-4f6e-8d15-7b9c0e2f4a68"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The license key format is invalid. Send the key exactly as issued: 10 to 50 letters, digits or dashes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The license key format is invalid.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid license_key format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license is inactive. Use another key. An inactive license cannot be assigned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license is inactive.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "license_key is inactive"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The license key does not exist. Check the key with [Validate a license key](/reference/licenses/#validate-license-key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The license key does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "license_key not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The license is associated to another account. Release it with [Dissociate a license](/reference/licenses/#dissociate-license) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The license is associated to another account.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "license_key already associated to another user"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Assigning a license to its current owner succeeds with `already_associated: true`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#assign-license"
        }
      }
    },
    "/auth/licenses/dissociate": {
      "post": {
        "operationId": "licenses.dissociate-license",
        "summary": "Dissociate a license",
        "description": "Unbinds a license from its account.\n\nRegular users can only dissociate a license they own; admins can dissociate any license. Dissociating an unowned license succeeds with `already_dissociated: true`.\n\nThe license disappears from the account. Another account can then claim it with the key.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "license_key": {
                    "type": "string",
                    "description": "License key to unbind."
                  }
                },
                "required": [
                  "license_key"
                ]
              },
              "example": {
                "license_key": "NOVALABS-Qw4Rt8Yp2Zx6Cv9Bn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "license_key": {
                      "type": "string",
                      "description": "Unbound license."
                    },
                    "previous_user_id": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "User the license was bound to, or `null`."
                    },
                    "already_dissociated": {
                      "type": "boolean",
                      "description": "`true` when the license had no owner."
                    }
                  },
                  "required": [
                    "ok",
                    "license_key",
                    "previous_user_id",
                    "already_dissociated"
                  ]
                },
                "example": {
                  "ok": true,
                  "license_key": "NOVALABS-Qw4Rt8Yp2Zx6Cv9Bn",
                  "previous_user_id": "a91d4e70-2c3b-4f6e-8d15-7b9c0e2f4a68",
                  "already_dissociated": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The license key format is invalid. Send the key exactly as issued: 10 to 50 letters, digits or dashes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The license key format is invalid.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid license_key format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license belongs to another account. Admins can dissociate any license. Sign in with the account that owns the license.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license belongs to another account. Admins can dissociate any license.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "license_key not owned by caller"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The license key does not exist. Check the key with [Validate a license key](/reference/licenses/#validate-license-key).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The license key does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "license_key not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The license changed owner while the request ran. Nothing was changed. Read the licenses again with [List the account's licenses](/reference/licenses/#list-account-licenses) before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The license changed owner while the request ran. Nothing was changed.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "license ownership changed mid-flight"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Dissociating a license that has no owner succeeds with `already_dissociated: true`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#dissociate-license"
        }
      }
    },
    "/license/get-license-info": {
      "get": {
        "operationId": "licenses.retrieve-license",
        "summary": "Retrieve the license",
        "description": "Returns the license the current token is bound to.",
        "tags": [
          "Licenses"
        ],
        "responses": {
          "200": {
            "description": "Returns a [License](#object-license) object.",
            "content": {
              "application/json": {
                "example": {
                  "key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                  "account_id": "5e2b8c41-7d9a-4e3f-b6c0-1a4d7f9e2b35",
                  "username": "nova",
                  "display_name": "Nova",
                  "avatar_url": "https://cdn.example.com/profile-avatars/2f9c4e1a.png",
                  "banner_url": null,
                  "banner_theme": "orbit",
                  "tier": "pro",
                  "fee_rate": 100,
                  "created_at": "2026-03-14 09:21:07.512334",
                  "can_manage_keys": true,
                  "can_edit_sub_keys": true,
                  "max_wallets": 3000,
                  "use_provider_racing": true,
                  "accepted_tos": "2026-09-27",
                  "total_pnl_native": "48210000000",
                  "total_pnl_usd": "7421350000",
                  "gross_volume_native": "912400000000",
                  "gross_volume_usd": "140512800000",
                  "chains": {
                    "sol": {
                      "total_pnl_native": "48210000000",
                      "total_pnl_usd": "7421350000",
                      "gross_volume_native": "912400000000",
                      "gross_volume_usd": "140512800000",
                      "referral_profit_native": "1250000000",
                      "referral_profit_usd": "192400000"
                    }
                  },
                  "referral": {
                    "is_referred": true,
                    "referral_fee_rate": 2000,
                    "referral_profit_native": "1250000000",
                    "referral_profit_usd": "192400000",
                    "referred_keys_count": 37,
                    "level_rates": [
                      {
                        "level": 1,
                        "rate_bps": 2000,
                        "users": 37
                      }
                    ],
                    "codes": [
                      {
                        "code": "nova",
                        "is_admin": false,
                        "is_primary": true,
                        "status": "active",
                        "use_limit": null,
                        "uses_count": 37,
                        "remaining_uses": null,
                        "expires_at": null,
                        "label": "Twitter bio",
                        "created_at": "2026-03-14 09:21:07.512334"
                      }
                    ]
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The license could not be read. Any database failure on this read returns this error, so it is usually transient. Retry after a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The license could not be read. Any database failure on this read returns this error, so it is usually transient.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Couldn't find license info"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#retrieve-license"
        }
      },
      "post": {
        "operationId": "licenses.update-profile",
        "summary": "Update the license profile",
        "description": "Updates the username, display name, avatar, banner or banner theme.\n\nSame path as [Retrieve the license](#retrieve-license), with `POST`. Omit a field to leave it unchanged; send `null` to clear it. Images are sent as base64 (a data URL is accepted). `banner_theme` takes a preset id: `proxima`, `aurora`, `orbit`, `ember`, `grid`, `anime`, `moon` or `space`.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string",
                    "description": "Unique handle, with or without a leading `@`. Cannot be cleared."
                  },
                  "display_name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Free name, 1-24 characters. `null` clears it."
                  },
                  "avatar": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Base64 image, up to 2 MB. `null` clears it."
                  },
                  "banner": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Base64 image, up to 4 MB. `null` clears it."
                  },
                  "banner_theme": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Banner preset id. `null` clears it."
                  }
                }
              },
              "example": {
                "display_name": "Nova",
                "banner_theme": "orbit"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the updated [License](#object-license) object.",
            "content": {
              "application/json": {
                "example": {
                  "key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                  "account_id": "5e2b8c41-7d9a-4e3f-b6c0-1a4d7f9e2b35",
                  "username": "nova",
                  "display_name": "Nova",
                  "avatar_url": "https://cdn.example.com/profile-avatars/2f9c4e1a.png",
                  "banner_url": null,
                  "banner_theme": "orbit",
                  "tier": "pro",
                  "fee_rate": 100,
                  "created_at": "2026-03-14 09:21:07.512334",
                  "can_manage_keys": true,
                  "can_edit_sub_keys": true,
                  "max_wallets": 3000,
                  "use_provider_racing": true,
                  "accepted_tos": "2026-09-27",
                  "total_pnl_native": "48210000000",
                  "total_pnl_usd": "7421350000",
                  "gross_volume_native": "912400000000",
                  "gross_volume_usd": "140512800000",
                  "chains": {
                    "sol": {
                      "total_pnl_native": "48210000000",
                      "total_pnl_usd": "7421350000",
                      "gross_volume_native": "912400000000",
                      "gross_volume_usd": "140512800000",
                      "referral_profit_native": "1250000000",
                      "referral_profit_usd": "192400000"
                    }
                  },
                  "referral": {
                    "is_referred": true,
                    "referral_fee_rate": 2000,
                    "referral_profit_native": "1250000000",
                    "referral_profit_usd": "192400000",
                    "referred_keys_count": 37,
                    "level_rates": [
                      {
                        "level": 1,
                        "rate_bps": 2000,
                        "users": 37
                      }
                    ],
                    "codes": [
                      {
                        "code": "nova",
                        "is_admin": false,
                        "is_primary": true,
                        "status": "active",
                        "use_limit": null,
                        "uses_count": 37,
                        "remaining_uses": null,
                        "expires_at": null,
                        "label": "Twitter bio",
                        "created_at": "2026-03-14 09:21:07.512334"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No field was sent. Send at least one profile field.\n\n`bad_request`: `username` breaks a rule: letters, digits and hyphens, 3 to 50 characters, starting and ending with a letter or digit. The message names the broken rule. Pick a username that follows these rules.\n\n`bad_request`: `display_name` is empty or longer than 24 characters after trimming. A name with a control or invisible character gets `display name contains a control or invisible character`. Send 1 to 24 visible characters, or `null` to clear the display name.\n\n`bad_request`: `banner_theme` is not a known preset. Send `proxima`, `aurora`, `orbit`, `ember`, `grid`, `anime`, `moon` or `space`, or `null`.\n\n`bad_request`: `avatar` or `banner` is not a PNG, JPEG, WebP or GIF image. Data that is not base64 gets `Invalid base64 image data`; an empty or undecodable image gets `<field> image is empty` or `<field> image could not be read`. Send a base64 PNG, JPEG, WebP or GIF, with or without a `data:` URL prefix.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No field was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "nothing to update"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`username` breaks a rule: letters, digits and hyphens, 3 to 50 characters, starting and ending with a letter or digit. The message names the broken rule.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "username must be letters, numbers, or hyphens"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`display_name` is empty or longer than 24 characters after trimming. A name with a control or invisible character gets `display name contains a control or invisible character`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "display name must be 1-24 chars"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`banner_theme` is not a known preset.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown banner"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`avatar` or `banner` is not a PNG, JPEG, WebP or GIF image. Data that is not base64 gets `Invalid base64 image data`; an empty or undecodable image gets `<field> image is empty` or `<field> image could not be read`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "image must be png, jpeg, webp, or gif"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Another license already uses this username. Pick another username.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Another license already uses this username.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "username already exists"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: An image is over 2 MB (`avatar`) or 4 MB (`banner`). An image over 2,048 px per side (`avatar`), or over 6,144 px per side or 6,144 × 1,024 pixels in total (`banner`), gets `<field> image is <width>x<height>, larger than allowed (max <max> px per side)`. Resize or compress the image.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "An image is over 2 MB (`avatar`) or 4 MB (`banner`). An image over 2,048 px per side (`avatar`), or over 6,144 px per side or 6,144 × 1,024 pixels in total (`banner`), gets `<field> image is <width>x<height>, larger than allowed (max <max> px per side)`.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "<field> image too large (max <max_mb>MB)"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 20 profile updates in 10 minutes. Refused updates count too. Wait a few minutes before updating again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 20 profile updates in 10 minutes. Refused updates count too.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for update_profile, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Every field sets a value, so repeating the call changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#update-profile"
        }
      }
    },
    "/license/accept-tos": {
      "post": {
        "operationId": "licenses.accept-terms",
        "summary": "Accept the terms of service",
        "description": "Records the terms of service version the user accepted.\n\nThe value is stored on the user, so it is shared by every license the user owns, and re-accepting overwrites it. The backend does not check which version is current: the web app sends the version bundled with it and prompts again when `accepted_tos` on the [License](#object-license) differs.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "string",
                    "description": "Accepted version, stored as sent (trimmed)."
                  }
                },
                "required": [
                  "version"
                ]
              },
              "example": {
                "version": "2026-09-27"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "accepted_tos": {
                      "type": "string",
                      "description": "Stored version."
                    }
                  },
                  "required": [
                    "accepted_tos"
                  ]
                },
                "example": {
                  "accepted_tos": "2026-09-27"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `version` is empty. Send the version of the terms the user accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`version` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "version is required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Accepting again stores the same version."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#accept-terms"
        }
      }
    },
    "/license/update-settings": {
      "post": {
        "operationId": "licenses.update-settings",
        "summary": "Update license settings",
        "description": "Turns provider racing on or off for the license.\n\nProvider racing sends each transaction through several providers in parallel to land faster at a lower priority fee. The account settings switch calls this.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "use_provider_racing": {
                    "type": "boolean",
                    "description": "Enable provider racing."
                  }
                },
                "required": [
                  "use_provider_racing"
                ]
              },
              "example": {
                "use_provider_racing": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the [License](#object-license) object.",
            "content": {
              "application/json": {
                "example": {
                  "key": "NOVA-x7Kp2QmZr9Tb4Lw8E",
                  "account_id": "5e2b8c41-7d9a-4e3f-b6c0-1a4d7f9e2b35",
                  "username": "nova",
                  "display_name": "Nova",
                  "avatar_url": "https://cdn.example.com/profile-avatars/2f9c4e1a.png",
                  "banner_url": null,
                  "banner_theme": "orbit",
                  "tier": "pro",
                  "fee_rate": 100,
                  "created_at": "2026-03-14 09:21:07.512334",
                  "can_manage_keys": true,
                  "can_edit_sub_keys": true,
                  "max_wallets": 3000,
                  "use_provider_racing": true,
                  "accepted_tos": "2026-09-27",
                  "total_pnl_native": "48210000000",
                  "total_pnl_usd": "7421350000",
                  "gross_volume_native": "912400000000",
                  "gross_volume_usd": "140512800000",
                  "chains": {
                    "sol": {
                      "total_pnl_native": "48210000000",
                      "total_pnl_usd": "7421350000",
                      "gross_volume_native": "912400000000",
                      "gross_volume_usd": "140512800000",
                      "referral_profit_native": "1250000000",
                      "referral_profit_usd": "192400000"
                    }
                  },
                  "referral": {
                    "is_referred": true,
                    "referral_fee_rate": 2000,
                    "referral_profit_native": "1250000000",
                    "referral_profit_usd": "192400000",
                    "referred_keys_count": 37,
                    "level_rates": [
                      {
                        "level": 1,
                        "rate_bps": 2000,
                        "users": 37
                      }
                    ],
                    "codes": [
                      {
                        "code": "nova",
                        "is_admin": false,
                        "is_primary": true,
                        "status": "active",
                        "use_limit": null,
                        "uses_count": 37,
                        "remaining_uses": null,
                        "expires_at": null,
                        "label": "Twitter bio",
                        "created_at": "2026-03-14 09:21:07.512334"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sets the value, so repeating the call changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#update-settings"
        }
      }
    },
    "/license/get-mints-info": {
      "get": {
        "operationId": "licenses.list-mints",
        "summary": "List the license's launches",
        "description": "Lists every launch the license owns, with its launch tags.\n\nLaunches are returned newest first, with their token metadata, status and PnL. The web app uses this list for the launches dashboard and to preload launch routes. The client also accepts a bare array of launches and normalizes it to `{ mints, tags: [] }`.",
        "tags": [
          "Licenses"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "mints": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "launch_id": {
                            "type": "string",
                            "description": "Public launch ID, as a decimal string. Use it in every `{launch_id}` path."
                          },
                          "chain_id": {
                            "type": "string",
                            "description": "Chain of the launch."
                          },
                          "launch_platform": {
                            "type": "string",
                            "description": "Launch platform id, e.g. `pumpfun`."
                          },
                          "launch_status": {
                            "type": "string",
                            "enum": [
                              "Draft",
                              "Staged",
                              "Pending",
                              "Finalized"
                            ],
                            "description": "Lifecycle status. A multi-launch container reports its group status with the same values."
                          },
                          "mint_pubkey": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Token mint or contract address, or `null` before it exists."
                          },
                          "name": {
                            "type": "string",
                            "description": "Token name."
                          },
                          "symbol": {
                            "type": "string",
                            "description": "Token symbol."
                          },
                          "description": {
                            "type": "string",
                            "description": "Token description."
                          },
                          "image_url": {
                            "type": "string",
                            "description": "Token image URL."
                          },
                          "telegram": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Telegram link."
                          },
                          "twitter": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "X link."
                          },
                          "website": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Website link."
                          },
                          "token_decimals": {
                            "type": "integer",
                            "description": "Token decimals."
                          },
                          "total_supply": {
                            "type": "number",
                            "description": "Total supply."
                          },
                          "created_at": {
                            "type": "integer",
                            "description": "Creation time."
                          },
                          "launched_at": {
                            "type": "integer",
                            "description": "Launch time."
                          },
                          "archived": {
                            "type": "boolean",
                            "description": "Whether the launch is archived."
                          },
                          "is_imported": {
                            "type": "boolean",
                            "description": "Whether the token was imported rather than created by Proxima."
                          },
                          "scheduled_mode": {
                            "type": "boolean",
                            "description": "Whether the launch is scheduled."
                          },
                          "has_launch_plan": {
                            "type": "boolean",
                            "description": "Whether a complete launch plan exists."
                          },
                          "pnl_native": {
                            "type": "string",
                            "description": "PnL in native raw units."
                          },
                          "pnl_usd": {
                            "type": "string",
                            "description": "PnL in micro-USD."
                          },
                          "gross_volume_native": {
                            "type": "string",
                            "description": "Gross volume in native raw units."
                          },
                          "gross_volume_usd": {
                            "type": "string",
                            "description": "Gross volume in micro-USD."
                          },
                          "mm_pnl_native": {
                            "type": "string",
                            "description": "Market-making PnL in native raw units."
                          },
                          "mm_pnl_usd": {
                            "type": "string",
                            "description": "Market-making PnL in micro-USD."
                          },
                          "shared": {
                            "type": "boolean",
                            "description": "Whether the launch is shared: handed to this license, or owned and given to someone else."
                          },
                          "tag_ids": {
                            "type": "array",
                            "items": {
                              "type": "integer"
                            },
                            "description": "Ids of the launch tags on this launch."
                          },
                          "quote_mint": {
                            "type": "string",
                            "description": "Quote token of the pool."
                          }
                        },
                        "required": [
                          "launch_id",
                          "chain_id",
                          "launch_platform",
                          "launch_status",
                          "mint_pubkey",
                          "name",
                          "symbol",
                          "description",
                          "image_url",
                          "telegram",
                          "twitter",
                          "website",
                          "token_decimals",
                          "total_supply",
                          "created_at",
                          "launched_at",
                          "archived",
                          "is_imported",
                          "scheduled_mode",
                          "has_launch_plan",
                          "pnl_native",
                          "pnl_usd",
                          "gross_volume_native",
                          "gross_volume_usd",
                          "mm_pnl_native",
                          "mm_pnl_usd"
                        ]
                      },
                      "description": "Launch cards. Platform-specific fields (fee settings, create parameters, group state) are omitted here."
                    },
                    "tags": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Launch tags of the license: `id`, `name`, `color` and `type`."
                    }
                  },
                  "required": [
                    "mints",
                    "tags"
                  ]
                },
                "example": {
                  "mints": [
                    {
                      "launch_id": "101482937561204",
                      "chain_id": "sol",
                      "launch_platform": "pumpfun",
                      "launch_status": "Finalized",
                      "mint_pubkey": "3TqVn8bYc5WkRm2HxJ7dLf9GpZs4Ae6UuN1KwEh3Bt2C",
                      "name": "Orbit Cat",
                      "symbol": "OCAT",
                      "description": "A cat in low orbit.",
                      "image_url": "https://cdn.example.com/token-images/ocat.png",
                      "telegram": null,
                      "twitter": "https://x.com/orbitcat",
                      "website": null,
                      "token_decimals": 6,
                      "total_supply": 1000000000,
                      "created_at": 1793527200,
                      "launched_at": 1793530800,
                      "archived": false,
                      "is_imported": false,
                      "scheduled_mode": false,
                      "has_launch_plan": true,
                      "pnl_native": "12500000000",
                      "pnl_usd": "1924000000",
                      "gross_volume_native": "240000000000",
                      "gross_volume_usd": "36950000000",
                      "mm_pnl_native": "0",
                      "mm_pnl_usd": "0",
                      "shared": false,
                      "tag_ids": [
                        3
                      ]
                    }
                  ],
                  "tags": [
                    {
                      "id": 3,
                      "name": "Main",
                      "color": "#7c5cff",
                      "type": "classic"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#list-mints"
        }
      }
    },
    "/license/pnl-backgrounds": {
      "get": {
        "operationId": "licenses.list-pnl-backgrounds",
        "summary": "List PnL backgrounds",
        "description": "Lists the PnL card backgrounds saved by the license, newest first.\n\nThe PnL card editor loads the list when it opens.",
        "tags": [
          "Licenses"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "backgrounds": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [PnL background](#object-pnl-background) objects."
                    }
                  },
                  "required": [
                    "backgrounds"
                  ]
                },
                "example": {
                  "backgrounds": [
                    {
                      "id": "9c4e7a1b-3d6f-4b2e-8a5c-7e1d9f3b6a20",
                      "kind": "image",
                      "url": "https://cdn.example.com/pnl-backgrounds/9c4e7a1b.png",
                      "created_at": 1793610000
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#list-pnl-backgrounds"
        }
      },
      "post": {
        "operationId": "licenses.upload-pnl-background",
        "summary": "Upload a PnL background",
        "description": "Saves an image or video as a PnL card background.",
        "tags": [
          "Licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "Image or video file. The type is detected from the content."
                  }
                },
                "required": [
                  "file"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the new [PnL background](#object-pnl-background) object.",
            "content": {
              "application/json": {
                "example": {
                  "id": "9c4e7a1b-3d6f-4b2e-8a5c-7e1d9f3b6a20",
                  "kind": "image",
                  "url": "https://cdn.example.com/pnl-backgrounds/9c4e7a1b.png",
                  "created_at": 1793610000
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The upload could not be read. Send a `multipart/form-data` body with the file in a part named `file`.\n\n`bad_request`: No part named `file` was sent. An empty file gets `file is empty`. Send the file in a part named `file`.\n\n`bad_request`: The file is not a PNG, JPEG, WebP, GIF, MP4 or WebM file. The type is detected from the content. Upload an image (PNG, JPEG, WebP, GIF) or a video (MP4, WebM).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The upload could not be read.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "could not read upload"
                    }
                  },
                  "bad_request_2": {
                    "summary": "No part named `file` was sent. An empty file gets `file is empty`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "file is required"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The file is not a PNG, JPEG, WebP, GIF, MP4 or WebM file. The type is detected from the content.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "file must be a png, jpeg, webp, gif, mp4, or webm"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The license already has 24 backgrounds. Delete one with [Delete a PnL background](/reference/licenses/#delete-pnl-background) first.\n\n`unprocessable`: The file is over 8 MB for an image or 40 MB for a video. Compress the file below the limit.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The license already has 24 backgrounds.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "at most 24 saved backgrounds"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The file is over 8 MB for an image or 40 MB for a video.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "file too large (max <max_mb>MB)"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 30 uploads in 10 minutes. Wait a few minutes before uploading again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 30 uploads in 10 minutes.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for pnl_background_upload, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A retry stores a second copy. Look for the new background with [List PnL backgrounds](/reference/licenses/#list-pnl-backgrounds) before uploading again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#upload-pnl-background"
        }
      }
    },
    "/license/pnl-backgrounds/{background_id}": {
      "delete": {
        "operationId": "licenses.delete-pnl-background",
        "summary": "Delete a PnL background",
        "description": "Deletes a saved PnL card background and its stored file.",
        "tags": [
          "Licenses"
        ],
        "parameters": [
          {
            "name": "background_id",
            "in": "path",
            "required": true,
            "description": "Id (UUID) of the background.",
            "schema": {
              "type": "string"
            },
            "example": "9c4e7a1b-3d6f-4b2e-8a5c-7e1d9f3b6a20"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No background with this id belongs to the license. Use an id from [List PnL backgrounds](/reference/licenses/#list-pnl-backgrounds).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No background with this id belongs to the license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "background not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A retry after a successful delete returns `404 not_found`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/licenses/#delete-pnl-background"
        }
      }
    },
    "/keys/status": {
      "get": {
        "operationId": "keys.retrieve-status",
        "summary": "Retrieve vault status",
        "description": "Returns whether the license can manage keys and how long the unlock window stays open.\n\nNot called by the current web app.",
        "tags": [
          "Keys"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "can_manage_keys": {
                      "type": "boolean",
                      "description": "Whether the license may use the keys vault."
                    },
                    "export_requires_2fa": {
                      "type": "boolean",
                      "description": "Whether reading secrets currently needs a `keys.export` challenge."
                    },
                    "unlocked_for_secs": {
                      "type": "integer",
                      "description": "Seconds left in the unlock window, `0` when closed."
                    }
                  },
                  "required": [
                    "can_manage_keys",
                    "export_requires_2fa",
                    "unlocked_for_secs"
                  ]
                },
                "example": {
                  "can_manage_keys": true,
                  "export_requires_2fa": true,
                  "unlocked_for_secs": 412
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/keys/#retrieve-status"
        }
      }
    },
    "/keys/unlock": {
      "post": {
        "operationId": "keys.unlock",
        "summary": "Unlock the vault",
        "description": "Opens a 10-minute window in which secrets can be read without a new 2FA code.\n\nAsks for the `keys.export` challenge when it is protected. Without 2FA the window opens directly.\n\nNot called by the current web app.",
        "tags": [
          "Keys"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "export_requires_2fa": {
                      "type": "boolean",
                      "description": "Whether `keys.export` is protected."
                    },
                    "unlocked_for_secs": {
                      "type": "integer",
                      "description": "Length of the window, in seconds."
                    }
                  },
                  "required": [
                    "ok",
                    "export_requires_2fa",
                    "unlocked_for_secs"
                  ]
                },
                "example": {
                  "ok": true,
                  "export_requires_2fa": true,
                  "unlocked_for_secs": 600
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license does not have `can_manage_keys`. Use a license with key management enabled. `can_manage_keys` on [Retrieve the license](/reference/licenses/#retrieve-license) tells you.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license does not have `can_manage_keys`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "keys_not_enabled"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "keys.export",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Reopens the 10-minute window. When `keys.export` is protected, each call needs a new challenge."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/keys/#unlock"
        }
      }
    },
    "/keys/{network_type}/list": {
      "post": {
        "operationId": "keys.list",
        "summary": "List keys",
        "description": "Returns one page of wallets with their secret keys.\n\nWithout filters, returns every wallet of the license that has a secret, archived ones excluded. Each filter narrows the selection. For the next page, send the same selector with `cursor` set to `next_cursor`. EVM universal funders are returned on the first page only, and not when filtering by tag or launch.\n\nThe web app uses it to reveal a single wallet's private key (`pubkeys: [pubkey]`, `limit: 1`).\n\nA 2FA challenge is bound to the exact request body, so a new `cursor` would need a new code. Unlock the vault (or pass the first challenge) to page freely for 10 minutes.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "network_type",
            "in": "path",
            "required": true,
            "description": "Network. EVM wallets are shared by every EVM chain.",
            "schema": {
              "type": "string",
              "enum": [
                "svm",
                "evm"
              ]
            },
            "example": "svm"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Only these wallets, up to 5,000. EVM addresses are case-insensitive."
                  },
                  "tag_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Wallets with at least one of these tags."
                  },
                  "kinds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallet kinds among `fresh`, `aged`, `funder` and `archived`."
                  },
                  "launch_ext_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets of these launches, up to 200, all on the path's network. Adds `roles` to each row. Numbers are accepted."
                  },
                  "include_archived": {
                    "type": "boolean",
                    "description": "Include archived wallets. Implied when `kinds` contains `archived`.",
                    "default": "false"
                  },
                  "cursor": {
                    "type": "string",
                    "description": "Cursor from the previous page. Omit for the first page. A number is accepted."
                  },
                  "limit": {
                    "type": "integer",
                    "description": "Page size, up to 1,000. A numeric string is accepted.",
                    "default": "1000"
                  }
                }
              },
              "example": {
                "tag_ids": [
                  12
                ],
                "limit": 200
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "keys": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [Key](#object-key) objects."
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor of the next page, or `null` on the last page."
                    }
                  },
                  "required": [
                    "keys",
                    "next_cursor"
                  ]
                },
                "example": {
                  "keys": [
                    {
                      "id": 48211,
                      "pubkey": "9fGhT2kWm4Ys7QpRn3DxEb6ZcVa8Jt5LuN1HwKq2Ms7F",
                      "secret": "3xYp8RkVb2NqTz7HcWm5Ld9GsJf4Ae6KuQ1Bt3Ew8Mh2Zn5Vr7Cy4Pk9Ds2Gx6Lb3Hq8Wt5Jm1Nf4Re7Uz2Ka9Vb",
                      "kind": "aged",
                      "name": "sniper 1",
                      "tag_ids": [
                        12
                      ],
                      "created_at": 1792404000
                    }
                  ],
                  "next_cursor": null
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `{network_type}` is not `svm` or `evm`. Use `svm` or `evm`.\n\n`bad_request`: `kinds` contains an unknown kind. Use only `fresh`, `aged`, `funder` and `archived`.\n\n`bad_request`: `pubkeys` has more than 5,000 entries. Split the selection into several calls.\n\n`bad_request`: `launch_ext_ids` has more than 200 entries. Split the selection into several calls.\n\n`bad_request`: A launch id in `launch_ext_ids` is malformed. Send launch ids as the API returns them.\n\n`bad_request`: A launch in `launch_ext_ids` is on the other network than `{network_type}`. Remove the launch, or call the endpoint of the launch's network.\n\n`bad_request`: `cursor` is out of range. Send the `next_cursor` of the previous page.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`{network_type}` is not `svm` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown network_type: <network_type>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`kinds` contains an unknown kind.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown kind '<kind>', expected one of fresh, aged, funder, archived"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`pubkeys` has more than 5,000 entries.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 5000 pubkeys per call"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_ext_ids` has more than 200 entries.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 200 launches per call"
                    }
                  },
                  "bad_request_5": {
                    "summary": "A launch id in `launch_ext_ids` is malformed.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_6": {
                    "summary": "A launch in `launch_ext_ids` is on the other network than `{network_type}`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch <launch_id> is not on <network_type>"
                    }
                  },
                  "bad_request_7": {
                    "summary": "`cursor` is out of range.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "cursor out of range"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license does not have `can_manage_keys`. Use a license with key management enabled. `can_manage_keys` on [Retrieve the license](/reference/licenses/#retrieve-license) tells you.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license does not have `can_manage_keys`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "keys_not_enabled"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: A launch in `launch_ext_ids` does not exist or does not belong to the license. Remove the launch from `launch_ext_ids`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "A launch in `launch_ext_ids` does not exist or does not belong to the license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "keys.export",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only, but each call is written to the key export audit log. While the vault is locked and `keys.export` is protected, each call needs a new challenge."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/keys/#list"
        }
      }
    },
    "/keys/{network_type}/export": {
      "post": {
        "operationId": "keys.export",
        "summary": "Export keys",
        "description": "Downloads every selected wallet with its secret key as one JSON or CSV file.\n\nTakes the same selector as [List keys](#list). The response is a file with a `Content-Disposition: attachment` header (for example `keys-svm-20261102-100000.json`). The CSV columns are `pubkey,secret,kind,name,tag_ids,created_at,roles`, with `tag_ids` and `roles` (`launch:role`) separated by spaces.\n\nThe web app exports JSON for selected wallets or a folder and rewrites the rows as `{ name, pubkey, privatekey }` before saving them.\n\nThe file contains private keys in clear. Anyone holding it controls the funds of those wallets.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "network_type",
            "in": "path",
            "required": true,
            "description": "Network. EVM wallets are shared by every EVM chain.",
            "schema": {
              "type": "string",
              "enum": [
                "svm",
                "evm"
              ]
            },
            "example": "svm"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Only these wallets, up to 5,000. EVM addresses are case-insensitive."
                  },
                  "tag_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Wallets with at least one of these tags."
                  },
                  "kinds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallet kinds among `fresh`, `aged`, `funder` and `archived`."
                  },
                  "launch_ext_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets of these launches, up to 200, all on the path's network. Adds `roles` to each row. Numbers are accepted."
                  },
                  "include_archived": {
                    "type": "boolean",
                    "description": "Include archived wallets. Implied when `kinds` contains `archived`.",
                    "default": "false"
                  },
                  "format": {
                    "type": "string",
                    "enum": [
                      "json",
                      "csv"
                    ],
                    "description": "File format.",
                    "default": "json"
                  }
                }
              },
              "example": {
                "pubkeys": [
                  "9fGhT2kWm4Ys7QpRn3DxEb6ZcVa8Jt5LuN1HwKq2Ms7F",
                  "DkR4mWq7TzY2bNc9HvJ3sLp8XfGa5Ue6Kt1Qw2Ey4Mh"
                ],
                "format": "json"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "With `format: \"json\"`, a JSON file; with `format: \"csv\"`, a `text/csv` file.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "network": {
                      "type": "string",
                      "enum": [
                        "svm",
                        "evm"
                      ],
                      "description": "Exported network."
                    },
                    "count": {
                      "type": "integer",
                      "description": "Number of keys."
                    },
                    "keys": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [Key](#object-key) objects."
                    }
                  },
                  "required": [
                    "network",
                    "count",
                    "keys"
                  ]
                },
                "example": {
                  "network": "svm",
                  "count": 1,
                  "keys": [
                    {
                      "id": 48211,
                      "pubkey": "9fGhT2kWm4Ys7QpRn3DxEb6ZcVa8Jt5LuN1HwKq2Ms7F",
                      "secret": "3xYp8RkVb2NqTz7HcWm5Ld9GsJf4Ae6KuQ1Bt3Ew8Mh2Zn5Vr7Cy4Pk9Ds2Gx6Lb3Hq8Wt5Jm1Nf4Re7Uz2Ka9Vb",
                      "kind": "aged",
                      "name": "sniper 1",
                      "tag_ids": [
                        12
                      ],
                      "created_at": 1792404000
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `{network_type}` is not `svm` or `evm`. Use `svm` or `evm`.\n\n`bad_request`: `kinds` contains an unknown kind. Use only `fresh`, `aged`, `funder` and `archived`.\n\n`bad_request`: `pubkeys` has more than 5,000 entries. Split the selection into several calls.\n\n`bad_request`: `launch_ext_ids` has more than 200 entries. Split the selection into several calls.\n\n`bad_request`: A launch id in `launch_ext_ids` is malformed. Send launch ids as the API returns them.\n\n`bad_request`: A launch in `launch_ext_ids` is on the other network than `{network_type}`. Remove the launch, or call the endpoint of the launch's network.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`{network_type}` is not `svm` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown network_type: <network_type>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`kinds` contains an unknown kind.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown kind '<kind>', expected one of fresh, aged, funder, archived"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`pubkeys` has more than 5,000 entries.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 5000 pubkeys per call"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_ext_ids` has more than 200 entries.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 200 launches per call"
                    }
                  },
                  "bad_request_5": {
                    "summary": "A launch id in `launch_ext_ids` is malformed.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_6": {
                    "summary": "A launch in `launch_ext_ids` is on the other network than `{network_type}`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch <launch_id> is not on <network_type>"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license does not have `can_manage_keys`. Use a license with key management enabled. `can_manage_keys` on [Retrieve the license](/reference/licenses/#retrieve-license) tells you.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license does not have `can_manage_keys`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "keys_not_enabled"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: A launch in `launch_ext_ids` does not exist or does not belong to the license. Remove the launch from `launch_ext_ids`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "A launch in `launch_ext_ids` does not exist or does not belong to the license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The selection has more than 50,000 keys. Narrow it. Add filters, or split the export by tag, kind or launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The selection has more than 50,000 keys. Narrow it.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "more than 50000 keys selected, narrow the selection"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "keys.export",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only, but each call is written to the key export audit log. While the vault is locked and `keys.export` is protected, each call needs a new challenge."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/keys/#export"
        }
      }
    },
    "/keys/{network_type}/import": {
      "post": {
        "operationId": "keys.import",
        "summary": "Import keys",
        "description": "Adds wallets to the license from their secret keys.\n\nAccepted secrets: on SVM, base58 of a 64-byte keypair or a 32-byte seed, or a byte array (the content of a `solana-keygen` file, as an array or as text); on EVM, 32-byte hex with or without `0x`. Send `dry_run: true` first to get the report without writing anything, then the same body without it.\n\nThe Import keys modal of the wallets page calls this, and refreshes the wallet lists when anything was imported or restored.\n\nThe batch is written in one transaction: either every valid key is saved or none is. The request body is limited to 4 MB.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "network_type",
            "in": "path",
            "required": true,
            "description": "Network. EVM wallets are shared by every EVM chain.",
            "schema": {
              "type": "string",
              "enum": [
                "svm",
                "evm"
              ]
            },
            "example": "svm"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "secrets": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "object"
                        }
                      ]
                    },
                    "description": "Up to 5,000 entries, each the secret alone or `{ \"secret\": ..., \"name\": \"...\" }`. `name` is up to 25 characters."
                  },
                  "tag_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Tags applied to every valid key of the batch, including keys already present."
                  },
                  "dry_run": {
                    "type": "boolean",
                    "description": "Validate and compute statuses without writing.",
                    "default": "false"
                  },
                  "on_existing": {
                    "type": "string",
                    "enum": [
                      "restore",
                      "skip"
                    ],
                    "description": "What to do with a key that is present but archived.",
                    "default": "restore"
                  }
                },
                "required": [
                  "secrets"
                ]
              },
              "example": {
                "secrets": [
                  "3xYp8RkVb2NqTz7HcWm5Ld9GsJf4Ae6KuQ1Bt3Ew8Mh2Zn5Vr7Cy4Pk9Ds2Gx6Lb3Hq8Wt5Jm1Nf4Re7Uz2Ka9Vb",
                  {
                    "secret": "[12,201,4,...]",
                    "name": "sniper 1"
                  },
                  "not-a-key"
                ],
                "tag_ids": [
                  12
                ],
                "dry_run": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "dry_run": {
                      "type": "boolean",
                      "description": "Whether nothing was written."
                    },
                    "counts": {
                      "type": "object",
                      "description": "Number of entries per status: `imported`, `restored`, `already_present`, `duplicate`, `invalid`."
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [Key import result](#object-key-import-result) objects, in the order of `secrets`."
                    }
                  },
                  "required": [
                    "dry_run",
                    "counts",
                    "results"
                  ]
                },
                "example": {
                  "dry_run": true,
                  "counts": {
                    "imported": 2,
                    "restored": 0,
                    "already_present": 0,
                    "duplicate": 0,
                    "invalid": 1
                  },
                  "results": [
                    {
                      "index": 0,
                      "status": "imported",
                      "pubkey": "9fGhT2kWm4Ys7QpRn3DxEb6ZcVa8Jt5LuN1HwKq2Ms7F"
                    },
                    {
                      "index": 1,
                      "status": "imported",
                      "pubkey": "DkR4mWq7TzY2bNc9HvJ3sLp8XfGa5Ue6Kt1Qw2Ey4Mh"
                    },
                    {
                      "index": 2,
                      "status": "invalid",
                      "reason": "invalid base58"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `{network_type}` is not `svm` or `evm`. Use `svm` or `evm`.\n\n`bad_request`: `secrets` is empty. Send at least one secret.\n\n`bad_request`: `secrets` has more than 5,000 entries. Split the import into several calls.\n\n`bad_request`: A tag in `tag_ids` does not belong to the license. Nothing is written. Send only ids of the license's wallet folders.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`{network_type}` is not `svm` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown network_type: <network_type>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`secrets` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "nothing to import"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`secrets` has more than 5,000 entries.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 5000 keys per call"
                    }
                  },
                  "bad_request_4": {
                    "summary": "A tag in `tag_ids` does not belong to the license. Nothing is written.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Some tags not found or unauthorized"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license does not have `can_manage_keys`. Use a license with key management enabled. `can_manage_keys` on [Retrieve the license](/reference/licenses/#retrieve-license) tells you.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license does not have `can_manage_keys`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "keys_not_enabled"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The import would exceed the license's wallet limit. Nothing is written. Import fewer keys, or archive wallets first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The import would exceed the license's wallet limit. Nothing is written.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Exceeded max wallet limit: <active> active, <adding> to add, <max> allowed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A key that is already present comes back as `already_present` and is not added twice."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/keys/#import"
        }
      }
    },
    "/keys/{network_type}/update": {
      "post": {
        "operationId": "keys.update",
        "summary": "Update wallets",
        "description": "Renames wallets and adds or removes tags in one batch.\n\nFor `name`, a value sets it, `\"\"` clears it and an absent field leaves it unchanged. `add_tag_ids` and `remove_tag_ids` apply to every listed wallet. To archive wallets use the wallets endpoints; a wallet's secret cannot be replaced.\n\nNot called by the current web app.",
        "tags": [
          "Keys"
        ],
        "parameters": [
          {
            "name": "network_type",
            "in": "path",
            "required": true,
            "description": "Network. EVM wallets are shared by every EVM chain.",
            "schema": {
              "type": "string",
              "enum": [
                "svm",
                "evm"
              ]
            },
            "example": "svm"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "pubkey": {
                          "type": "string",
                          "description": "Wallet address."
                        },
                        "name": {
                          "type": "string",
                          "description": "New name. `\"\"` clears it."
                        }
                      },
                      "required": [
                        "pubkey"
                      ]
                    },
                    "description": "Wallets to edit, up to 5,000."
                  },
                  "add_tag_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Tags to add to every listed wallet."
                  },
                  "remove_tag_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "Tags to remove from every listed wallet."
                  }
                },
                "required": [
                  "wallets"
                ]
              },
              "example": {
                "wallets": [
                  {
                    "pubkey": "9fGhT2kWm4Ys7QpRn3DxEb6ZcVa8Jt5LuN1HwKq2Ms7F",
                    "name": "renamed"
                  },
                  {
                    "pubkey": "DkR4mWq7TzY2bNc9HvJ3sLp8XfGa5Ue6Kt1Qw2Ey4Mh",
                    "name": ""
                  },
                  {
                    "pubkey": "7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P"
                  }
                ],
                "add_tag_ids": [
                  14
                ],
                "remove_tag_ids": [
                  12
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "updated": {
                      "type": "integer",
                      "description": "Wallets edited."
                    },
                    "renamed": {
                      "type": "integer",
                      "description": "Wallets whose name changed."
                    }
                  },
                  "required": [
                    "ok",
                    "updated",
                    "renamed"
                  ]
                },
                "example": {
                  "ok": true,
                  "updated": 3,
                  "renamed": 2
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `{network_type}` is not `svm` or `evm`. Use `svm` or `evm`.\n\n`bad_request`: `wallets` is empty. Send at least one wallet.\n\n`bad_request`: `wallets` has more than 5,000 entries. Split the update into several calls.\n\n`bad_request`: A `name` is longer than 25 characters after trimming. The message names the wallet. Shorten the name to 25 characters.\n\n`bad_request`: A tag does not belong to the license. Send only ids of the license's wallet folders.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`{network_type}` is not `svm` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown network_type: <network_type>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`wallets` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no wallets given"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`wallets` has more than 5,000 entries.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 5000 wallets per call"
                    }
                  },
                  "bad_request_4": {
                    "summary": "A `name` is longer than 25 characters after trimming. The message names the wallet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Name must be 25 characters or less (<pubkey>)"
                    }
                  },
                  "bad_request_5": {
                    "summary": "A tag does not belong to the license.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Some tags not found or unauthorized"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license does not have `can_manage_keys`. Use a license with key management enabled. `can_manage_keys` on [Retrieve the license](/reference/licenses/#retrieve-license) tells you.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license does not have `can_manage_keys`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "keys_not_enabled"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: A wallet is not in the license. Nothing is written. The message lists up to five missing addresses. Remove the listed addresses from `wallets`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "A wallet is not in the license. Nothing is written. The message lists up to five missing addresses.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "<count> wallet(s) not found on this license: <pubkeys>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Names and tags are set, not toggled, so repeating the call changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/keys/#update"
        }
      }
    },
    "/license/referral-codes/update-label": {
      "post": {
        "operationId": "referrals.update-code-label",
        "summary": "Update a referral code label",
        "description": "Sets the private label of one of the license's referral codes.",
        "tags": [
          "Referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "Referral code. Case-insensitive."
                  },
                  "label": {
                    "type": "string",
                    "description": "New label, up to 20 bytes (20 ASCII characters). An empty string clears it."
                  }
                },
                "required": [
                  "code",
                  "label"
                ]
              },
              "example": {
                "code": "nova",
                "label": "Twitter bio"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Result message."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Label updated"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The label is longer than 20 bytes. Accented letters and emoji take more than one byte each. Shorten the label.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The label is longer than 20 bytes. Accented letters and emoji take more than one byte each.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "label must be <= 20 chars"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The code does not exist or is not owned by the license. Use a code from `referral.codes` on [Retrieve the license](/reference/licenses/#retrieve-license).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The code does not exist or is not owned by the license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "code not found or not owned by you"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sets the label, so repeating the call changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#update-code-label"
        }
      }
    },
    "/license/referral-codes/rename": {
      "post": {
        "operationId": "referrals.rename-code",
        "summary": "Change the primary referral code",
        "description": "Replaces the license's primary referral code with a new name.\n\nA name the license already owns is made primary again; any other name is issued fresh. The replaced code is deleted if nobody ever used it; otherwise it keeps working, and only the last three replaced codes stay redeemable. Codes are lowercased: 3-32 characters among `a-z`, `0-9`, `-` and `_`, and app route names are reserved.",
        "tags": [
          "Referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "Current primary code."
                  },
                  "new_code": {
                    "type": "string",
                    "description": "New code."
                  }
                },
                "required": [
                  "code",
                  "new_code"
                ]
              },
              "example": {
                "code": "nova",
                "new_code": "nova-labs"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "code": {
                      "type": "string",
                      "description": "New primary code."
                    },
                    "previous_code": {
                      "type": "string",
                      "description": "Replaced code."
                    },
                    "previous_code_deleted": {
                      "type": "boolean",
                      "description": "`true` when the previous code was never used and was deleted instead of kept."
                    },
                    "reused_code": {
                      "type": "boolean",
                      "description": "`true` when the new code was one the license already owned."
                    },
                    "removed_codes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Oldest replaced codes dropped to keep only the last three."
                    }
                  },
                  "required": [
                    "ok",
                    "code",
                    "previous_code"
                  ]
                },
                "example": {
                  "ok": true,
                  "code": "nova-labs",
                  "previous_code": "nova",
                  "previous_code_deleted": false,
                  "reused_code": false,
                  "removed_codes": []
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `code` is empty. Send the current primary code.\n\n`bad_request`: The new code is malformed or reserved: it must be 3 to 32 characters among `a-z`, `0-9`, `-` and `_`. The message names the broken rule, for example `that referral code is reserved`. Pick a code that follows these rules.\n\n`bad_request`: `code` is not the primary code. Send the code whose `is_primary` is `true`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`code` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "code is required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The new code is malformed or reserved: it must be 3 to 32 characters among `a-z`, `0-9`, `-` and `_`. The message names the broken rule, for example `that referral code is reserved`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "referral code must be 3-32 chars"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`code` is not the primary code.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "only the current referral code can be changed"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The current code was revoked or has expired. Contact support for a new referral code.\n\n`forbidden`: The requested code is one of yours that was revoked or has expired (message `that referral code has expired and cannot be used again`). Pick another code.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The current code was revoked or has expired.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this referral code was revoked or has expired and cannot be changed"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The requested code is one of yours that was revoked or has expired (message `that referral code has expired and cannot be used again`).",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "that referral code was revoked and cannot be used again"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The code does not exist or is not owned by the license. Send a code from `referral.codes` on [Retrieve the license](/reference/licenses/#retrieve-license).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The code does not exist or is not owned by the license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "code not found or not owned by you"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The new code is already in use. Pick another code.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The new code is already in use.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "code already in use"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 10 renames per hour. Refused renames do not count. Wait before renaming again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 10 renames per hour. Refused renames do not count.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for referral_code_rename, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "After a successful rename the old code is no longer primary, so a retry is refused. Read `referral.codes` with [Retrieve the license](/reference/licenses/#retrieve-license) to see which code is primary."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#rename-code"
        }
      }
    },
    "/license/get-available-referral-fees": {
      "get": {
        "operationId": "referrals.retrieve-available-referral-fees",
        "summary": "Retrieve pending referral fees",
        "description": "Returns the referral fees waiting in the license's referral wallet on each chain.\n\nThe response is an object keyed by chain id. The Collect dialog lists only the chains with something pending.\n\nClients must not display an unlock countdown from `incoming_unlock_at`: no payment time is guaranteed.",
        "tags": [
          "Referrals"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": {
                    "type": "object",
                    "properties": {
                      "native_pending": {
                        "type": "string",
                        "description": "Collectable native balance, in lamports or wei."
                      },
                      "pending_usd1": {
                        "type": "string",
                        "description": "Collectable USD1, in raw units (6 decimals)."
                      },
                      "pending_usdc": {
                        "type": "string",
                        "description": "Collectable USDC, in raw units (6 decimals)."
                      },
                      "incoming_usd": {
                        "type": "string",
                        "description": "Estimated micro-USD from recent or queued launches, not yet in the wallet."
                      },
                      "incoming_launches": {
                        "type": "integer",
                        "description": "Launches behind `incoming_usd`."
                      },
                      "incoming_is_estimate": {
                        "type": "boolean",
                        "description": "Whether `incoming_usd` is an estimate."
                      },
                      "incoming_unlock_at": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Not a payment deadline: no unlock time is guaranteed."
                      }
                    },
                    "required": [
                      "native_pending"
                    ],
                    "description": "Pending fees on one chain."
                  },
                  "x-proxima-key": "chain_id"
                },
                "example": {
                  "sol": {
                    "native_pending": "1250000000",
                    "pending_usd1": "0",
                    "pending_usdc": "25000000"
                  },
                  "bsc": {
                    "native_pending": "42000000000000000"
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The Solana balances could not be read. EVM balances that cannot be read are reported as `\"0\"` instead. Retry after a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The Solana balances could not be read. EVM balances that cannot be read are reported as `\"0\"` instead.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <reason>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#retrieve-available-referral-fees"
        }
      }
    },
    "/license/collect-referral-fees": {
      "post": {
        "operationId": "referrals.collect-referral-fees",
        "summary": "Collect referral fees",
        "description": "Sends the pending referral fees on the selected chains to the given addresses.\n\nDrains the license's referral wallet on each selected chain: native balance on every chain, plus USD1 and USDC on Solana. The Collect dialog asks for an SVM recipient for `sol` and an EVM recipient for EVM chains.\n\nMoves funds on-chain to the recipient addresses. Transfers cannot be reversed: check the addresses.",
        "tags": [
          "Referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "svm_recipient": {
                    "type": "string",
                    "description": "Solana address that receives the funds. Required when `chains` contains `sol`."
                  },
                  "evm_recipient": {
                    "type": "string",
                    "description": "EVM address that receives the funds. Required when `chains` contains an EVM chain."
                  },
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Chain ids to collect on."
                  }
                },
                "required": [
                  "chains"
                ]
              },
              "example": {
                "svm_recipient": "7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P",
                "evm_recipient": "0x8f3c2a91d4e7b6058c1f9a2e3d4b5c6a7e8f9012",
                "chains": [
                  "sol",
                  "bsc"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Result message."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Referral fees collected"
                }
              }
            }
          },
          "400": {
            "description": "`unsupported_chain`: A selected chain cannot be collected on yet (`base`). Nothing is sent. Remove `base` from `chains`.\n\n`bad_request`: `chains` is empty. Send at least one chain id.\n\n`bad_request`: `chains` contains `sol` and `svm_recipient` is missing or empty. Nothing is sent. Send `svm_recipient`, or remove `sol` from `chains`.\n\n`bad_request`: `chains` contains an EVM chain and `evm_recipient` is missing or empty. Nothing is sent. Send `evm_recipient`, or remove the EVM chains from `chains`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unsupported_chain": {
                    "summary": "A selected chain cannot be collected on yet (`base`). Nothing is sent.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request": {
                    "summary": "`chains` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "chains must not be empty"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`chains` contains `sol` and `svm_recipient` is missing or empty. Nothing is sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "svm_recipient required for sol"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`chains` contains an EVM chain and `evm_recipient` is missing or empty. Nothing is sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "evm_recipient required for evm chains"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call sends what is claimable at that moment, so the same fees cannot be paid twice. [Retrieve pending referral fees](/reference/referrals/#retrieve-available-referral-fees) shows what is left."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#collect-referral-fees"
        }
      }
    },
    "/license/referral-series": {
      "get": {
        "operationId": "referrals.retrieve-referral-series",
        "summary": "Retrieve referral series",
        "description": "Returns new referees and referral revenue per time bucket.",
        "tags": [
          "Referrals"
        ],
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Start of the range, in Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "End of the range, in Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "Bucket size.",
            "schema": {
              "type": "string",
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "default": "day"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "granularity": {
                      "type": "string",
                      "enum": [
                        "hour",
                        "day",
                        "week",
                        "month"
                      ],
                      "description": "Bucket size."
                    },
                    "from": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Start of the range, in Unix seconds, or `null`."
                    },
                    "to": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "End of the range, in Unix seconds, or `null`."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "bucket_start": {
                            "type": "integer",
                            "description": "Start of the bucket, in Unix seconds."
                          },
                          "new_referred": {
                            "type": "integer",
                            "description": "New accounts at level 1."
                          },
                          "referral_revenue_usd": {
                            "type": "string",
                            "description": "Sum of `revenue_usd_by_level`, in micro-USD."
                          },
                          "users_by_level": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            },
                            "description": "Referees per depth: `level`, `users`."
                          },
                          "revenue_usd_by_level": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            },
                            "description": "Revenue per depth: `level`, `usd` (micro-USD string)."
                          }
                        },
                        "required": [
                          "bucket_start",
                          "new_referred",
                          "referral_revenue_usd",
                          "users_by_level",
                          "revenue_usd_by_level"
                        ]
                      },
                      "description": "Time buckets."
                    }
                  },
                  "required": [
                    "granularity",
                    "from",
                    "to",
                    "buckets"
                  ]
                },
                "example": {
                  "granularity": "day",
                  "from": 1790812800,
                  "to": 1790899200,
                  "buckets": [
                    {
                      "bucket_start": 1790812800,
                      "new_referred": 3,
                      "referral_revenue_usd": "18420000",
                      "users_by_level": [
                        {
                          "level": 1,
                          "users": 3
                        }
                      ],
                      "revenue_usd_by_level": [
                        {
                          "level": 1,
                          "usd": "18420000"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `granularity` is not `hour`, `day`, `week` or `month`. Use `hour`, `day`, `week` or `month`.\n\n`bad_request`: `from` or `to` is outside the supported date range. The message names the parameter (`invalid to`). Send Unix timestamps in seconds.\n\n`bad_request`: `from` is after `to`. Swap the two values.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`granularity` is not `hour`, `day`, `week` or `month`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid granularity: <granularity>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`from` or `to` is outside the supported date range. The message names the parameter (`invalid to`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid from"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`from` is after `to`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "from is after to"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#retrieve-referral-series"
        }
      }
    },
    "/license/referral-affiliates": {
      "get": {
        "operationId": "referrals.retrieve-referral-affiliates",
        "summary": "Retrieve affiliate activity",
        "description": "Returns launches and referral earnings of the license's affiliates per time bucket.\n\nMoney fields are micro-USD strings: referral earned on the affiliates' launches, paid or settling. An answer is cached for 60 seconds per license, range and granularity.",
        "tags": [
          "Referrals"
        ],
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Start of the range, in Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "End of the range, in Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "Bucket size.",
            "schema": {
              "type": "string",
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "default": "day"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "granularity": {
                      "type": "string",
                      "enum": [
                        "hour",
                        "day",
                        "week",
                        "month"
                      ],
                      "description": "Bucket size."
                    },
                    "from": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Start of the range, in Unix seconds, or `null`."
                    },
                    "to": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "End of the range, in Unix seconds, or `null`."
                    },
                    "totals": {
                      "type": "object",
                      "properties": {
                        "affiliates": {
                          "type": "integer",
                          "description": "Every affiliate registered by `to`, launched or not."
                        },
                        "active_affiliates": {
                          "type": "integer",
                          "description": "Affiliates with at least one launch."
                        },
                        "launches": {
                          "type": "integer",
                          "description": "Launches by affiliates."
                        },
                        "earned_usd": {
                          "type": "string",
                          "description": "Referral earned, in micro-USD."
                        },
                        "avg_launches_per_affiliate": {
                          "type": "number",
                          "description": "Average launches per affiliate."
                        },
                        "avg_launches_per_active_affiliate": {
                          "type": "number",
                          "description": "Average launches per active affiliate."
                        },
                        "avg_earned_usd_per_affiliate": {
                          "type": "string",
                          "description": "Average earned per affiliate, in micro-USD."
                        },
                        "avg_earned_usd_per_active_affiliate": {
                          "type": "string",
                          "description": "Average earned per active affiliate, in micro-USD."
                        }
                      },
                      "required": [
                        "affiliates",
                        "active_affiliates",
                        "launches",
                        "earned_usd",
                        "avg_launches_per_affiliate",
                        "avg_launches_per_active_affiliate",
                        "avg_earned_usd_per_affiliate",
                        "avg_earned_usd_per_active_affiliate"
                      ],
                      "description": "Totals over the range."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Time buckets: `bucket_start`, `launches`, `active_affiliates`, `earned_usd`, `avg_launches_per_active_affiliate`, `avg_earned_usd_per_active_affiliate`."
                    }
                  },
                  "required": [
                    "granularity",
                    "from",
                    "to",
                    "totals",
                    "buckets"
                  ]
                },
                "example": {
                  "granularity": "week",
                  "from": 1790812800,
                  "to": 1791417600,
                  "totals": {
                    "affiliates": 37,
                    "active_affiliates": 9,
                    "launches": 41,
                    "earned_usd": "96210000",
                    "avg_launches_per_affiliate": 1.11,
                    "avg_launches_per_active_affiliate": 4.56,
                    "avg_earned_usd_per_affiliate": "2600270",
                    "avg_earned_usd_per_active_affiliate": "10690000"
                  },
                  "buckets": [
                    {
                      "bucket_start": 1790640000,
                      "launches": 41,
                      "active_affiliates": 9,
                      "earned_usd": "96210000",
                      "avg_launches_per_active_affiliate": 4.56,
                      "avg_earned_usd_per_active_affiliate": "10690000"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `granularity` is not `hour`, `day`, `week` or `month`. Use `hour`, `day`, `week` or `month`.\n\n`bad_request`: `from` or `to` is outside the supported date range. The message names the parameter (`invalid to`). Send Unix timestamps in seconds.\n\n`bad_request`: `from` is after `to`. Swap the two values.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`granularity` is not `hour`, `day`, `week` or `month`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid granularity: <granularity>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`from` or `to` is outside the supported date range. The message names the parameter (`invalid to`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid from"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`from` is after `to`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "from is after to"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#retrieve-referral-affiliates"
        }
      }
    },
    "/license/cashback": {
      "get": {
        "operationId": "referrals.retrieve-cashback",
        "summary": "Retrieve cashback balances",
        "description": "Returns the caller's cashback rate and cashback balances per chain.\n\nThe web app only calls this when the `fee_activation.active` constant is `true`.",
        "tags": [
          "Referrals"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rate_bps": {
                      "type": "integer",
                      "description": "Caller's cashback rate, in basis points of what Proxima keeps after referrals."
                    },
                    "chains": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "pending_native": {
                            "type": "string",
                            "description": "What the cashback wallet holds now; a claim sends it."
                          },
                          "pending_usd1": {
                            "type": "string",
                            "description": "USD1 held, in raw units."
                          },
                          "pending_usdc": {
                            "type": "string",
                            "description": "USDC held, in raw units."
                          },
                          "earned_native": {
                            "type": "string",
                            "description": "Lifetime cashback sent to the wallet, in native raw units."
                          },
                          "earned_usd": {
                            "type": "string",
                            "description": "Lifetime cashback sent to the wallet, in micro-USD."
                          },
                          "owed_native": {
                            "type": "string",
                            "description": "Accrued on a sweep and not yet sent to the wallet, in native raw units."
                          },
                          "owed_usd": {
                            "type": "string",
                            "description": "Accrued and not yet sent, in micro-USD."
                          },
                          "claimed_native": {
                            "type": "string",
                            "description": "Lifetime claimed, in native raw units."
                          }
                        },
                        "required": [
                          "pending_native",
                          "earned_native",
                          "earned_usd",
                          "owed_native",
                          "owed_usd",
                          "claimed_native"
                        ],
                        "description": "Cashback on one chain, keyed by chain ID."
                      },
                      "x-proxima-key": "chain_id",
                      "description": "Balances keyed by chain id."
                    }
                  },
                  "required": [
                    "rate_bps",
                    "chains"
                  ]
                },
                "example": {
                  "rate_bps": 1000,
                  "chains": {
                    "sol": {
                      "pending_native": "310000000",
                      "earned_native": "1840000000",
                      "earned_usd": "283300000",
                      "owed_native": "20000000",
                      "owed_usd": "3080000",
                      "claimed_native": "1530000000"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "x-proxima-client-only": true,
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#retrieve-cashback"
        }
      }
    },
    "/license/cashback-history": {
      "get": {
        "operationId": "referrals.list-cashback-history",
        "summary": "List cashback history",
        "description": "Lists cashback payouts and claims, newest first, by pages.\n\nNot called by the current web app.",
        "tags": [
          "Referrals"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "before_id",
            "in": "query",
            "required": false,
            "description": "Return items older than this id. Use `next_before_id` from the previous page.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "description": "Item id."
                          },
                          "created_at": {
                            "type": "integer",
                            "description": "Time of the event."
                          },
                          "kind": {
                            "type": "string",
                            "enum": [
                              "payout",
                              "claim"
                            ],
                            "description": "`payout` to the cashback wallet, or `claim` from it."
                          },
                          "chain": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Chain id."
                          },
                          "launch_id": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Launch the payout comes from."
                          },
                          "amount_native": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Amount in native raw units."
                          },
                          "amount_quote": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Amount in quote token raw units."
                          },
                          "quote_mint": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Quote token of `amount_quote`."
                          },
                          "amount_usd": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Amount in micro-USD."
                          },
                          "details": {
                            "type": "object",
                            "description": "Event details."
                          }
                        },
                        "required": [
                          "id",
                          "created_at",
                          "kind",
                          "chain",
                          "launch_id",
                          "amount_native",
                          "amount_quote",
                          "quote_mint",
                          "amount_usd",
                          "details"
                        ]
                      },
                      "description": "History items."
                    },
                    "next_before_id": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor for the next page, or `null` on the last page."
                    }
                  },
                  "required": [
                    "items",
                    "next_before_id"
                  ]
                },
                "example": {
                  "items": [
                    {
                      "id": 9012,
                      "created_at": 1793606400,
                      "kind": "payout",
                      "chain": "sol",
                      "launch_id": "101453179751265",
                      "amount_native": "20000000",
                      "amount_quote": null,
                      "quote_mint": null,
                      "amount_usd": "3080000",
                      "details": {}
                    }
                  ],
                  "next_before_id": null
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "x-proxima-client-only": true,
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#list-cashback-history"
        }
      }
    },
    "/license/cashback-series": {
      "get": {
        "operationId": "referrals.retrieve-cashback-series",
        "summary": "Retrieve cashback series",
        "description": "Returns the cashback paid to the caller's wallet per time bucket.\n\nUsed by the Rewards section, which the web app only shows when the `fee_activation.active` constant is `true`.",
        "tags": [
          "Referrals"
        ],
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Start of the range, in Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "End of the range, in Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "Bucket size.",
            "schema": {
              "type": "string",
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "default": "day"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "granularity": {
                      "type": "string",
                      "enum": [
                        "hour",
                        "day",
                        "week",
                        "month"
                      ],
                      "description": "Bucket size."
                    },
                    "from": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Start of the range, in Unix seconds, or `null`."
                    },
                    "to": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "End of the range, in Unix seconds, or `null`."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "bucket_start": {
                            "type": "integer",
                            "description": "Start of the bucket, in Unix seconds."
                          },
                          "cashback_usd": {
                            "type": "string",
                            "description": "Cashback paid in the bucket, in micro-USD."
                          }
                        },
                        "required": [
                          "bucket_start",
                          "cashback_usd"
                        ]
                      },
                      "description": "Time buckets."
                    }
                  },
                  "required": [
                    "granularity",
                    "from",
                    "to",
                    "buckets"
                  ]
                },
                "example": {
                  "granularity": "day",
                  "from": 1790812800,
                  "to": 1790899200,
                  "buckets": [
                    {
                      "bucket_start": 1790812800,
                      "cashback_usd": "3080000"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "x-proxima-client-only": true,
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#retrieve-cashback-series"
        }
      }
    },
    "/license/collect-cashback": {
      "post": {
        "operationId": "referrals.collect-cashback",
        "summary": "Collect cashback",
        "description": "Sends the cashback held on the selected chains to the given addresses.\n\nDrains the cashback wallet only, never the referral wallet. Same body as [Collect referral fees](#collect-referral-fees).\n\nMoves funds on-chain to the recipient addresses. Transfers cannot be reversed: check the addresses.",
        "tags": [
          "Referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "svm_recipient": {
                    "type": "string",
                    "description": "Solana address that receives the funds. Required when `chains` contains `sol`."
                  },
                  "evm_recipient": {
                    "type": "string",
                    "description": "EVM address that receives the funds. Required when `chains` contains an EVM chain."
                  },
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Chain ids to collect on."
                  }
                },
                "required": [
                  "chains"
                ]
              },
              "example": {
                "svm_recipient": "7xKQm3vR9pTn2LcW8fYbHs4dJ6gA5uE1zNqXwVy2Bk3P",
                "evm_recipient": "0x8f3c2a91d4e7b6058c1f9a2e3d4b5c6a7e8f9012",
                "chains": [
                  "sol",
                  "bsc"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Result message."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Cashback collected"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve cashback balances](/reference/referrals/#retrieve-cashback) first to see whether the first call already collected the balance."
        },
        "x-proxima-stability": "beta",
        "x-proxima-client-only": true,
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/referrals/#collect-cashback"
        }
      }
    },
    "/wallets/get/{chain_id}": {
      "get": {
        "operationId": "wallets.list-wallets",
        "summary": "List wallets",
        "description": "Returns the active wallets of the account on the network of a chain, with their stats on that chain.\n\nWallets of the chain's network type are returned (all SVM wallets for `sol`, all EVM wallets for an EVM chain), with balances and stats for `chain_id`. Folders are returned alongside: the list for the chain's network is filled, the other is empty. The web app calls this to render the Wallets page, the delete-wallets flow and the sell-all-tokens flow.",
        "tags": [
          "Wallets"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain ID.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "funding_status": {
                      "type": "string",
                      "enum": [
                        "None",
                        "Running",
                        "Failed"
                      ],
                      "description": "Status of the account's wallet funding."
                    },
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "List of [Wallet](#object-wallet) objects."
                    },
                    "tags": {
                      "type": "object",
                      "properties": {
                        "svm": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "SVM folders. See the [Folder](/reference/wallet-folders/#object-folder) object."
                        },
                        "evm": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "EVM folders."
                        }
                      },
                      "description": "Folders of the account, by network type."
                    }
                  }
                },
                "example": {
                  "funding_status": "None",
                  "wallets": [
                    {
                      "pubkey": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "network_type": "svm",
                      "created_at": 1792051200,
                      "launches": [
                        4821
                      ],
                      "tag_ids": [
                        12
                      ],
                      "funding_source": "Wallet",
                      "from_marketplace": false,
                      "native_balances": {
                        "sol": "1250000000"
                      },
                      "tx_count": {
                        "sol": 42
                      },
                      "volume": {
                        "sol": "18400000000"
                      },
                      "pnl_native": {
                        "sol": "35000000"
                      },
                      "pnl_usd": {
                        "sol": "7"
                      },
                      "pnl_usd_total": 7,
                      "funded_at": {
                        "sol": 1792054800
                      },
                      "routing": "direct"
                    }
                  ],
                  "tags": {
                    "svm": [
                      {
                        "id": 12,
                        "name": "Snipers",
                        "color": "#A6B1FF",
                        "archived": false
                      }
                    ],
                    "evm": []
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The chain is not supported. Use a supported `chain_id`; `monad` is no longer accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The chain is not supported.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unsupported chain: <chain_id>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#list-wallets"
        }
      }
    },
    "/wallets/routing/config": {
      "get": {
        "operationId": "wallets.retrieve-the-routing-config",
        "summary": "Retrieve the routing config",
        "description": "Lists every platform a wallet's trades can be built through, with its fee and chains.\n\nThe first platform is always `direct` (shown as Proxima), available on every chain; the other platforms build trades on `sol` only. The web app loads it for the trade routing modals and filters platforms by `chains`.",
        "tags": [
          "Wallets"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "default": {
                      "type": "string",
                      "description": "Platform a wallet uses when none is set: `direct`."
                    },
                    "platforms": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Platform ID used as a key in [Set wallet routing](#set-wallet-routing). `direct` is Proxima's own route."
                          },
                          "label": {
                            "type": "string",
                            "description": "Display name."
                          },
                          "fee_bps": {
                            "type": "integer",
                            "description": "Fee a trade routed this way pays the platform, in basis points of its quote leg."
                          },
                          "fee_pct": {
                            "type": "number",
                            "description": "`fee_bps` as a percentage."
                          },
                          "chains": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Chain IDs the platform builds trades on."
                          }
                        }
                      },
                      "description": "Available platforms."
                    }
                  }
                },
                "example": {
                  "default": "direct",
                  "platforms": [
                    {
                      "id": "direct",
                      "label": "Proxima",
                      "fee_bps": 0,
                      "fee_pct": 0,
                      "chains": [
                        "sol",
                        "bsc",
                        "base",
                        "eth",
                        "robinhood",
                        "arc",
                        "xlayer"
                      ]
                    },
                    {
                      "id": "axiom",
                      "label": "Axiom",
                      "fee_bps": 100,
                      "fee_pct": 1,
                      "chains": [
                        "sol"
                      ]
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#retrieve-the-routing-config"
        }
      }
    },
    "/wallets/routing/{chain_id}": {
      "post": {
        "operationId": "wallets.set-wallet-routing",
        "summary": "Set wallet routing",
        "description": "Sets the platform each listed wallet trades through on a chain.\n\nThe body maps platform IDs to the addresses that should trade through them. Platform IDs are matched case-insensitively, and routing a wallet to `direct` removes its routing. Wallets not listed keep their current routing. The web app sends it from the per-wallet routing modal and from the bulk trades-routing modal, which splits the selection across platforms by share.",
        "tags": [
          "Wallets"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain the routing applies to.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "One key per platform ID from the routing config; the value lists the wallet addresses to route through it. Only `direct` builds trades outside `sol`. At least one address is required overall."
                },
                "x-proxima-key": "platform_id"
              },
              "example": {
                "axiom": [
                  "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                  "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                ],
                "direct": [
                  "DKfba8BZznqYcPa9r2dE1oxd635exYJWuZtrefA8XyPF"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` on success."
                    },
                    "routing": {
                      "type": "object",
                      "description": "Platform ID now set for each address, keyed by address. EVM addresses come back lowercase."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "routing": {
                    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44": "axiom",
                    "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4": "axiom",
                    "DKfba8BZznqYcPa9r2dE1oxd635exYJWuZtrefA8XyPF": "direct"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use a supported `chain_id`; `monad` is no longer accepted.\n\n`bad_request`: The body is not a JSON object whose values are arrays of address strings. Send an object mapping platform IDs to arrays of addresses.\n\n`bad_request`: A key is not a platform ID, or names a platform that does not build trades on the chain. The whole batch is refused. Use platform IDs whose `chains` include the chain in [Retrieve the routing config](/reference/wallets/#retrieve-the-routing-config).\n\n`bad_request`: An address is not a valid address of the chain. The whole batch is refused. Send Solana addresses for `sol` and `0x` addresses for EVM chains.\n\n`bad_request`: An address appears twice in the body, under two platforms or twice under one. The whole batch is refused. List each address once.\n\n`bad_request`: The body lists no address. Send at least one address.\n\n`bad_request`: Some addresses are not wallets of the account; the message lists them. The whole batch is refused. Route only wallets from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unsupported chain: <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The body is not a JSON object whose values are arrays of address strings.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "A key is not a platform ID, or names a platform that does not build trades on the chain. The whole batch is refused.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<platform_id> does not build trades on <chain_id>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "An address is not a valid address of the chain. The whole batch is refused.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<address> is no <chain_id> address"
                    }
                  },
                  "bad_request_5": {
                    "summary": "An address appears twice in the body, under two platforms or twice under one. The whole batch is refused.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<address> is listed under two platforms"
                    }
                  },
                  "bad_request_6": {
                    "summary": "The body lists no address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no wallet to route"
                    }
                  },
                  "bad_request_7": {
                    "summary": "Some addresses are not wallets of the account; the message lists them. The whole batch is refused.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "not wallets of this license: <addresses>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Wallets not listed keep their routing, so sending the same body again leaves the same state."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#set-wallet-routing"
        }
      }
    },
    "/wallets/{network_type}/add": {
      "post": {
        "operationId": "wallets.create-wallets",
        "summary": "Create wallets",
        "description": "Generates new wallets on a network type and optionally adds them to folders.\n\nThe web app only generates wallets with this endpoint and never sends `secret_keys`; it imports keys through the Keys API.",
        "tags": [
          "Wallets"
        ],
        "parameters": [
          {
            "name": "network_type",
            "in": "path",
            "required": true,
            "description": "Network type: `svm` (Solana) or `evm` (every EVM chain).",
            "schema": {
              "type": "string",
              "enum": [
                "svm",
                "evm"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount_to_generate": {
                    "type": "integer",
                    "description": "Number of new keypairs to generate."
                  },
                  "secret_keys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Private keys to import alongside the generated wallets. Requires key-management rights on the license."
                  },
                  "tag_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "IDs of folders to add the new wallets to."
                  }
                },
                "required": [
                  "amount_to_generate"
                ]
              },
              "example": {
                "amount_to_generate": 3,
                "tag_ids": [
                  12
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Addresses of the wallets added."
                    },
                    "tag_ids": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "Folder IDs the wallets were added to."
                    }
                  }
                },
                "example": {
                  "wallets": [
                    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                    "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4",
                    "DKfba8BZznqYcPa9r2dE1oxd635exYJWuZtrefA8XyPF"
                  ],
                  "tag_ids": [
                    12
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `network_type` is not `svm` or `evm`. Use `svm` or `evm` as `network_type`.\n\n`bad_request`: On SVM, an entry of `secret_keys` is not a valid keypair. Check that every entry of `secret_keys` is a valid Solana secret key.\n\n`bad_request`: On EVM, an entry of `secret_keys` is not a valid private key. Check that every entry of `secret_keys` is a valid hex private key.\n\n`bad_request`: A folder in `tag_ids` is not on the account. Use folder IDs from the `tags` of [List wallets](/reference/wallets/#list-wallets).\n\n`bad_request`: On EVM, `amount_to_generate` is 0 and no `secret_keys` were sent. Set `amount_to_generate` above 0 or send `secret_keys`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`network_type` is not `svm` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown network_type: <network_type>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "On SVM, an entry of `secret_keys` is not a valid keypair.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid keypairs provided"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On EVM, an entry of `secret_keys` is not a valid private key.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid private key: <error>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "A folder in `tag_ids` is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Some tags not found or unauthorized"
                    }
                  },
                  "bad_request_5": {
                    "summary": "On EVM, `amount_to_generate` is 0 and no `secret_keys` were sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "nothing to add"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: `secret_keys` was sent and the license cannot import keys. Remove `secret_keys`, or use a license with key-management rights.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "`secret_keys` was sent and the license cannot import keys.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "Unauthorized to add custom wallets"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The request would exceed the license's wallet limit. On EVM, only an import of more than 5,000 keys is refused. Generate fewer wallets, or remove unused ones with [Delete wallets](/reference/wallets/#delete-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The request would exceed the license's wallet limit. On EVM, only an import of more than 5,000 keys is refused.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Exceeded max wallet limit"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call generates new wallets. Before retrying, call [List wallets](/reference/wallets/#list-wallets) and check whether the new wallets are already there."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#create-wallets"
        }
      }
    },
    "/wallets/remove": {
      "post": {
        "operationId": "wallets.delete-wallets",
        "summary": "Delete wallets",
        "description": "Archives wallets so they no longer appear in the wallet list.\n\nThe network is read from the address format: `0x` addresses are EVM, anything else is SVM. On SVM, a wallet that still holds a withdrawable balance cannot be deleted. EVM wallets are archived without a balance check.\n\nDeletion is a soft delete: the key is kept and the wallet can be brought back with [Restore deleted wallets](#restore-deleted-wallets).",
        "tags": [
          "Wallets"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses of the wallets to delete, all on the same network."
                  }
                },
                "required": [
                  "pubkeys"
                ]
              },
              "example": {
                "pubkeys": [
                  "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4",
                  "DKfba8BZznqYcPa9r2dE1oxd635exYJWuZtrefA8XyPF"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully removed wallets"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: SVM and EVM addresses were mixed. Send SVM and EVM addresses in separate requests.\n\n`bad_request`: A non-`0x` address is not a valid Solana address. Check that every SVM address is a valid base58 public key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No pubkeys provided"
                    }
                  },
                  "bad_request_2": {
                    "summary": "SVM and EVM addresses were mixed.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Mixed SVM + EVM pubkeys in one request — split by chain or use /wallets/{network_type}/remove"
                    }
                  },
                  "bad_request_3": {
                    "summary": "A non-`0x` address is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey format"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: An SVM wallet still holds funds above the dust floor. EVM wallets are not checked. Move the funds out with [Execute a withdrawal](/reference/withdrawals/#execute-a-withdrawal) before deleting the wallet.\n\n`upstream_failure`: The SVM balance check could not read balances from the RPC. Retry after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "An SVM wallet still holds funds above the dust floor. EVM wallets are not checked.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "At least one wallet have some funds"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The SVM balance check could not read balances from the RPC.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Deleting a wallet that is already deleted changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#delete-wallets"
        }
      }
    },
    "/wallets/deleted/{chain_id}": {
      "get": {
        "operationId": "wallets.list-deleted-wallets",
        "summary": "List deleted wallets",
        "description": "Returns the archived wallets of the account on the network of a chain.",
        "tags": [
          "Wallets"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain ID.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Wallet](#object-wallet) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Deleted wallets."
                    }
                  }
                },
                "example": {
                  "wallets": [
                    {
                      "pubkey": "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4",
                      "network_type": "svm",
                      "created_at": 1792051200,
                      "launches": [
                        4821
                      ],
                      "tag_ids": [],
                      "funding_source": "Wallet",
                      "from_marketplace": false,
                      "native_balances": {
                        "sol": "0"
                      },
                      "tx_count": {
                        "sol": 42
                      },
                      "volume": {
                        "sol": "18400000000"
                      },
                      "pnl_native": {
                        "sol": "35000000"
                      },
                      "pnl_usd": {
                        "sol": "7"
                      },
                      "pnl_usd_total": 7,
                      "funded_at": {
                        "sol": 1792054800
                      },
                      "routing": "direct"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The chain is not supported. Use a supported `chain_id`; `monad` is no longer accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The chain is not supported.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unsupported chain: <chain_id>"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: On `sol`, reading the balances of the deleted wallets from the RPC failed. Retry after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "On `sol`, reading the balances of the deleted wallets from the RPC failed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#list-deleted-wallets"
        }
      }
    },
    "/wallets/deleted/restore": {
      "post": {
        "operationId": "wallets.restore-deleted-wallets",
        "summary": "Restore deleted wallets",
        "description": "Makes deleted wallets active again.\n\nThe network is read from the address format. Addresses that are not deleted wallets of the account are ignored.",
        "tags": [
          "Wallets"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses to restore, all on the same network. At most 5,000 per call."
                  }
                },
                "required": [
                  "pubkeys"
                ]
              },
              "example": {
                "pubkeys": [
                  "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "restored": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Addresses that were restored."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "restored": [
                    "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: More than 5,000 addresses were sent. Split the addresses into batches of 5,000 or fewer.\n\n`bad_request`: SVM and EVM addresses were mixed. Send SVM and EVM addresses in separate requests.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No pubkeys provided"
                    }
                  },
                  "bad_request_2": {
                    "summary": "More than 5,000 addresses were sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 5000 wallets per call"
                    }
                  },
                  "bad_request_3": {
                    "summary": "SVM and EVM addresses were mixed.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Mixed SVM + EVM pubkeys in one request"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: None of the addresses is a deleted wallet of the account. Use addresses from [List deleted wallets](/reference/wallets/#list-deleted-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "None of the addresses is a deleted wallet of the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No deleted wallets found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Restoring would exceed the license's wallet limit. Restore fewer wallets, or delete active ones first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Restoring would exceed the license's wallet limit.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Exceeded max wallet limit: <active> active, <adding> to restore, <max> allowed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Wallets already restored are no longer deleted; once none is left, a repeat returns 404."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#restore-deleted-wallets"
        }
      }
    },
    "/wallets/add-from-launch": {
      "post": {
        "operationId": "wallets.add-wallets-from-launch",
        "summary": "Add wallets from a launch",
        "description": "Adds wallets used in a launch to the account's trading wallets.\n\nThe web app calls this from a launch's wallet list and from the wallets export menu.",
        "tags": [
          "Wallets"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "launch_id": {
                    "type": "string",
                    "description": "Launch ID. The client sends the numeric ID as a string."
                  },
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses of launch wallets to add."
                  },
                  "tag_ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    },
                    "description": "IDs of folders to add the wallets to."
                  }
                },
                "required": [
                  "launch_id",
                  "pubkeys"
                ]
              },
              "example": {
                "launch_id": "101734002558731",
                "pubkeys": [
                  "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy",
                  "AqaW1YghutnQEhjycn8m26Rr4RzZuZAoaNYsFjRP5NDp"
                ],
                "tag_ids": [
                  12
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Addresses added."
                    },
                    "tag_ids": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "Folder IDs the wallets were added to."
                    }
                  }
                },
                "example": {
                  "wallets": [
                    "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy",
                    "AqaW1YghutnQEhjycn8m26Rr4RzZuZAoaNYsFjRP5NDp"
                  ],
                  "tag_ids": [
                    12
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: `launch_id` is not a valid launch ID. Send the launch's numeric ID as a string.\n\n`bad_request`: EVM addresses were sent for a Solana launch. Send addresses of the launch's own chain.\n\n`bad_request`: Solana addresses were sent for an EVM launch. Send addresses of the launch's own chain.\n\n`bad_request`: For a Solana launch, an address is not a valid Solana address. Check that every address is a valid base58 public key.\n\n`bad_request`: For an EVM launch, an address is not a valid EVM address. Check that every address is a valid `0x` address.\n\n`bad_request`: An address is not a wallet of the launch. Send only wallets of this launch.\n\n`bad_request`: For an EVM multi-launch, the launch group has no plan yet. Save the launch plan first, then retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No pubkeys provided"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM addresses were sent for a Solana launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "EVM addresses sent to an SVM launch — check the launch_id chain"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Solana addresses were sent for an EVM launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "SVM pubkey sent to an EVM launch — check the launch_id chain"
                    }
                  },
                  "bad_request_5": {
                    "summary": "For a Solana launch, an address is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey format"
                    }
                  },
                  "bad_request_6": {
                    "summary": "For an EVM launch, an address is not a valid EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid evm address"
                    }
                  },
                  "bad_request_7": {
                    "summary": "An address is not a wallet of the launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "At least one selected wallet is not in launch wallets"
                    }
                  },
                  "bad_request_8": {
                    "summary": "For an EVM multi-launch, the launch group has no plan yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "group has no plan yet"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The launch is not on the account. Use the ID of one of your launches.\n\n`not_found`: On Solana, a launch wallet has no stored key. Send only wallets of this launch.\n\n`not_found`: A folder in `tag_ids` is not on the account. Use folder IDs from the `tags` of [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The launch is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "On Solana, a launch wallet has no stored key.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Some selected wallets not found in database"
                    }
                  },
                  "not_found_3": {
                    "summary": "A folder in `tag_ids` is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Some tags not found or unauthorized"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: On Solana, a wallet is already one of the account's trading wallets. Remove the wallets already listed by [List wallets](/reference/wallets/#list-wallets) from `pubkeys`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "On Solana, a wallet is already one of the account's trading wallets.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "At least one selected wallet is already an aged wallet"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "On Solana, a wallet already added is refused with 409, so a repeat cannot add it twice."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#add-wallets-from-launch"
        }
      }
    },
    "/wallets/{network_type}/watch/add": {
      "post": {
        "operationId": "wallets.add-watch-wallets",
        "summary": "Add watch wallets",
        "description": "Adds external addresses to the watchlist.\n\n`names`, `images` and `icons` are parallel to `pubkeys`: entry *i* applies to address *i*, and `null` leaves it unset. The web app calls this from the Watchlist, from a live launch, and after a marketplace checkout.",
        "tags": [
          "Wallets"
        ],
        "parameters": [
          {
            "name": "network_type",
            "in": "path",
            "required": true,
            "description": "Network type of the addresses.",
            "schema": {
              "type": "string",
              "enum": [
                "svm",
                "evm"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses to watch. At most 100 per request."
                  },
                  "names": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "description": "Label per address, at most 25 characters, or `null`. Optional; when sent, it must have one entry per address."
                  },
                  "images": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "description": "Base64-encoded avatar image per address (at most 2 MB), or `null`. Optional; when sent, it must have one entry per address."
                  },
                  "icons": {
                    "type": "array",
                    "items": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "description": "Short text icon per address, at most 20 characters, or `null`. Optional; when sent, it must have one entry per address."
                  },
                  "is_bookmark": {
                    "type": "array",
                    "items": {
                      "type": "boolean"
                    },
                    "description": "Bookmark flag per address. Ignored unless it has one entry per address."
                  }
                },
                "required": [
                  "pubkeys"
                ]
              },
              "example": {
                "pubkeys": [
                  "DD4FUCY8FRnqJWxXg3UJ7PsouHXGjkkLmPa2YSwr4bVh"
                ],
                "names": [
                  "Whale 1"
                ],
                "images": [
                  null
                ],
                "icons": [
                  null
                ],
                "is_bookmark": [
                  true
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    }
                  }
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `network_type` is not `svm` or `evm`. Use `svm` or `evm` as `network_type`.\n\n`bad_request`: On SVM, no address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: On EVM, no address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: More than 100 addresses were sent. Split the addresses into batches of 100 or fewer.\n\n`bad_request`: `names` does not have one entry per address. Send one `names` entry per address, `null` for none.\n\n`bad_request`: A name is longer than 25 characters. Shorten the name to 25 characters or fewer.\n\n`bad_request`: `images` does not have one entry per address. Send one `images` entry per address, `null` for none.\n\n`bad_request`: `icons` does not have one entry per address. Send one `icons` entry per address, `null` for none.\n\n`bad_request`: An icon is longer than 20 characters. Shorten the icon to 20 characters or fewer.\n\n`bad_request`: On SVM, an address is not a valid Solana address. Check that every address is a valid base58 public key.\n\n`bad_request`: On EVM, an address is not a valid EVM address. Check that every address is a valid `0x` address.\n\n`bad_request`: An image is not valid base64. Send each image as base64-encoded bytes.\n\n`bad_request`: An image is larger than 2 MB once decoded. Send images of 2 MB or less.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`network_type` is not `svm` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown network_type: <network_type>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "On SVM, no address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No pubkeys provided"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On EVM, no address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No addresses provided"
                    }
                  },
                  "bad_request_4": {
                    "summary": "More than 100 addresses were sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Maximum 100 wallets per request"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`names` does not have one entry per address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Names array must match pubkeys length"
                    }
                  },
                  "bad_request_6": {
                    "summary": "A name is longer than 25 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Name must be 25 characters or less"
                    }
                  },
                  "bad_request_7": {
                    "summary": "`images` does not have one entry per address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Images array must match pubkeys length"
                    }
                  },
                  "bad_request_8": {
                    "summary": "`icons` does not have one entry per address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Icons array must match pubkeys length"
                    }
                  },
                  "bad_request_9": {
                    "summary": "An icon is longer than 20 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Icon must be 20 characters or less"
                    }
                  },
                  "bad_request_10": {
                    "summary": "On SVM, an address is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey: <pubkey>"
                    }
                  },
                  "bad_request_11": {
                    "summary": "On EVM, an address is not a valid EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid evm address: <pubkey>"
                    }
                  },
                  "bad_request_12": {
                    "summary": "An image is not valid base64.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid base64 image at index <i>"
                    }
                  },
                  "bad_request_13": {
                    "summary": "An image is larger than 2 MB once decoded.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Image at index <i> too large (max 2MB)"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Adding an address that is already watched updates its name, image and icon instead of duplicating it."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#add-watch-wallets"
        }
      }
    },
    "/wallets/rename": {
      "post": {
        "operationId": "wallets.update-a-wallet",
        "summary": "Update a wallet",
        "description": "Sets the name, icon, image or bookmark flag of a wallet or watched address.\n\nOmit a field to leave it unchanged; send `null` to clear it. The network is read from the address format. The web app uses it to edit watchlist entries and to toggle bookmarks.",
        "tags": [
          "Wallets"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkey": {
                    "type": "string",
                    "description": "Address to update."
                  },
                  "name": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "New label, 1 to 25 characters. `null` clears it."
                  },
                  "icon": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "New text icon, at most 20 characters. `null` clears it."
                  },
                  "image": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "New avatar as base64-encoded image data, at most 2 MB. `null` removes it."
                  },
                  "is_bookmark": {
                    "type": "boolean",
                    "description": "Bookmark flag."
                  }
                },
                "required": [
                  "pubkey"
                ]
              },
              "example": {
                "pubkey": "DD4FUCY8FRnqJWxXg3UJ7PsouHXGjkkLmPa2YSwr4bVh",
                "name": "Whale 1",
                "is_bookmark": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    }
                  }
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `pubkey` is not a valid address. Send a valid Solana or `0x` address.\n\n`bad_request`: `name` is longer than 25 characters. Shorten `name` to 25 characters or fewer.\n\n`bad_request`: `name` is an empty string. Send `null` to clear the name.\n\n`bad_request`: `icon` is longer than 20 characters. Shorten `icon` to 20 characters or fewer.\n\n`bad_request`: `image` is not valid base64. Send `image` as base64-encoded bytes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`pubkey` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`name` is longer than 25 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Name must be 25 characters or less"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`name` is an empty string.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Name cannot be empty, use null to clear"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`icon` is longer than 20 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Icon must be 20 characters or less"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`image` is not valid base64.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid base64 image data"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The image is larger than 2 MB. Send an image of 2 MB or less.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The image is larger than 2 MB.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Image too large (max 2MB)"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The address is not a wallet of the account. Returned as a 500, not a 404. Use an address from [List wallets](/reference/wallets/#list-wallets) or [List watch wallets](/reference/wallets/#list-watch-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The address is not a wallet of the account. Returned as a 500, not a 404.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Wallet not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sending the same values again leaves the wallet in the same state."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#update-a-wallet"
        }
      }
    },
    "/wallets/watch/list": {
      "get": {
        "operationId": "wallets.list-watch-wallets",
        "summary": "List watch wallets",
        "description": "Returns every watched address of the account, SVM and EVM, most recent first.",
        "tags": [
          "Wallets"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Watch wallet](#object-watch-wallet) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Watched addresses."
                    }
                  }
                },
                "example": {
                  "wallets": [
                    {
                      "pubkey": "DD4FUCY8FRnqJWxXg3UJ7PsouHXGjkkLmPa2YSwr4bVh",
                      "network_type": "svm",
                      "name": "Whale 1",
                      "icon": null,
                      "image_link": null,
                      "is_bookmark": true,
                      "created_at": 1792310400
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#list-watch-wallets"
        }
      }
    },
    "/wallets/watch/remove": {
      "post": {
        "operationId": "wallets.remove-watch-wallets",
        "summary": "Remove watch wallets",
        "description": "Removes addresses from the watchlist.",
        "tags": [
          "Wallets"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses to stop watching. SVM and EVM addresses can be mixed."
                  }
                },
                "required": [
                  "pubkeys"
                ]
              },
              "example": {
                "pubkeys": [
                  "DD4FUCY8FRnqJWxXg3UJ7PsouHXGjkkLmPa2YSwr4bVh"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "removed": {
                      "type": "integer",
                      "description": "Number of watched wallets removed. Addresses that were not watched are skipped."
                    }
                  }
                },
                "example": {
                  "removed": 2
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: An address is neither a `0x` address nor a valid Solana address. Check every address in `pubkeys`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No pubkeys provided"
                    }
                  },
                  "bad_request_2": {
                    "summary": "An address is neither a `0x` address nor a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey: <pubkey>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Addresses that are not watched are skipped, so a repeat returns `removed: 0`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallets/#remove-watch-wallets"
        }
      }
    },
    "/wallets/funders/list": {
      "get": {
        "operationId": "funders.list-funders",
        "summary": "List funders",
        "description": "Returns every funder of the account, SVM and EVM, with live native balances.",
        "tags": [
          "Funders"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Funder](#object-funder) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "funders": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Funders of the account."
                    }
                  }
                },
                "example": {
                  "funders": [
                    {
                      "pubkey": "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy",
                      "network_type": "svm",
                      "is_default": [
                        "sol"
                      ],
                      "native_balances": {
                        "sol": "4820000000"
                      },
                      "created_at": 1790380800
                    },
                    {
                      "pubkey": "0x8b1cf9c07608e850143a110f4c5951655d345daf",
                      "network_type": "evm",
                      "is_default": [
                        "bsc",
                        "base"
                      ],
                      "native_balances": {
                        "eth": "0",
                        "bsc": "250000000000000000",
                        "base": "12000000000000000",
                        "robinhood": "0",
                        "arc": "0",
                        "xlayer": "0"
                      },
                      "created_at": 1790467200
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Reading the balances of SVM funders from the RPC failed. Retry after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Reading the balances of SVM funders from the RPC failed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funders/#list-funders"
        }
      }
    },
    "/wallets/{network_type}/funders/add": {
      "post": {
        "operationId": "funders.create-a-funder",
        "summary": "Create a funder",
        "description": "Generates a new funder, imports one from a private key, or promotes an existing wallet to funder.\n\nThe web app generates new funders and, on SVM, promotes an existing wallet by address from the funder settings.",
        "tags": [
          "Funders"
        ],
        "parameters": [
          {
            "name": "network_type",
            "in": "path",
            "required": true,
            "description": "Network type of the funder.",
            "schema": {
              "type": "string",
              "enum": [
                "svm",
                "evm"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "key": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "object",
                        "properties": {
                          "secret": {
                            "type": "string",
                            "description": "Private key to import. Requires key-management rights on the license."
                          },
                          "pubkey": {
                            "type": "string",
                            "description": "Address of an existing wallet of the account to use as funder. SVM only."
                          }
                        }
                      }
                    ],
                    "description": "The string `\"None\"` to generate a new keypair, `{ \"secret\": \"...\" }` to import a private key, or `{ \"pubkey\": \"...\" }` to use one of your existing wallets (SVM only)."
                  },
                  "is_default": {
                    "type": "boolean",
                    "description": "Whether to make the new funder the default."
                  }
                },
                "required": [
                  "key"
                ]
              },
              "example": {
                "key": "None",
                "is_default": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pubkey": {
                      "type": "string",
                      "description": "Address of the funder."
                    }
                  }
                },
                "example": {
                  "pubkey": "AqaW1YghutnQEhjycn8m26Rr4RzZuZAoaNYsFjRP5NDp"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `network_type` is not `svm` or `evm`. Use `svm` or `evm` as `network_type`.\n\n`bad_request`: `key.secret` is not a valid secret key for the network. Send a valid secret key for the network in `key.secret`.\n\n`bad_request`: On SVM, `key.pubkey` is not a valid Solana address. Send a valid base58 address in `key.pubkey`.\n\n`bad_request`: `key.pubkey` was sent on EVM, where a funder can only be generated or imported. Generate the EVM funder, or import it with `key.secret`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`network_type` is not `svm` or `evm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown network_type: <network_type>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`key.secret` is not a valid secret key for the network.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid secret key"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On SVM, `key.pubkey` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`key.pubkey` was sent on EVM, where a funder can only be generated or imported.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Linking an existing wallet by pubkey is not supported for evm — import via secret"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: A secret key was sent and the license cannot import keys. Generate the funder instead, or use a license with key-management rights.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "A secret key was sent and the license cannot import keys.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "Unauthorized to import a funder key"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: On SVM, the wallet named by `key.pubkey` is not on the account. Use an address from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "On SVM, the wallet named by `key.pubkey` is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The account already has 10 funders on this network. Remove an unused funder with [Delete a funder](/reference/funders/#delete-a-funder) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The account already has 10 funders on this network.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Maximum number of funders reached"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Generating creates a new funder on each call; importing the same secret again is harmless. Before retrying a generate, call [List funders](/reference/funders/#list-funders) and check whether the funder was added."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funders/#create-a-funder"
        }
      }
    },
    "/wallets/funders/export": {
      "post": {
        "operationId": "funders.export-a-funder-key",
        "summary": "Export a funder key",
        "description": "Returns the private key of a funder.\n\nThe response contains the private key in clear. Anyone holding it controls the funder's funds.\n\nProtected by the `wallet.export_funder` 2FA action when the user has enabled it.",
        "tags": [
          "Funders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkey": {
                    "type": "string",
                    "description": "Address of the funder."
                  }
                },
                "required": [
                  "pubkey"
                ]
              },
              "example": {
                "pubkey": "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pubkey": {
                      "type": "string",
                      "description": "Address of the funder."
                    },
                    "secret_key": {
                      "type": "string",
                      "description": "Private key: base58 on SVM, hex on EVM."
                    }
                  }
                },
                "example": {
                  "pubkey": "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy",
                  "secret_key": "<base58 secret key>"
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: On EVM, the funder is not on the account. Use an address from [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "On EVM, the funder is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Funder not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On SVM, the funder is not on the account. Returned as a 500, not a 404.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funder not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "wallet.export_funder",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only: a repeat returns the same key."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funders/#export-a-funder-key"
        }
      }
    },
    "/wallets/funders/remove": {
      "post": {
        "operationId": "funders.delete-a-funder",
        "summary": "Delete a funder",
        "description": "Removes a funder that holds no withdrawable balance.\n\nBefore deleting, the web app withdraws the funder's balance and waits for the withdrawal to finish.",
        "tags": [
          "Funders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkey": {
                    "type": "string",
                    "description": "Address of the funder."
                  }
                },
                "required": [
                  "pubkey"
                ]
              },
              "example": {
                "pubkey": "AqaW1YghutnQEhjycn8m26Rr4RzZuZAoaNYsFjRP5NDp"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    }
                  }
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: On SVM, the address is not a valid Solana address. Use an address from [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "On SVM, the address is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: On EVM, the funder is not on the account. Use an address from [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "On EVM, the funder is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Funder not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: On EVM, the funder still holds a withdrawable balance on a chain. Move the balance out with [Execute a withdrawal](/reference/withdrawals/#execute-a-withdrawal), then retry.\n\n`conflict`: On SVM, the funder still holds a withdrawable balance. Move the balance out with [Execute a withdrawal](/reference/withdrawals/#execute-a-withdrawal), then retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "On EVM, the funder still holds a withdrawable balance on a chain.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Funder still has a withdrawable balance on <chain_id>; withdraw it before removing"
                    }
                  },
                  "conflict_2": {
                    "summary": "On SVM, the funder still holds a withdrawable balance.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Funder still has a withdrawable balance; withdraw it before removing"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: On SVM, the balance check could not read the funder's balance from the RPC. Retry after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "On SVM, the balance check could not read the funder's balance from the RPC.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <error>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from [List funders](/reference/funders/#list-funders).\n\n`internal_error`: On SVM, the funder is the account's last funder. Returned as a 500. EVM has no such check. Create another funder with [Create a funder](/reference/funders/#create-a-funder) first.\n\n`internal_error`: On SVM, the funder is the account's active shield deployer. Returned as a 500. Keep this funder while the shield it deployed is active.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On SVM, the funder is not on the account. Returned as a 500, not a 404.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funder not found"
                    }
                  },
                  "internal_error_2": {
                    "summary": "On SVM, the funder is the account's last funder. Returned as a 500. EVM has no such check.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Cannot remove the last funder"
                    }
                  },
                  "internal_error_3": {
                    "summary": "On SVM, the funder is the account's active shield deployer. Returned as a 500.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Cannot remove funder while it is the active shield deployer"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat after a successful removal returns a \"Funder not found\" error."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funders/#delete-a-funder"
        }
      }
    },
    "/wallets/funders/set-default": {
      "post": {
        "operationId": "funders.set-the-default-funder",
        "summary": "Set the default funder",
        "description": "Makes a funder the default for the given chains.",
        "tags": [
          "Funders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkey": {
                    "type": "string",
                    "description": "Address of the funder."
                  },
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Chain IDs to make it the default for. Must match the funder's network type."
                  }
                },
                "required": [
                  "pubkey",
                  "chains"
                ]
              },
              "example": {
                "pubkey": "0x8b1cf9c07608e850143a110f4c5951655d345daf",
                "chains": [
                  "bsc",
                  "base"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    }
                  }
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: An EVM funder was set for `sol`. Use an SVM funder for `sol`.\n\n`bad_request`: An SVM funder was set for an EVM chain. Use an EVM funder for EVM chains.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "An EVM funder was set for `sol`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "cannot set an evm pubkey as default for sol"
                    }
                  },
                  "bad_request_2": {
                    "summary": "An SVM funder was set for an EVM chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "evm chain default requires an evm funder pubkey"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: On EVM, the funder is not on the account. Use an address from [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "On EVM, the funder is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Funder not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On SVM, the funder is not on the account. Returned as a 500, not a 404. Use an address from [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On SVM, the funder is not on the account. Returned as a 500, not a 404.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funder not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Chains are applied one at a time, so after an error the earlier chains may already be set; check [List funders](/reference/funders/#list-funders). Sending the same body again is harmless."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funders/#set-the-default-funder"
        }
      }
    },
    "/wallets/tags/create-tag": {
      "post": {
        "operationId": "wallet-folders.create-a-folder",
        "summary": "Create a folder",
        "description": "Creates an empty folder on a network type.",
        "tags": [
          "Wallet folders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Folder name, at most 25 characters."
                  },
                  "color": {
                    "type": "string",
                    "description": "Display color as a hex string."
                  },
                  "network_type": {
                    "type": "string",
                    "enum": [
                      "svm",
                      "evm"
                    ],
                    "description": "Network type of the wallets the folder will hold."
                  }
                },
                "required": [
                  "name",
                  "color",
                  "network_type"
                ]
              },
              "example": {
                "name": "Snipers",
                "color": "#A6B1FF",
                "network_type": "svm"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    },
                    "tag_id": {
                      "type": "integer",
                      "description": "ID of the new folder."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully created tag",
                  "tag_id": 12
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `name` is longer than 25 characters. Shorten `name` to 25 characters or fewer.\n\n`bad_request`: `network_type` is missing. Set `network_type` to `svm` or `evm`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`name` is longer than 25 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Tag name too long"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`network_type` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "network_type is required (\"svm\" or \"evm\")"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call creates a new folder, even with a name already in use. Before retrying, call [List wallets](/reference/wallets/#list-wallets) and look for the folder in `tags`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-folders/#create-a-folder"
        }
      }
    },
    "/wallets/tags/update-tag": {
      "post": {
        "operationId": "wallet-folders.update-a-folder",
        "summary": "Update a folder",
        "description": "Renames, recolors, archives or unarchives a folder.\n\nOmitted fields are left unchanged.",
        "tags": [
          "Wallet folders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "integer",
                    "description": "ID of the folder."
                  },
                  "new_name": {
                    "type": "string",
                    "description": "New name, at most 25 characters."
                  },
                  "new_color": {
                    "type": "string",
                    "description": "New hex color."
                  },
                  "archive": {
                    "type": "boolean",
                    "description": "`true` to archive the folder, `false` to unarchive it."
                  }
                },
                "required": [
                  "tag_id"
                ]
              },
              "example": {
                "tag_id": 12,
                "new_name": "Snipers (old)",
                "archive": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully updated tag"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `new_name` is longer than 25 characters. Shorten `new_name` to 25 characters or fewer.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`new_name` is longer than 25 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Tag name too long"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The folder is not on the account. Returned as a 500, not a 404. Use a folder ID from the `tags` of [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The folder is not on the account. Returned as a 500, not a 404.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "tag not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sending the same values again leaves the folder in the same state."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-folders/#update-a-folder"
        }
      }
    },
    "/wallets/tags/delete-tag": {
      "post": {
        "operationId": "wallet-folders.delete-a-folder",
        "summary": "Delete a folder",
        "description": "Deletes a folder.",
        "tags": [
          "Wallet folders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "integer",
                    "description": "ID of the folder."
                  }
                },
                "required": [
                  "tag_id"
                ]
              },
              "example": {
                "tag_id": 12
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully deleted tag"
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The folder is not on the account. Returned as a 500, not a 404. Use a folder ID from the `tags` of [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The folder is not on the account. Returned as a 500, not a 404.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "tag not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat after a successful delete returns 500 `tag not found`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-folders/#delete-a-folder"
        }
      }
    },
    "/wallets/tags/tag-wallets": {
      "post": {
        "operationId": "wallet-folders.add-wallets-to-a-folder",
        "summary": "Add wallets to a folder",
        "description": "Adds wallets to a folder.\n\nThe network is read from the address format, and the folder must belong to that network. Addresses that are not wallets of the account are skipped. The web app calls this after creating wallets, from the folder pickers, and after a marketplace order is delivered.",
        "tags": [
          "Wallet folders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "integer",
                    "description": "ID of the folder."
                  },
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses to add, all on the folder's network."
                  }
                },
                "required": [
                  "tag_id",
                  "pubkeys"
                ]
              },
              "example": {
                "tag_id": 12,
                "pubkeys": [
                  "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                  "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully added tag to wallets"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: SVM and EVM addresses were mixed. Send SVM and EVM addresses in separate requests.\n\n`bad_request`: The folder is not on the account for the addresses' network. Use a folder of the same network from the `tags` of [List wallets](/reference/wallets/#list-wallets).\n\n`bad_request`: For an SVM folder, an address is not a valid Solana address. Check that every address is a valid base58 public key.\n\n`bad_request`: For an EVM folder, an address is not a valid EVM address. Check that every address is a valid `0x` address.\n\n`bad_request`: None of the addresses is a wallet of the account. Use addresses from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No pubkeys provided"
                    }
                  },
                  "bad_request_2": {
                    "summary": "SVM and EVM addresses were mixed.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Mixed evm + svm addresses are not allowed in a single tag operation"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The folder is not on the account for the addresses' network.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "tag not found for this network"
                    }
                  },
                  "bad_request_4": {
                    "summary": "For an SVM folder, an address is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey format for SVM tag"
                    }
                  },
                  "bad_request_5": {
                    "summary": "For an EVM folder, an address is not a valid EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid evm address"
                    }
                  },
                  "bad_request_6": {
                    "summary": "None of the addresses is a wallet of the account.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "none of these wallets belong to this account"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A wallet already in the folder is left as is."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-folders/#add-wallets-to-a-folder"
        }
      }
    },
    "/wallets/tags/untag-wallets": {
      "post": {
        "operationId": "wallet-folders.remove-wallets-from-a-folder",
        "summary": "Remove wallets from a folder",
        "description": "Removes wallets from a folder without deleting them.",
        "tags": [
          "Wallet folders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "integer",
                    "description": "ID of the folder."
                  },
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses to remove, all on the folder's network."
                  }
                },
                "required": [
                  "tag_id",
                  "pubkeys"
                ]
              },
              "example": {
                "tag_id": 12,
                "pubkeys": [
                  "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully removed tag from wallets"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No address was sent. Send at least one address in `pubkeys`.\n\n`bad_request`: SVM and EVM addresses were mixed. Send SVM and EVM addresses in separate requests.\n\n`bad_request`: The folder is not on the account for the addresses' network. Use a folder of the same network from the `tags` of [List wallets](/reference/wallets/#list-wallets).\n\n`bad_request`: For an SVM folder, an address is not a valid Solana address. Check that every address is a valid base58 public key.\n\n`bad_request`: For an EVM folder, an address is not a valid EVM address. Check that every address is a valid `0x` address.\n\n`bad_request`: None of the addresses is a wallet of the account. Use addresses from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No address was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No pubkeys provided"
                    }
                  },
                  "bad_request_2": {
                    "summary": "SVM and EVM addresses were mixed.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Mixed evm + svm addresses are not allowed in a single tag operation"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The folder is not on the account for the addresses' network.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "tag not found for this network"
                    }
                  },
                  "bad_request_4": {
                    "summary": "For an SVM folder, an address is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey format for SVM tag"
                    }
                  },
                  "bad_request_5": {
                    "summary": "For an EVM folder, an address is not a valid EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid evm address"
                    }
                  },
                  "bad_request_6": {
                    "summary": "None of the addresses is a wallet of the account.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "none of these wallets belong to this account"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A wallet that is not in the folder is left as is."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-folders/#remove-wallets-from-a-folder"
        }
      }
    },
    "/wallets/{chain_id}/fake-volume/status": {
      "get": {
        "operationId": "generate-activity.retrieve-the-session",
        "summary": "Retrieve the session",
        "description": "Returns the status and settings of the current or last session.",
        "tags": [
          "Generate activity"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`).",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a [Generate activity session](#object-generate-activity-session) object.",
            "content": {
              "application/json": {
                "example": {
                  "status": "Running",
                  "info": {
                    "started_at": 1793560000,
                    "ended_at": 0,
                    "loop_amount": 10,
                    "delay": 30000,
                    "min_sol_in": 20000000,
                    "max_sol_in": 50000000,
                    "wallets": [
                      "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                    ],
                    "status_reason": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use a supported `chain_id`; `monad` is no longer accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain_id: <chain_id>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/generate-activity/#retrieve-the-session"
        }
      }
    },
    "/wallets/{chain_id}/fake-volume/run": {
      "post": {
        "operationId": "generate-activity.start-a-session",
        "summary": "Start a session",
        "description": "Starts buy-and-sell loops on the given wallets.\n\nEach loop, every wallet buys a random amount between `min_sol_in` and `max_sol_in` and sells it back, then waits `delay` milliseconds.\n\nSpends the wallets' native balance on swaps and priority tips.\n\nThe web app blocks the start when a wallet holds less than `max_sol_in` + 50,000 lamports of priority tip per loop (1,050,000 with `Axiom`) × `loop_amount` × `aged_wallets.min_balance_multiplier` / 10,000.\n\nOn EVM chains the backend also requires `token_address`, reads `min_sol_in` and `max_sol_in` in whole native units and `delay` in seconds. The web app only starts sessions on `sol`.",
        "tags": [
          "Generate activity"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`).",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets that trade. They must be wallets of the account."
                  },
                  "min_sol_in": {
                    "type": "integer",
                    "description": "Minimum buy size per loop, in native base units. Greater than 0."
                  },
                  "max_sol_in": {
                    "type": "integer",
                    "description": "Maximum buy size per loop, in native base units. At least `min_sol_in`."
                  },
                  "loop_amount": {
                    "type": "integer",
                    "description": "Number of loops, from 1 to `aged_wallets.max_loops`."
                  },
                  "delay": {
                    "type": "integer",
                    "description": "Delay between loops in milliseconds, up to `aged_wallets.max_delay`."
                  },
                  "platform": {
                    "type": "string",
                    "enum": [
                      "None",
                      "Axiom"
                    ],
                    "description": "Trading platform. With `Axiom`, the web app budgets an extra 1,000,000 lamports per loop in its balance check."
                  }
                },
                "required": [
                  "pubkeys",
                  "min_sol_in",
                  "max_sol_in",
                  "loop_amount",
                  "delay",
                  "platform"
                ]
              },
              "example": {
                "pubkeys": [
                  "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                  "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                ],
                "min_sol_in": 20000000,
                "max_sol_in": 50000000,
                "loop_amount": 10,
                "delay": 30000,
                "platform": "None"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully started fake volume task"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use a supported `chain_id`; `monad` is no longer accepted.\n\n`bad_request`: On EVM chains, the body has no `token_address`. Add `token_address` with the token to trade.\n\n`bad_request`: On EVM chains, `pubkeys` is empty. Send at least one wallet in `pubkeys`.\n\n`bad_request`: On EVM chains, `token_address` is not a valid address. Send a valid `0x` token address.\n\n`bad_request`: On EVM chains, a wallet is not on the account. Use wallets from [List wallets](/reference/wallets/#list-wallets).\n\n`bad_request`: On EVM chains, a wallet is watch-only and cannot sign. Use wallets whose keys the account holds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain_id: <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "On EVM chains, the body has no `token_address`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: missing field `token_address` at line 1 column <column>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On EVM chains, `pubkeys` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no pubkeys provided"
                    }
                  },
                  "bad_request_4": {
                    "summary": "On EVM chains, `token_address` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid token_address"
                    }
                  },
                  "bad_request_5": {
                    "summary": "On EVM chains, a wallet is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet not found for license: <address>"
                    }
                  },
                  "bad_request_6": {
                    "summary": "On EVM chains, a wallet is watch-only and cannot sign.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet is watched, cannot sign: <address>"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: On `sol`, a session is already running. EVM chains do not check and start a second session. Wait for it to finish, or stop it with [Stop a session](/reference/generate-activity/#stop-a-session).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "On `sol`, a session is already running. EVM chains do not check and start a second session.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Task already running"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: On `sol`, reading the wallets' balances from the RPC failed. Retry after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "On `sol`, reading the wallets' balances from the RPC failed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <error>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On `sol`, `min_sol_in` or `max_sol_in` is 0. Returned as a 500, not a 400. Set both amounts above 0.\n\n`internal_error`: On `sol`, `min_sol_in` is above `max_sol_in`. Returned as a 500, not a 400. Set `min_sol_in` no higher than `max_sol_in`.\n\n`internal_error`: On `sol`, `max_sol_in` is above the per-loop cap of 1,000 SOL. Returned as a 500, not a 400. Lower `max_sol_in`.\n\n`internal_error`: On `sol`, `loop_amount` is above `aged_wallets.max_loops`. Returned as a 500, not a 400. Lower `loop_amount` to `aged_wallets.max_loops` or less.\n\n`internal_error`: On `sol`, `delay` is above `aged_wallets.max_delay`. Returned as a 500, not a 400. Lower `delay` to `aged_wallets.max_delay` or less.\n\n`internal_error`: On `sol`, `pubkeys` is empty. Returned as a 500, not a 400. Send at least one wallet in `pubkeys`.\n\n`internal_error`: On `sol`, an address is not a valid Solana address. Returned as a 500, not a 400. Check that every address is a valid base58 public key.\n\n`internal_error`: On `sol`, a wallet holds less than the balance the session needs. Returned as a 500, not a 400. Fund the wallets, or lower `max_sol_in` or `loop_amount`.\n\n`internal_error`: On `sol`, a wallet is not on the account. Returned as a 500, not a 400. Use wallets from [List wallets](/reference/wallets/#list-wallets).\n\n`internal_error`: On `sol`, a wallet is watch-only and cannot sign. Returned as a 500, not a 400. Use wallets whose keys the account holds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On `sol`, `min_sol_in` or `max_sol_in` is 0. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "sol amounts in must be greater than 0"
                    }
                  },
                  "internal_error_2": {
                    "summary": "On `sol`, `min_sol_in` is above `max_sol_in`. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "min_sol_in must be less than or equal to max_sol_in"
                    }
                  },
                  "internal_error_3": {
                    "summary": "On `sol`, `max_sol_in` is above the per-loop cap of 1,000 SOL. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "max_sol_in exceeds the per-loop cap"
                    }
                  },
                  "internal_error_4": {
                    "summary": "On `sol`, `loop_amount` is above `aged_wallets.max_loops`. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Too many loops requested"
                    }
                  },
                  "internal_error_5": {
                    "summary": "On `sol`, `delay` is above `aged_wallets.max_delay`. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Too long delay requested"
                    }
                  },
                  "internal_error_6": {
                    "summary": "On `sol`, `pubkeys` is empty. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No pubkeys provided"
                    }
                  },
                  "internal_error_7": {
                    "summary": "On `sol`, an address is not a valid Solana address. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Invalid pubkey format"
                    }
                  },
                  "internal_error_8": {
                    "summary": "On `sol`, a wallet holds less than the balance the session needs. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "At least one wallet don't have enough funds to proceed"
                    }
                  },
                  "internal_error_9": {
                    "summary": "On `sol`, a wallet is not on the account. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Wallet not found in license"
                    }
                  },
                  "internal_error_10": {
                    "summary": "On `sol`, a wallet is watch-only and cannot sign. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Wallet is watch-only and cannot sign"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Before retrying, call [Retrieve the session](/reference/generate-activity/#retrieve-the-session) and check whether a session is `Running`. On `sol` a repeat while it runs returns 409; on EVM chains it starts a second session."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/generate-activity/#start-a-session"
        }
      }
    },
    "/wallets/{chain_id}/fake-volume/cancel": {
      "post": {
        "operationId": "generate-activity.stop-a-session",
        "summary": "Stop a session",
        "description": "Stops the running session before its last loop.\n\nNo request body. The web app only calls it when the session status is `Running`.",
        "tags": [
          "Generate activity"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`).",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Fake volume task successfully cancelled"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use a supported `chain_id`; `monad` is no longer accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain_id: <chain_id>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Stopping when no session runs still returns 200."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/generate-activity/#stop-a-session"
        }
      }
    },
    "/wallets/{chain_id}/fake-volume/discard": {
      "post": {
        "operationId": "generate-activity.discard-a-session",
        "summary": "Discard a session",
        "description": "Clears the status of a finished session.\n\nNo request body. The web app calls it when the user dismisses a completed, cancelled or failed session.",
        "tags": [
          "Generate activity"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the session. The web app only offers chains whose `generate_activity` feature is enabled (currently `sol`).",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully discarded fake volume session status"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use a supported `chain_id`; `monad` is no longer accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain_id: <chain_id>"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: On `sol`, the session is still running. EVM chains do not check. Stop it with [Stop a session](/reference/generate-activity/#stop-a-session) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "On `sol`, the session is still running. EVM chains do not check.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot discard running session"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Discarding a cleared status changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/generate-activity/#discard-a-session"
        }
      }
    },
    "/funding/get": {
      "get": {
        "operationId": "funding.list-funding-jobs",
        "summary": "List funding jobs",
        "description": "Returns the account's funding jobs on every chain, excluding launch funding.\n\nThe web app polls it every 3 seconds while a job is `Running` and every 10 seconds otherwise.",
        "tags": [
          "Funding"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Funding](#object-funding) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "fundings": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Funding jobs."
                    }
                  }
                },
                "example": {
                  "fundings": [
                    {
                      "id": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85",
                      "chain_id": "sol",
                      "status": "Running",
                      "funding_type": "Classic",
                      "plan": [
                        {
                          "amount_out": 250000000,
                          "to": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44"
                        },
                        {
                          "amount_out": 310000000,
                          "to": "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                        }
                      ],
                      "funder_pubkey": "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy",
                      "funding_delay": 30,
                      "cex_provider": null,
                      "cex_order_id": null,
                      "cex_order_map": {},
                      "started_indexes": [
                        0,
                        1
                      ],
                      "funded_indexes": [
                        0
                      ],
                      "wallets_funded": 1,
                      "launch_id": null,
                      "license_key": "a0dfc12e-7daa-4f7d-b694-85f791a35f80",
                      "safety_sol": 0,
                      "created_at": 1793560000,
                      "started_at": 1793560120
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#list-funding-jobs"
        }
      }
    },
    "/funding/get-quote/{funding_id}": {
      "get": {
        "operationId": "funding.retrieve-a-funding-quote",
        "summary": "Retrieve a funding quote",
        "description": "Returns the total native amount the funder needs to execute a draft.\n\nThe web app polls it every 10 seconds on the funding confirmation screen.",
        "tags": [
          "Funding"
        ],
        "parameters": [
          {
            "name": "funding_id",
            "in": "path",
            "required": true,
            "description": "ID of the draft.",
            "schema": {
              "type": "string"
            },
            "example": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "fund_required": {
                      "type": "integer",
                      "description": "Native amount the funder must hold, in base units, including the job's fee reserve. EVM chains return it as a decimal string (wei)."
                    },
                    "expired_at": {
                      "type": "integer",
                      "description": "Unix timestamp (seconds) after which the quote is stale. The web app treats a missing value as no expiry."
                    }
                  }
                },
                "example": {
                  "fund_required": 572000000,
                  "expired_at": 1793560600
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: On Solana, a CEX line names an exchange the provider does not support. Use an exchange from [List funding sources](/reference/funding/#list-funding-sources).\n\n`unsupported_chain`: The job belongs to a chain this API no longer serves. Remove the job with [Discard a funding job](/reference/funding/#discard-a-funding-job), which still works on retired chains.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "On Solana, a CEX line names an exchange the provider does not support.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Unsupported exchange for Husher"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The job belongs to a chain this API no longer serves.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No funding job with this ID exists. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).\n\n`not_found`: On EVM chains, the job belongs to another account. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No funding job with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No funding job found with corresponding UUID"
                    }
                  },
                  "not_found_2": {
                    "summary": "On EVM chains, the job belongs to another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "funding draft not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#retrieve-a-funding-quote"
        }
      }
    },
    "/funding/{chain_id}/create-draft": {
      "post": {
        "operationId": "funding.create-a-funding-draft",
        "summary": "Create a funding draft",
        "description": "Creates a funding job in `Draft` status.\n\nNothing moves until the draft is executed. The web app picks the default funder of the chain as `funder_pubkey`.",
        "tags": [
          "Funding"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to fund on.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "plan": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "amount_out": {
                          "type": "integer",
                          "description": "Amount the recipient receives, in native base units."
                        },
                        "to": {
                          "type": "string",
                          "description": "Recipient wallet address."
                        },
                        "kind": {
                          "type": "string",
                          "description": "Exchange that funds this line, for example `binance`, from [List funding sources](#list-funding-sources). Set it on every line for a CEX job, on none for a classic job."
                        }
                      },
                      "required": [
                        "amount_out",
                        "to"
                      ]
                    },
                    "description": "One line per recipient."
                  },
                  "funding_delay": {
                    "type": "integer",
                    "description": "Seconds between two consecutive lines, from 0 to 7,200."
                  },
                  "funder_pubkey": {
                    "type": "string",
                    "description": "Funder that pays for the job."
                  },
                  "cex_provider": {
                    "type": "string",
                    "enum": [
                      "husher"
                    ],
                    "description": "Exchange routing provider. Sent for CEX jobs only."
                  }
                },
                "required": [
                  "plan",
                  "funding_delay",
                  "funder_pubkey"
                ]
              },
              "example": {
                "plan": [
                  {
                    "to": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                    "amount_out": 250000000
                  },
                  {
                    "to": "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4",
                    "amount_out": 310000000
                  }
                ],
                "funding_delay": 30,
                "funder_pubkey": "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "description": "ID of the funding job."
                    },
                    "funder_pubkey": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Funder resolved for the job."
                    }
                  }
                },
                "example": {
                  "uuid": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85",
                  "funder_pubkey": "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use a supported `chain_id`; `monad` is no longer accepted.\n\n`bad_request`: On Solana, `plan` is missing. Send at least one line in `plan`.\n\n`bad_request`: On Solana, `funder_pubkey` is not a valid address. Use a funder address from [List funders](/reference/funders/#list-funders).\n\n`bad_request`: On EVM chains, `funder_pubkey` is a `0x` address that is not a funder of the account. Use a funder address from [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain_id: <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "On Solana, `plan` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "plan is required when creating a draft"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On Solana, `funder_pubkey` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid funder pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "On EVM chains, `funder_pubkey` is a `0x` address that is not a funder of the account.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "funder <address> not found for this license (must be a universal funder)"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The exchange provider refused a CEX line, usually because its amount is below the exchange minimum. Raise the line's `amount_out` above the minimum or fund that recipient from another exchange.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The exchange provider refused a CEX line, usually because its amount is below the exchange minimum.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "husher api issue: <address> on <exchange>: <reason> (receive=<amount> <token>, min=<minimum> <token>); raise the amount or drop this exchange"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On Solana, `funding_delay` is above 7,200 seconds. Returned as a 500, not a 400. Set `funding_delay` between 0 and 7,200.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On Solana, `funding_delay` is above 7,200 seconds. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funding delay out of bounds"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call creates a new draft. Before retrying, call [List funding jobs](/reference/funding/#list-funding-jobs), which includes drafts, and remove any duplicate with [Discard a funding job](/reference/funding/#discard-a-funding-job)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#create-a-funding-draft"
        }
      }
    },
    "/funding/update-draft/{funding_id}": {
      "post": {
        "operationId": "funding.update-a-funding-draft",
        "summary": "Update a funding draft",
        "description": "Changes the plan, delay, provider or funder of a draft.\n\nOmitted fields are left unchanged, except `funder_pubkey` on Solana: omitting it resets the draft's funder to the account's default funder.",
        "tags": [
          "Funding"
        ],
        "parameters": [
          {
            "name": "funding_id",
            "in": "path",
            "required": true,
            "description": "ID of the draft.",
            "schema": {
              "type": "string"
            },
            "example": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "plan": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "amount_out": {
                          "type": "integer",
                          "description": "Amount the recipient receives, in native base units."
                        },
                        "to": {
                          "type": "string",
                          "description": "Recipient wallet address."
                        },
                        "kind": {
                          "type": "string",
                          "description": "Exchange that funds this line, for example `binance`, from [List funding sources](#list-funding-sources). Set it on every line for a CEX job, on none for a classic job."
                        }
                      },
                      "required": [
                        "amount_out",
                        "to"
                      ]
                    },
                    "description": "New plan, replacing the current one."
                  },
                  "funding_delay": {
                    "type": "integer",
                    "description": "Seconds between two consecutive lines, from 0 to 7,200."
                  },
                  "cex_provider": {
                    "type": "string",
                    "enum": [
                      "husher"
                    ],
                    "description": "Exchange routing provider."
                  },
                  "funder_pubkey": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Funder that pays for the job. On Solana, send it on every update: an omitted value resets the draft to the default funder."
                  }
                }
              },
              "example": {
                "funding_delay": 60
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "description": "ID of the funding job."
                    },
                    "funder_pubkey": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Funder resolved for the job."
                    }
                  }
                },
                "example": {
                  "uuid": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85",
                  "funder_pubkey": "91Xgc8gCBPK92v2i3CPnoMLNT8BJBRbL9WZ9ouiL5NVy"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: On Solana, `funder_pubkey` is not a valid address. Use a funder address from [List funders](/reference/funders/#list-funders).\n\n`bad_request`: On EVM chains, `funder_pubkey` is a `0x` address that is not a funder of the account. Use a funder address from [List funders](/reference/funders/#list-funders).\n\n`bad_request`: On EVM chains, `funder_pubkey` is not a `0x` address and the account has no default funder for the chain. Send a funder address from [List funders](/reference/funders/#list-funders), or set a default with [Set the default funder](/reference/funders/#set-the-default-funder).\n\n`unsupported_chain`: The job belongs to a chain this API no longer serves. Remove the job with [Discard a funding job](/reference/funding/#discard-a-funding-job), which still works on retired chains.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "On Solana, `funder_pubkey` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid funder pubkey"
                    }
                  },
                  "bad_request_2": {
                    "summary": "On EVM chains, `funder_pubkey` is a `0x` address that is not a funder of the account.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "funder <address> not found for this license (must be a universal funder)"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On EVM chains, `funder_pubkey` is not a `0x` address and the account has no default funder for the chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "funder not found"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The job belongs to a chain this API no longer serves.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No funding job with this ID exists. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No funding job with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No funding job found with corresponding UUID"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The job is no longer a draft. Create a new draft with [Create a funding draft](/reference/funding/#create-a-funding-draft).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The job is no longer a draft.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Can only update draft funding jobs"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The exchange provider refused a CEX line, usually because its amount is below the exchange minimum. Raise the line's `amount_out` above the minimum or fund that recipient from another exchange.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The exchange provider refused a CEX line, usually because its amount is below the exchange minimum.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "husher api issue: <address> on <exchange>: <reason> (receive=<amount> <token>, min=<minimum> <token>); raise the amount or drop this exchange"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On Solana, `funding_delay` is above 7,200 seconds. Returned as a 500, not a 400. Set `funding_delay` between 0 and 7,200.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On Solana, `funding_delay` is above 7,200 seconds. Returned as a 500, not a 400.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funding delay out of bounds"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sending the same update again leaves the draft in the same state."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#update-a-funding-draft"
        }
      }
    },
    "/funding/execute/{funding_id}": {
      "post": {
        "operationId": "funding.execute-a-funding-draft",
        "summary": "Execute a funding draft",
        "description": "Starts sending funds for a draft.\n\nNo request body. The job moves to `Running` and continues in the background.\n\nMoves funds from the funder to every recipient in the plan. Lines already sent are not reversible.",
        "tags": [
          "Funding"
        ],
        "parameters": [
          {
            "name": "funding_id",
            "in": "path",
            "required": true,
            "description": "ID of the draft.",
            "schema": {
              "type": "string"
            },
            "example": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully started funding"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: On EVM chains, the job is not a draft. Solana returns 409 instead. Check the job's `status` in [List funding jobs](/reference/funding/#list-funding-jobs).\n\n`bad_request`: On Solana, the job's funder address is invalid. Set a funder from [List funders](/reference/funders/#list-funders) with [Update a funding draft](/reference/funding/#update-a-funding-draft).\n\n`bad_request`: On EVM chains, the job's funder cannot be used. Set another funder with [Update a funding draft](/reference/funding/#update-a-funding-draft).\n\n`bad_request`: On EVM chains, the draft has no funder and the account has no default funder for the chain. Set a default with [Set the default funder](/reference/funders/#set-the-default-funder), or a funder on the draft.\n\n`unsupported_chain`: The job belongs to a chain this API no longer serves. Remove the job with [Discard a funding job](/reference/funding/#discard-a-funding-job), which still works on retired chains.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "On EVM chains, the job is not a draft. Solana returns 409 instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "funding job is not in draft status"
                    }
                  },
                  "bad_request_2": {
                    "summary": "On Solana, the job's funder address is invalid.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid funder pubkey"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On EVM chains, the job's funder cannot be used.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "funder unavailable: <reason>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "On EVM chains, the draft has no funder and the account has no default funder for the chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no default <chain> funder set, use /wallets/funders/set-default or assign one to the draft"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The job belongs to a chain this API no longer serves.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No funding job with this ID exists. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).\n\n`not_found`: On EVM chains, the job belongs to another account. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).\n\n`not_found`: On Solana, the job's funder is not on the account. Set a funder from [List funders](/reference/funders/#list-funders) with [Update a funding draft](/reference/funding/#update-a-funding-draft).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No funding job with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No funding job found with corresponding UUID"
                    }
                  },
                  "not_found_2": {
                    "summary": "On EVM chains, the job belongs to another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "funding draft not found"
                    }
                  },
                  "not_found_3": {
                    "summary": "On Solana, the job's funder is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Funder wallet not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: On Solana, the job is not a draft. Check the job's `status` in [List funding jobs](/reference/funding/#list-funding-jobs).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "On Solana, the job is not a draft.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Funding job must be a draft to execute it"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: On EVM chains, the exchange provider refused the CEX order. Check the message, adjust the plan, then retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "On EVM chains, the exchange provider refused the CEX order.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "husher api issue: <message>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On Solana, the funder holds less than the job needs. Returned as a 500. Top up the funder to the amount from [Retrieve a funding quote](/reference/funding/#retrieve-a-funding-quote).\n\n`internal_error`: On Solana, the plan has no recipient. Returned as a 500. Add lines to the plan with [Update a funding draft](/reference/funding/#update-a-funding-draft).\n\n`internal_error`: On EVM chains, a job without `funding_delay` runs at once and a send failed. The job is marked `Failed`. Check the job in [List funding jobs](/reference/funding/#list-funding-jobs) and rescue or discard it.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On Solana, the funder holds less than the job needs. Returned as a 500.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funder don't have enough funds"
                    }
                  },
                  "internal_error_2": {
                    "summary": "On Solana, the plan has no recipient. Returned as a 500.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funding plan has no recipients"
                    }
                  },
                  "internal_error_3": {
                    "summary": "On EVM chains, a job without `funding_delay` runs at once and a send failed. The job is marked `Failed`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "funding failed: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Before retrying, call [List funding jobs](/reference/funding/#list-funding-jobs): if the job's `status` is no longer `Draft`, the first call started it. A repeat on a started job is refused (409 on Solana, 400 on EVM chains)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#execute-a-funding-draft"
        }
      }
    },
    "/funding/discard/{funding_id}": {
      "post": {
        "operationId": "funding.discard-a-funding-job",
        "summary": "Discard a funding job",
        "description": "Deletes a draft or a finished funding job from the list.\n\nNo request body.",
        "tags": [
          "Funding"
        ],
        "parameters": [
          {
            "name": "funding_id",
            "in": "path",
            "required": true,
            "description": "ID of the funding job (`id` of the Funding object).",
            "schema": {
              "type": "string"
            },
            "example": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully discarded funding job"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: On EVM chains, the job is running. Solana returns 409 instead. Cancel it with [Cancel a funding job](/reference/funding/#cancel-a-funding-job) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "On EVM chains, the job is running. Solana returns 409 instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "cannot discard a running job — cancel it first"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No funding job with this ID exists. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).\n\n`not_found`: On EVM chains, the job belongs to another account. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No funding job with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No funding job found with corresponding UUID"
                    }
                  },
                  "not_found_2": {
                    "summary": "On EVM chains, the job belongs to another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "funding job not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: On Solana, the job is running. Cancel it with [Cancel a funding job](/reference/funding/#cancel-a-funding-job) first.\n\n`conflict`: On Solana, funds are stuck in the job's intermediate wallets. Sweep them with [Rescue a funding job](/reference/funding/#rescue-a-funding-job) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "On Solana, the job is running.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot discard a running funding job"
                    }
                  },
                  "conflict_2": {
                    "summary": "On Solana, funds are stuck in the job's intermediate wallets.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Some funds are stuck, please rescue before discarding"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat after a successful discard returns 404."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#discard-a-funding-job"
        }
      }
    },
    "/funding/get-funding-sources": {
      "get": {
        "operationId": "funding.list-funding-sources",
        "summary": "List funding sources",
        "description": "Returns the exchanges available for CEX funding on each chain, with their minimums.\n\nAvailability comes from a live rate check with the provider. The web app caches the result for 60 seconds.",
        "tags": [
          "Funding"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "sources": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "description": "Exchange ID, used as `kind` in a plan line."
                            },
                            "is_available": {
                              "type": "boolean",
                              "description": "Whether the exchange currently routes."
                            },
                            "image": {
                              "type": "string",
                              "description": "Logo URL."
                            },
                            "min_native_funding": {
                              "type": "integer",
                              "description": "Smallest line amount the exchange accepts, in native base units."
                            },
                            "provider": {
                              "type": "string",
                              "enum": [
                                "husher"
                              ],
                              "description": "Routing provider."
                            }
                          }
                        },
                        "description": "Exchanges usable on this chain."
                      },
                      "x-proxima-key": "chain_id",
                      "description": "Exchanges per chain ID."
                    }
                  }
                },
                "example": {
                  "sources": {
                    "sol": [
                      {
                        "id": "binance",
                        "is_available": true,
                        "image": "https://cdn.example.com/cex/binance.png",
                        "min_native_funding": 120000000,
                        "provider": "husher"
                      },
                      {
                        "id": "kucoin",
                        "is_available": false,
                        "image": "https://cdn.example.com/cex/kucoin.png",
                        "min_native_funding": 90000000,
                        "provider": "husher"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#list-funding-sources"
        }
      }
    },
    "/funding/rescue/{funding_id}": {
      "post": {
        "operationId": "funding.rescue-a-funding-job",
        "summary": "Rescue a funding job",
        "description": "Sweeps funds left in a classic job's intermediate wallets back to the default funder.\n\nNo request body. On Solana a classic job hops through intermediate wallets; use this when a stopped or failed job left funds in them. An EVM classic job pays recipients directly, so on EVM chains the call always returns `No fund to rescue`.",
        "tags": [
          "Funding"
        ],
        "parameters": [
          {
            "name": "funding_id",
            "in": "path",
            "required": true,
            "description": "ID of the funding job (`id` of the Funding object).",
            "schema": {
              "type": "string"
            },
            "example": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully withdrew"
                }
              }
            }
          },
          "400": {
            "description": "`unsupported_chain`: The job belongs to a chain this API no longer serves. Remove the job with [Discard a funding job](/reference/funding/#discard-a-funding-job), which still works on retired chains.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unsupported_chain": {
                    "summary": "The job belongs to a chain this API no longer serves.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No funding job with this ID exists. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No funding job with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No funding job found with corresponding UUID"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: On Solana, the job is running. Wait for it to end, or cancel it with [Cancel a funding job](/reference/funding/#cancel-a-funding-job).\n\n`conflict`: On Solana, the job is a CEX job. Rescue only classic jobs.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "On Solana, the job is running.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot rescue a running funding job"
                    }
                  },
                  "conflict_2": {
                    "summary": "On Solana, the job is a CEX job.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot rescue a CEX funding job"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Only what is left in the intermediate wallets is swept, so a repeat moves nothing new."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#rescue-a-funding-job"
        }
      }
    },
    "/funding/cancel/{funding_id}": {
      "post": {
        "operationId": "funding.cancel-a-funding-job",
        "summary": "Cancel a funding job",
        "description": "Stops a running job before its remaining lines are sent.\n\nNo request body.\n\nOnly lines not yet sent are stopped. Funds already delivered stay with their recipients.",
        "tags": [
          "Funding"
        ],
        "parameters": [
          {
            "name": "funding_id",
            "in": "path",
            "required": true,
            "description": "ID of the funding job (`id` of the Funding object).",
            "schema": {
              "type": "string"
            },
            "example": "bba9fee8-4598-44fb-b1c0-6d0ae46ddc85"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the cancellation was accepted."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable result."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Funding cancellation requested"
                }
              }
            }
          },
          "400": {
            "description": "`unsupported_chain`: The job belongs to a chain this API no longer serves. Remove the job with [Discard a funding job](/reference/funding/#discard-a-funding-job), which still works on retired chains.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unsupported_chain": {
                    "summary": "The job belongs to a chain this API no longer serves.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No funding job with this ID exists. Use an `id` from [List funding jobs](/reference/funding/#list-funding-jobs).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No funding job with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No funding job found with corresponding UUID"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The job is not running. Check the job's `status` in [List funding jobs](/reference/funding/#list-funding-jobs).\n\n`conflict`: On Solana, the job cannot be cancelled: a classic job without `funding_delay`, or a CEX job. Let the job finish.\n\n`conflict`: On EVM chains, the job has no `funding_delay` and cannot be cancelled. Let the job finish.\n\n`conflict`: Another server instance is processing the job. Retry after a few seconds.\n\n`conflict`: The job has just resumed on this instance. Retry after a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The job is not running.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Funding job is not running"
                    }
                  },
                  "conflict_2": {
                    "summary": "On Solana, the job cannot be cancelled: a classic job without `funding_delay`, or a CEX job.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "This funding job cannot be cancelled (no delay or unsupported provider)"
                    }
                  },
                  "conflict_3": {
                    "summary": "On EVM chains, the job has no `funding_delay` and cannot be cancelled.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "This funding job cannot be cancelled (no delay)"
                    }
                  },
                  "conflict_4": {
                    "summary": "Another server instance is processing the job.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Funding job is being walked elsewhere, retry in a moment"
                    }
                  },
                  "conflict_5": {
                    "summary": "The job has just resumed on this instance.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Funding job just resumed here, retry in a moment"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Cancelling an already cancelled job changes nothing; once the job stops, a repeat returns 409."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/funding/#cancel-a-funding-job"
        }
      }
    },
    "/withdraw/routes": {
      "get": {
        "operationId": "withdrawals.list-withdraw-routes",
        "summary": "List withdraw routes",
        "description": "Returns the source and destination pairs that can be served, for classic and CEX payouts.\n\nCached server-side with no live calls, so it is safe to load when a withdraw screen opens. A route may name the launch quote token either as `quote` or as its mint; compare both forms. Launch quote on a classic payout is accepted by quote and execute even though this list only shows `native` for classic.",
        "tags": [
          "Withdrawals"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "classic": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "src_chain": {
                            "type": "string",
                            "enum": [
                              "sol",
                              "bsc",
                              "eth",
                              "base",
                              "robinhood",
                              "arc",
                              "xlayer"
                            ],
                            "description": "Source chain."
                          },
                          "src_asset": {
                            "type": "string",
                            "description": "Source asset."
                          },
                          "dst_chain": {
                            "type": "string",
                            "enum": [
                              "sol",
                              "bsc",
                              "eth",
                              "base",
                              "robinhood",
                              "arc",
                              "xlayer"
                            ],
                            "description": "Destination chain."
                          },
                          "dst_asset": {
                            "type": "string",
                            "description": "Destination asset."
                          }
                        }
                      },
                      "description": "Classic routes."
                    },
                    "cex": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "src_chain": {
                            "type": "string",
                            "enum": [
                              "sol",
                              "bsc",
                              "eth",
                              "base",
                              "robinhood",
                              "arc",
                              "xlayer"
                            ],
                            "description": "Source chain."
                          },
                          "src_asset": {
                            "type": "string",
                            "description": "Source asset."
                          },
                          "dst_chain": {
                            "type": "string",
                            "enum": [
                              "sol",
                              "bsc",
                              "eth",
                              "base",
                              "robinhood",
                              "arc",
                              "xlayer"
                            ],
                            "description": "Destination chain."
                          },
                          "dst_asset": {
                            "type": "string",
                            "description": "Destination asset."
                          },
                          "providers": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Exchanges that can serve the route."
                          },
                          "husher_only": {
                            "type": "boolean",
                            "description": "Whether Husher liquidity is the only option (always on `robinhood`)."
                          },
                          "indicative_min_src_atomic": {
                            "type": "string",
                            "description": "Indicative minimum in source atomic units; omitted when it cannot be computed. Use it for sorting only and gate on the quote's `needs`. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                          }
                        }
                      },
                      "description": "CEX routes."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "classic": [
                    {
                      "src_chain": "sol",
                      "src_asset": "native",
                      "dst_chain": "sol",
                      "dst_asset": "native"
                    },
                    {
                      "src_chain": "bsc",
                      "src_asset": "native",
                      "dst_chain": "bsc",
                      "dst_asset": "native"
                    }
                  ],
                  "cex": [
                    {
                      "src_chain": "sol",
                      "src_asset": "native",
                      "dst_chain": "bsc",
                      "dst_asset": "native",
                      "providers": [
                        "binance",
                        "kucoin"
                      ],
                      "husher_only": false,
                      "indicative_min_src_atomic": "71000000"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/withdrawals/#list-withdraw-routes"
        }
      }
    },
    "/withdraw/quote": {
      "post": {
        "operationId": "withdrawals.retrieve-a-withdraw-quote",
        "summary": "Retrieve a withdraw quote",
        "description": "Describes what a withdraw request would collect and deliver, without signing or moving anything.\n\nTakes the exact body of [Execute a withdrawal](#execute-a-withdrawal). The web app calls it debounced while the user edits a withdraw form, and aborts stale calls.",
        "tags": [
          "Withdrawals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "launch",
                          "aged",
                          "global"
                        ],
                        "description": "`launch`: the wallets of a launch. `aged`: your trading wallets. `global`: any wallet of the account named explicitly (requires `source.select.kind` `explicit`), for example a funder."
                      },
                      "launch_ext_id": {
                        "type": "string",
                        "description": "Launch ID. Required when `kind` is `launch`."
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "description": "Universe of wallets the source draws from."
                  },
                  "source": {
                    "type": "object",
                    "properties": {
                      "chain": {
                        "type": "string",
                        "enum": [
                          "sol",
                          "bsc",
                          "eth",
                          "base",
                          "robinhood",
                          "arc",
                          "xlayer"
                        ],
                        "description": "Chain the funds are taken from."
                      },
                      "asset": {
                        "type": "string",
                        "description": "`native`, a token mint or contract address, or `quote` (the launch's quote token; requires `origin.kind` `launch`). Never a symbol."
                      },
                      "select": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "explicit",
                              "aged",
                              "launch_all"
                            ],
                            "description": "`explicit` lists wallets; `aged` takes the trading wallets of the origin; `launch_all` takes every wallet of the origin."
                          },
                          "wallets": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Addresses to drain. Required when `kind` is `explicit`."
                          }
                        },
                        "required": [
                          "kind"
                        ],
                        "description": "Wallet selection inside the origin."
                      },
                      "mode": {
                        "type": "string",
                        "enum": [
                          "withdraw_all",
                          "leave_on"
                        ],
                        "description": "Required with `select`. `leave_on` keeps the wallets of the roles in `leave_on` full."
                      },
                      "leave_on": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Required with `select` (may be empty). Roles left untouched: `dev`, `aged`, `funder`, `others`, `holders` (`holders` requires `origin.kind` `launch`)."
                      },
                      "amount": {
                        "type": "string",
                        "description": "Required with `select`. Total cap in atomic units across all wallets; `\"0\"` drains everything. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                      },
                      "dust_amount": {
                        "type": "string",
                        "description": "Atomic units left behind in each wallet."
                      },
                      "dust_amount_min": {
                        "type": "string",
                        "description": "Lower bound of a random amount left behind per wallet. At most `dust_amount_max`."
                      },
                      "dust_amount_max": {
                        "type": "string",
                        "description": "Upper bound of a random amount left behind per wallet."
                      },
                      "transfers": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "from": {
                              "type": "string",
                              "description": "Source wallet."
                            },
                            "to": {
                              "type": "string",
                              "description": "Destination address."
                            },
                            "amount": {
                              "type": "string",
                              "description": "Atomic-unit cap for this transfer, greater than 0. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                            }
                          },
                          "required": [
                            "from",
                            "to",
                            "amount"
                          ]
                        },
                        "description": "Manual per-wallet transfers, instead of `select`. Requires `payout.kind` `classic`. Each distinct `to` becomes its own row."
                      }
                    },
                    "required": [
                      "chain",
                      "asset"
                    ],
                    "description": "Which wallets to drain and how much. Use either `select` or `transfers`, never both."
                  },
                  "payout": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "classic",
                          "cex"
                        ],
                        "description": "`classic` delivers the same asset on the same chain. `cex` goes through an exchange and can change chain and asset."
                      },
                      "chain": {
                        "type": "string",
                        "enum": [
                          "sol",
                          "bsc",
                          "eth",
                          "base",
                          "robinhood",
                          "arc",
                          "xlayer"
                        ],
                        "description": "Destination chain. Must equal `source.chain` for `classic`."
                      },
                      "asset": {
                        "type": "string",
                        "description": "Destination asset, same format as `source.asset`. Must equal `source.asset` for `classic`."
                      },
                      "address": {
                        "type": "string",
                        "description": "Destination address. Required to execute unless `source.transfers` is used; if sent with `transfers`, it must match every `to`."
                      },
                      "providers": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "`cex` only. Restricts the exchange pool."
                      },
                      "legs": {
                        "type": "integer",
                        "description": "`cex` only. Number of legs the payout is split into."
                      },
                      "delay_min_minutes": {
                        "type": "integer",
                        "description": "`cex` only. Minimum gap between two consecutive legs, in minutes.",
                        "default": "8"
                      },
                      "delay_max_minutes": {
                        "type": "integer",
                        "description": "`cex` only. Maximum gap between two consecutive legs, in minutes. At least `delay_min_minutes`.",
                        "default": "13"
                      },
                      "split_jitter_pct": {
                        "type": "integer",
                        "description": "`cex` only. Irregularity of the split percentages."
                      },
                      "per_wallet_orders": {
                        "type": "boolean",
                        "description": "`cex` only. One hop and one exchange order per source wallet."
                      }
                    },
                    "required": [
                      "kind",
                      "chain",
                      "asset"
                    ],
                    "description": "Where and how the funds are delivered."
                  }
                },
                "required": [
                  "origin",
                  "source",
                  "payout"
                ]
              },
              "example": {
                "origin": {
                  "kind": "aged"
                },
                "source": {
                  "chain": "sol",
                  "asset": "native",
                  "select": {
                    "kind": "explicit",
                    "wallets": [
                      "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                    ]
                  },
                  "mode": "withdraw_all",
                  "leave_on": [],
                  "amount": "0"
                },
                "payout": {
                  "kind": "classic",
                  "chain": "sol",
                  "asset": "native",
                  "address": "DKfba8BZznqYcPa9r2dE1oxd635exYJWuZtrefA8XyPF"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "total_src_atomic": {
                      "type": "string",
                      "description": "Maximum withdrawable in source atomic units: the cap to offer. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                    },
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "type": "string",
                            "description": "Wallet address."
                          },
                          "drainable": {
                            "type": "string",
                            "description": "Atomic units this wallet can give. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                          },
                          "included": {
                            "type": "boolean",
                            "description": "Whether the wallet takes part."
                          },
                          "reason": {
                            "type": "string",
                            "enum": [
                              "below_gas_and_leave",
                              "cap_reached",
                              "not_found",
                              "watched_no_secret",
                              "blocked_account",
                              "invalid_address",
                              "holder_status_unknown"
                            ],
                            "description": "Why the wallet is excluded."
                          },
                          "needs": {
                            "type": "string",
                            "description": "Shortfall in atomic units for the wallet to be included. Omitted when satisfied or unknown. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                          }
                        }
                      },
                      "description": "Per-wallet breakdown."
                    },
                    "plan": {
                      "type": "object",
                      "properties": {
                        "hop_count": {
                          "type": "integer",
                          "description": "`1`, or the number of distinct destinations in `transfers` mode."
                        }
                      },
                      "description": "Execution plan."
                    },
                    "estimated_duration_seconds": {
                      "type": "integer",
                      "description": "Expected time until the destination is credited, including CEX leg delays."
                    },
                    "estimated_receive_atomic": {
                      "type": "string",
                      "description": "What the destination receives net of fees, in atomic units of `payout.asset` on `payout.chain` (not the same scale as `total_src_atomic` on cross-chain routes). Absent when nothing can price the route; `\"0\"` means zero. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                    },
                    "minimum_src_atomic": {
                      "type": "string",
                      "description": "CEX only. Binding source-side order minimum, in atomic units."
                    },
                    "needs_src_atomic": {
                      "type": "string",
                      "description": "CEX only. Aggregate shortfall against the order minimum after fees, in atomic units."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "total_src_atomic": "2489000000",
                  "wallets": [
                    {
                      "address": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "drainable": "1489000000",
                      "included": true
                    },
                    {
                      "address": "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4",
                      "drainable": "1000000000",
                      "included": true
                    }
                  ],
                  "plan": {
                    "hop_count": 1
                  },
                  "estimated_duration_seconds": 20,
                  "estimated_receive_atomic": "2488985000"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `origin.kind` is `launch` but `origin.launch_ext_id` is missing. Set `origin.launch_ext_id` to the launch's external ID.\n\n`bad_request`: `source.asset` is `quote` outside a launch origin. Use a launch origin, or withdraw the native asset.\n\n`bad_request`: Both `source.select` and `source.transfers` were sent. Send only one of `source.select` and `source.transfers`.\n\n`bad_request`: Neither `source.select` nor `source.transfers` was sent. Send `source.select` or `source.transfers`.\n\n`bad_request`: `source.transfers` was sent with a `cex` payout. Set `payout.kind` to `classic`, or use `source.select`.\n\n`bad_request`: A non-zero `source.amount` was sent with `source.transfers`. Drop `source.amount` and set the amounts in `source.transfers`.\n\n`bad_request`: A transfer has an amount of 0. Give every transfer an amount above 0.\n\n`bad_request`: `payout.address` differs from the `to` of the transfers. Make `payout.address` match the transfers' `to`, or omit it.\n\n`bad_request`: `payout.delay_min_minutes` is above `payout.delay_max_minutes`. Set `payout.delay_min_minutes` no higher than `payout.delay_max_minutes`.\n\n`bad_request`: A `classic` payout changes chain or asset. Match `payout.chain` and `payout.asset` to the source, or set `payout.kind` to `cex`.\n\n`bad_request`: A `classic` payout carries CEX-only options: `legs`, `providers`, `delay_min_minutes`, `delay_max_minutes`, `split_jitter_pct` or `per_wallet_orders`. Remove those options or set `payout.kind` to `cex`.\n\n`bad_request`: `source.dust_amount_min` is above `source.dust_amount_max`. Set `source.dust_amount_min` no higher than `source.dust_amount_max`.\n\n`bad_request`: `source.leave_on` is `holders` outside a launch origin. Use a launch origin, or another `leave_on` value.\n\n`bad_request`: `source.chain` is not a chain the API serves. Use a `source.chain` value listed for this endpoint.\n\n`bad_request`: `origin.launch_ext_id` is not a valid launch external ID. Use the external ID of one of your launches.\n\n`bad_request`: `origin.launch_ext_id` is a launch on another chain than `source.chain`. Set `source.chain` to the launch's chain.\n\n`bad_request`: `origin.kind` is `global` but `source.select.kind` is not `explicit`. Set `source.select.kind` to `explicit` and list the wallets.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`origin.kind` is `launch` but `origin.launch_ext_id` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "origin.launch_ext_id required for origin.kind=launch"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`source.asset` is `quote` outside a launch origin.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.asset=quote requires origin.kind=launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Both `source.select` and `source.transfers` were sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.select and source.transfers are mutually exclusive"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Neither `source.select` nor `source.transfers` was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source requires either select or transfers"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`source.transfers` was sent with a `cex` payout.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.transfers requires payout.kind=classic"
                    }
                  },
                  "bad_request_6": {
                    "summary": "A non-zero `source.amount` was sent with `source.transfers`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.amount and source.transfers are mutually exclusive"
                    }
                  },
                  "bad_request_7": {
                    "summary": "A transfer has an amount of 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.transfers amount must be > 0"
                    }
                  },
                  "bad_request_8": {
                    "summary": "`payout.address` differs from the `to` of the transfers.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "payout.address disagrees with source.transfers[].to"
                    }
                  },
                  "bad_request_9": {
                    "summary": "`payout.delay_min_minutes` is above `payout.delay_max_minutes`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "payout.delay_min_minutes must be <= payout.delay_max_minutes"
                    }
                  },
                  "bad_request_10": {
                    "summary": "A `classic` payout changes chain or asset.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a classic payout cannot change chain or asset; use kind=cex"
                    }
                  },
                  "bad_request_11": {
                    "summary": "A `classic` payout carries CEX-only options: `legs`, `providers`, `delay_min_minutes`, `delay_max_minutes`, `split_jitter_pct` or `per_wallet_orders`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "mixing options require payout.kind=cex"
                    }
                  },
                  "bad_request_12": {
                    "summary": "`source.dust_amount_min` is above `source.dust_amount_max`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dust_amount_min must be <= dust_amount_max"
                    }
                  },
                  "bad_request_13": {
                    "summary": "`source.leave_on` is `holders` outside a launch origin.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "leave_on=holders requires origin.kind=launch"
                    }
                  },
                  "bad_request_14": {
                    "summary": "`source.chain` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown source chain: <chain>"
                    }
                  },
                  "bad_request_15": {
                    "summary": "`origin.launch_ext_id` is not a valid launch external ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid origin.launch_ext_id"
                    }
                  },
                  "bad_request_16": {
                    "summary": "`origin.launch_ext_id` is a launch on another chain than `source.chain`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "origin.launch_ext_id is a <chain> launch, but source.chain is <chain>: origin names the launch whose wallets are drained; a launch receiving the payout goes in payout.launch_ext_id"
                    }
                  },
                  "bad_request_17": {
                    "summary": "`origin.kind` is `global` but `source.select.kind` is not `explicit`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "origin.kind=global requires select.kind=explicit"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The launch in `origin.launch_ext_id` is not on the account. Use the external ID of one of your launches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The launch in `origin.launch_ext_id` is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only: nothing is created or sent."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/withdrawals/#retrieve-a-withdraw-quote"
        }
      }
    },
    "/withdraw/execute": {
      "post": {
        "operationId": "withdrawals.execute-a-withdrawal",
        "summary": "Execute a withdrawal",
        "description": "Starts a withdrawal and returns once its rows are persisted.\n\nSame body as the quote. Responds `202 Accepted` with the first row's `id` and the `group_id`; when `id` differs from `group_id`, list withdrawals and match `group_id` on the returned rows to find every row. The web app then polls [Retrieve a withdrawal](#retrieve-a-withdrawal) every second until each row is terminal.\n\nMoves funds out of your wallets. Once a classic row starts collecting it cannot be recalled.\n\nProtected by the `wallet.withdraw` 2FA action when enabled, unless every destination is one of your own funders.",
        "tags": [
          "Withdrawals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "launch",
                          "aged",
                          "global"
                        ],
                        "description": "`launch`: the wallets of a launch. `aged`: your trading wallets. `global`: any wallet of the account named explicitly (requires `source.select.kind` `explicit`), for example a funder."
                      },
                      "launch_ext_id": {
                        "type": "string",
                        "description": "Launch ID. Required when `kind` is `launch`."
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "description": "Universe of wallets the source draws from."
                  },
                  "source": {
                    "type": "object",
                    "properties": {
                      "chain": {
                        "type": "string",
                        "enum": [
                          "sol",
                          "bsc",
                          "eth",
                          "base",
                          "robinhood",
                          "arc",
                          "xlayer"
                        ],
                        "description": "Chain the funds are taken from."
                      },
                      "asset": {
                        "type": "string",
                        "description": "`native`, a token mint or contract address, or `quote` (the launch's quote token; requires `origin.kind` `launch`). Never a symbol."
                      },
                      "select": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "explicit",
                              "aged",
                              "launch_all"
                            ],
                            "description": "`explicit` lists wallets; `aged` takes the trading wallets of the origin; `launch_all` takes every wallet of the origin."
                          },
                          "wallets": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Addresses to drain. Required when `kind` is `explicit`."
                          }
                        },
                        "required": [
                          "kind"
                        ],
                        "description": "Wallet selection inside the origin."
                      },
                      "mode": {
                        "type": "string",
                        "enum": [
                          "withdraw_all",
                          "leave_on"
                        ],
                        "description": "Required with `select`. `leave_on` keeps the wallets of the roles in `leave_on` full."
                      },
                      "leave_on": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "Required with `select` (may be empty). Roles left untouched: `dev`, `aged`, `funder`, `others`, `holders` (`holders` requires `origin.kind` `launch`)."
                      },
                      "amount": {
                        "type": "string",
                        "description": "Required with `select`. Total cap in atomic units across all wallets; `\"0\"` drains everything. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                      },
                      "dust_amount": {
                        "type": "string",
                        "description": "Atomic units left behind in each wallet."
                      },
                      "dust_amount_min": {
                        "type": "string",
                        "description": "Lower bound of a random amount left behind per wallet. At most `dust_amount_max`."
                      },
                      "dust_amount_max": {
                        "type": "string",
                        "description": "Upper bound of a random amount left behind per wallet."
                      },
                      "transfers": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "from": {
                              "type": "string",
                              "description": "Source wallet."
                            },
                            "to": {
                              "type": "string",
                              "description": "Destination address."
                            },
                            "amount": {
                              "type": "string",
                              "description": "Atomic-unit cap for this transfer, greater than 0. Preserved as a string by the client because atomic amounts can exceed the JavaScript safe integer range."
                            }
                          },
                          "required": [
                            "from",
                            "to",
                            "amount"
                          ]
                        },
                        "description": "Manual per-wallet transfers, instead of `select`. Requires `payout.kind` `classic`. Each distinct `to` becomes its own row."
                      }
                    },
                    "required": [
                      "chain",
                      "asset"
                    ],
                    "description": "Which wallets to drain and how much. Use either `select` or `transfers`, never both."
                  },
                  "payout": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "classic",
                          "cex"
                        ],
                        "description": "`classic` delivers the same asset on the same chain. `cex` goes through an exchange and can change chain and asset."
                      },
                      "chain": {
                        "type": "string",
                        "enum": [
                          "sol",
                          "bsc",
                          "eth",
                          "base",
                          "robinhood",
                          "arc",
                          "xlayer"
                        ],
                        "description": "Destination chain. Must equal `source.chain` for `classic`."
                      },
                      "asset": {
                        "type": "string",
                        "description": "Destination asset, same format as `source.asset`. Must equal `source.asset` for `classic`."
                      },
                      "address": {
                        "type": "string",
                        "description": "Destination address. Required to execute unless `source.transfers` is used; if sent with `transfers`, it must match every `to`."
                      },
                      "providers": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        },
                        "description": "`cex` only. Restricts the exchange pool."
                      },
                      "legs": {
                        "type": "integer",
                        "description": "`cex` only. Number of legs the payout is split into."
                      },
                      "delay_min_minutes": {
                        "type": "integer",
                        "description": "`cex` only. Minimum gap between two consecutive legs, in minutes.",
                        "default": "8"
                      },
                      "delay_max_minutes": {
                        "type": "integer",
                        "description": "`cex` only. Maximum gap between two consecutive legs, in minutes. At least `delay_min_minutes`.",
                        "default": "13"
                      },
                      "split_jitter_pct": {
                        "type": "integer",
                        "description": "`cex` only. Irregularity of the split percentages."
                      },
                      "per_wallet_orders": {
                        "type": "boolean",
                        "description": "`cex` only. One hop and one exchange order per source wallet."
                      }
                    },
                    "required": [
                      "kind",
                      "chain",
                      "asset"
                    ],
                    "description": "Where and how the funds are delivered."
                  }
                },
                "required": [
                  "origin",
                  "source",
                  "payout"
                ]
              },
              "example": {
                "origin": {
                  "kind": "aged"
                },
                "source": {
                  "chain": "sol",
                  "asset": "native",
                  "select": {
                    "kind": "explicit",
                    "wallets": [
                      "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4"
                    ]
                  },
                  "mode": "withdraw_all",
                  "leave_on": [],
                  "amount": "0"
                },
                "payout": {
                  "kind": "cex",
                  "chain": "bsc",
                  "asset": "native",
                  "address": "0x24667d03fe6130c45584ed9985167d254fc6ab2f",
                  "legs": 3,
                  "delay_min_minutes": 8,
                  "delay_max_minutes": 13
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Accepted",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "id": {
                      "type": "string",
                      "description": "ID of the first row accepted for background execution."
                    },
                    "group_id": {
                      "type": "string",
                      "description": "Shared by every row created from this request."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "id": "cc0799f5-ab8b-4bcc-83b9-805a99315190",
                  "group_id": "cc0799f5-ab8b-4bcc-83b9-805a99315190"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `origin.kind` is `launch` but `origin.launch_ext_id` is missing. Set `origin.launch_ext_id` to the launch's external ID.\n\n`bad_request`: `source.asset` is `quote` outside a launch origin. Use a launch origin, or withdraw the native asset.\n\n`bad_request`: Both `source.select` and `source.transfers` were sent. Send only one of `source.select` and `source.transfers`.\n\n`bad_request`: Neither `source.select` nor `source.transfers` was sent. Send `source.select` or `source.transfers`.\n\n`bad_request`: `source.transfers` was sent with a `cex` payout. Set `payout.kind` to `classic`, or use `source.select`.\n\n`bad_request`: A non-zero `source.amount` was sent with `source.transfers`. Drop `source.amount` and set the amounts in `source.transfers`.\n\n`bad_request`: A transfer has an amount of 0. Give every transfer an amount above 0.\n\n`bad_request`: `payout.address` differs from the `to` of the transfers. Make `payout.address` match the transfers' `to`, or omit it.\n\n`bad_request`: `payout.delay_min_minutes` is above `payout.delay_max_minutes`. Set `payout.delay_min_minutes` no higher than `payout.delay_max_minutes`.\n\n`bad_request`: A `classic` payout changes chain or asset. Match `payout.chain` and `payout.asset` to the source, or set `payout.kind` to `cex`.\n\n`bad_request`: A `classic` payout carries CEX-only options: `legs`, `providers`, `delay_min_minutes`, `delay_max_minutes`, `split_jitter_pct` or `per_wallet_orders`. Remove those options or set `payout.kind` to `cex`.\n\n`bad_request`: `source.dust_amount_min` is above `source.dust_amount_max`. Set `source.dust_amount_min` no higher than `source.dust_amount_max`.\n\n`bad_request`: `source.leave_on` is `holders` outside a launch origin. Use a launch origin, or another `leave_on` value.\n\n`bad_request`: `payout.address` is missing. Set `payout.address` to the destination.\n\n`bad_request`: `payout.chain` is not a chain the API serves. Use a `payout.chain` value listed for this endpoint.\n\n`bad_request`: `payout.address` is not a valid address of `payout.chain`. Send a valid address of the payout chain.\n\n`bad_request`: On Solana, the destination is a token mint; sending SOL there would burn it. Use a regular wallet address.\n\n`bad_request`: On EVM chains, the destination is a token contract; sending native there would burn it. Use a regular wallet address.\n\n`bad_request`: On EVM chains, the destination is a contract that refuses native transfers. Use a regular wallet address.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`origin.kind` is `launch` but `origin.launch_ext_id` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "origin.launch_ext_id required for origin.kind=launch"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`source.asset` is `quote` outside a launch origin.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.asset=quote requires origin.kind=launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Both `source.select` and `source.transfers` were sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.select and source.transfers are mutually exclusive"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Neither `source.select` nor `source.transfers` was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source requires either select or transfers"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`source.transfers` was sent with a `cex` payout.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.transfers requires payout.kind=classic"
                    }
                  },
                  "bad_request_6": {
                    "summary": "A non-zero `source.amount` was sent with `source.transfers`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.amount and source.transfers are mutually exclusive"
                    }
                  },
                  "bad_request_7": {
                    "summary": "A transfer has an amount of 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source.transfers amount must be > 0"
                    }
                  },
                  "bad_request_8": {
                    "summary": "`payout.address` differs from the `to` of the transfers.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "payout.address disagrees with source.transfers[].to"
                    }
                  },
                  "bad_request_9": {
                    "summary": "`payout.delay_min_minutes` is above `payout.delay_max_minutes`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "payout.delay_min_minutes must be <= payout.delay_max_minutes"
                    }
                  },
                  "bad_request_10": {
                    "summary": "A `classic` payout changes chain or asset.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a classic payout cannot change chain or asset; use kind=cex"
                    }
                  },
                  "bad_request_11": {
                    "summary": "A `classic` payout carries CEX-only options: `legs`, `providers`, `delay_min_minutes`, `delay_max_minutes`, `split_jitter_pct` or `per_wallet_orders`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "mixing options require payout.kind=cex"
                    }
                  },
                  "bad_request_12": {
                    "summary": "`source.dust_amount_min` is above `source.dust_amount_max`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dust_amount_min must be <= dust_amount_max"
                    }
                  },
                  "bad_request_13": {
                    "summary": "`source.leave_on` is `holders` outside a launch origin.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "leave_on=holders requires origin.kind=launch"
                    }
                  },
                  "bad_request_14": {
                    "summary": "`payout.address` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "payout.address is required"
                    }
                  },
                  "bad_request_15": {
                    "summary": "`payout.chain` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain: <chain>"
                    }
                  },
                  "bad_request_16": {
                    "summary": "`payout.address` is not a valid address of `payout.chain`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid payout address"
                    }
                  },
                  "bad_request_17": {
                    "summary": "On Solana, the destination is a token mint; sending SOL there would burn it.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "recipient <address> is a token mint — withdrawing SOL there would burn it. Use a regular wallet address instead."
                    }
                  },
                  "bad_request_18": {
                    "summary": "On EVM chains, the destination is a token contract; sending native there would burn it.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "recipient <address> is a token contract — withdrawing native there would burn it. Use a regular wallet address instead."
                    }
                  },
                  "bad_request_19": {
                    "summary": "On EVM chains, the destination is a contract that refuses native transfers.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "recipient <address> refuses a native transfer (<reason>) — it is a contract with no payable receive. Use a regular wallet address instead."
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The destination check could not read the address from the RPC. Retry after a short wait.\n\n`unprocessable`: The launch in `origin.launch_ext_id` is not on the account. Returned as a 422 here, as a 404 by the quote. Use the external ID of one of your launches.\n\n`unprocessable`: `origin.launch_ext_id` is not a valid launch external ID. Returned as a 422 here, as a 400 by the quote. Use the external ID of one of your launches.\n\n`unprocessable`: `origin.launch_ext_id` is a launch on another chain than `source.chain`. Returned as a 422 here, as a 400 by the quote. Set `source.chain` to the launch's chain.\n\n`unprocessable`: `origin.kind` is `global` but `source.select.kind` is not `explicit`. Returned as a 422 here, as a 400 by the quote. Set `source.select.kind` to `explicit` and list the wallets.\n\n`unprocessable`: None of the selected wallets can be withdrawn from, for example because each is empty or already claimed by a live withdrawal. Check the `wallets` verdicts in [Retrieve a withdraw quote](/reference/withdrawals/#retrieve-a-withdraw-quote).\n\n`unprocessable`: A live withdrawal is already draining these wallets. Wait for it to settle; follow it in [List withdrawals](/reference/withdrawals/#list-withdrawals).\n\n`unprocessable`: The withdrawal would go through lane, which cannot carry a CEX deposit yet. Nothing was sent. Use a `classic` payout, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The destination check could not read the address from the RPC.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: recipient check failed: <error>"
                    }
                  },
                  "unprocessable": {
                    "summary": "The launch in `origin.launch_ext_id` is not on the account. Returned as a 422 here, as a 404 by the quote.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "launch not found"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "`origin.launch_ext_id` is not a valid launch external ID. Returned as a 422 here, as a 400 by the quote.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "invalid origin.launch_ext_id"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "`origin.launch_ext_id` is a launch on another chain than `source.chain`. Returned as a 422 here, as a 400 by the quote.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "origin.launch_ext_id is a <chain> launch, but source.chain is <chain>: origin names the launch whose wallets are drained; a launch receiving the payout goes in payout.launch_ext_id"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "`origin.kind` is `global` but `source.select.kind` is not `explicit`. Returned as a 422 here, as a 400 by the quote.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "origin.kind=global requires select.kind=explicit"
                    }
                  },
                  "unprocessable_5": {
                    "summary": "None of the selected wallets can be withdrawn from, for example because each is empty or already claimed by a live withdrawal.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "no source wallet eligible for withdrawal"
                    }
                  },
                  "unprocessable_6": {
                    "summary": "A live withdrawal is already draining these wallets.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "already withdrawing from <addresses>"
                    }
                  },
                  "unprocessable_7": {
                    "summary": "The withdrawal would go through lane, which cannot carry a CEX deposit yet. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this withdrawal cannot go through lane: a cex deposit is not one of its legs yet. Nothing was sent"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "wallet.withdraw",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat while the first withdrawal is live is refused, but once it settles a repeat withdraws again. Before retrying, call [List withdrawals](/reference/withdrawals/#list-withdrawals) and look for recent rows with the same origin and destination; there is no `group_id` filter, so match `group_id` on the returned rows."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/withdrawals/#execute-a-withdrawal"
        }
      }
    },
    "/withdraw/{withdrawal_id}": {
      "get": {
        "operationId": "withdrawals.retrieve-a-withdrawal",
        "summary": "Retrieve a withdrawal",
        "description": "Returns one withdrawal row with its status, hop, collected legs and payout transaction.",
        "tags": [
          "Withdrawals"
        ],
        "parameters": [
          {
            "name": "withdrawal_id",
            "in": "path",
            "required": true,
            "description": "ID of the withdrawal row.",
            "schema": {
              "type": "string"
            },
            "example": "684b1e4f-decd-437b-babf-4384eebb8b10"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a [Withdrawal](#object-withdrawal) object.",
            "content": {
              "application/json": {
                "example": {
                  "id": "684b1e4f-decd-437b-babf-4384eebb8b10",
                  "group_id": "684b1e4f-decd-437b-babf-4384eebb8b10",
                  "status": "completed",
                  "origin": {
                    "kind": "aged"
                  },
                  "src": {
                    "chain": "sol",
                    "asset": "native"
                  },
                  "dst": {
                    "chain": "sol",
                    "asset": "native",
                    "address": "DKfba8BZznqYcPa9r2dE1oxd635exYJWuZtrefA8XyPF"
                  },
                  "payout_kind": "classic",
                  "collected": [
                    {
                      "address": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "amount": "1489000000",
                      "tx": "4UAUY1zva1Wg1a2mBXkZLkjukpMhbSe3X43BpNL6UP9AuzGhwLh2PnsY11H3JJMjuZswyk9zA2CKiw3Lip4hTGbL"
                    },
                    {
                      "address": "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4",
                      "amount": "1000000000",
                      "tx": "5K1g9bQMqoMvVUgSD92K9PUDSwmNuCpzQDU6DiEj9iBuYVDeph7qEmxrsodWFSguTfgUrZhhcZG7K3jMeSwHC2up"
                    }
                  ],
                  "hop": {
                    "address": "AqaW1YghutnQEhjycn8m26Rr4RzZuZAoaNYsFjRP5NDp",
                    "landed": "2489000000"
                  },
                  "payout": {
                    "tx": "QhdKjiybHRzvb1Z815uLe9gXfNFkWk4iXBh6sdT3YHL6pV3ohS2ZUXsXA6sDf4jS5Lwf631zbaUYeZQUCwQajkYo"
                  },
                  "created_at": 1793560000,
                  "started_at": 1793560001,
                  "finished_at": 1793560019
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No withdrawal with this ID on the account. Use an `id` from [List withdrawals](/reference/withdrawals/#list-withdrawals).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No withdrawal with this ID on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "withdraw not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/withdrawals/#retrieve-a-withdrawal"
        }
      }
    },
    "/withdraw": {
      "get": {
        "operationId": "withdrawals.list-withdrawals",
        "summary": "List withdrawals",
        "description": "Returns the account's withdrawal rows, most recent first, with optional filters.\n\nThe web app uses it for the withdraw history and to resolve every row of an execute request.",
        "tags": [
          "Withdrawals"
        ],
        "parameters": [
          {
            "name": "origin_kind",
            "in": "query",
            "required": false,
            "description": "Only rows with this origin.",
            "schema": {
              "type": "string",
              "enum": [
                "launch",
                "aged",
                "global"
              ]
            }
          },
          {
            "name": "launch_ext_id",
            "in": "query",
            "required": false,
            "description": "Only rows of this launch. An unknown launch returns an empty list.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Only rows on this chain.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "bsc",
                "eth",
                "base",
                "robinhood",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Only rows in this status.",
            "schema": {
              "type": "string",
              "enum": [
                "draft",
                "collecting",
                "hop_funded",
                "paying",
                "settling",
                "completed",
                "failed",
                "cancelled"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of rows, from 1 to 200. The client clamps it to that range.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Withdrawal](#object-withdrawal) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "withdrawals": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Withdrawal rows."
                    }
                  }
                },
                "example": {
                  "withdrawals": [
                    {
                      "id": "684b1e4f-decd-437b-babf-4384eebb8b10",
                      "group_id": "684b1e4f-decd-437b-babf-4384eebb8b10",
                      "status": "completed",
                      "origin": {
                        "kind": "aged"
                      },
                      "src": {
                        "chain": "sol",
                        "asset": "native"
                      },
                      "dst": {
                        "chain": "sol",
                        "asset": "native",
                        "address": "DKfba8BZznqYcPa9r2dE1oxd635exYJWuZtrefA8XyPF"
                      },
                      "payout_kind": "classic",
                      "collected": [
                        {
                          "address": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                          "amount": "1489000000",
                          "tx": "4UAUY1zva1Wg1a2mBXkZLkjukpMhbSe3X43BpNL6UP9AuzGhwLh2PnsY11H3JJMjuZswyk9zA2CKiw3Lip4hTGbL"
                        },
                        {
                          "address": "ART7zvRihsxp6iuCegVRED44XZMov9u6fnFJHF7HqcN4",
                          "amount": "1000000000",
                          "tx": "5K1g9bQMqoMvVUgSD92K9PUDSwmNuCpzQDU6DiEj9iBuYVDeph7qEmxrsodWFSguTfgUrZhhcZG7K3jMeSwHC2up"
                        }
                      ],
                      "hop": {
                        "address": "AqaW1YghutnQEhjycn8m26Rr4RzZuZAoaNYsFjRP5NDp",
                        "landed": "2489000000"
                      },
                      "payout": {
                        "tx": "QhdKjiybHRzvb1Z815uLe9gXfNFkWk4iXBh6sdT3YHL6pV3ohS2ZUXsXA6sDf4jS5Lwf631zbaUYeZQUCwQajkYo"
                      },
                      "created_at": 1793560000,
                      "started_at": 1793560001,
                      "finished_at": 1793560019
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `origin_kind` is not a known value. Use an `origin_kind` value listed for this endpoint.\n\n`bad_request`: `status` is not a known value. Use a `status` value listed for this endpoint.\n\n`bad_request`: `chain` is not a chain the API serves. Use a `chain` value listed for this endpoint.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`origin_kind` is not a known value.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown origin_kind: <origin_kind>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`status` is not a known value.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown status: <status>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`chain` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain: <chain>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/withdrawals/#list-withdrawals"
        }
      }
    },
    "/withdraw/cancel/{withdrawal_id}": {
      "post": {
        "operationId": "withdrawals.cancel-a-withdrawal",
        "summary": "Cancel a withdrawal",
        "description": "Cancels a withdrawal row that is still a draft.\n\nNo request body. Only a `draft` row is reversible; a classic row is created directly in `collecting`.",
        "tags": [
          "Withdrawals"
        ],
        "parameters": [
          {
            "name": "withdrawal_id",
            "in": "path",
            "required": true,
            "description": "ID of the withdrawal row.",
            "schema": {
              "type": "string"
            },
            "example": "4f9d94e0-65d2-4c21-8e36-963fe5159068"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the row was cancelled."
                    },
                    "id": {
                      "type": "string",
                      "description": "ID of the row."
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "draft",
                        "collecting",
                        "hop_funded",
                        "paying",
                        "settling",
                        "completed",
                        "failed",
                        "cancelled"
                      ],
                      "description": "New status: `cancelled`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable result."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "id": "4f9d94e0-65d2-4c21-8e36-963fe5159068",
                  "status": "cancelled"
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No withdrawal with this ID on the account. Use an `id` from [List withdrawals](/reference/withdrawals/#list-withdrawals).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No withdrawal with this ID on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "withdraw not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The row is past `draft`: funds may be in flight or settled and cannot be recalled. Follow the row with [Retrieve a withdrawal](/reference/withdrawals/#retrieve-a-withdrawal) until it settles.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The row is past `draft`: funds may be in flight or settled and cannot be recalled.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "withdraw <id> is already <status>: funds may be in flight or already settled, a cancel cannot recall them"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat after a successful cancel returns 409 because the row is already `cancelled`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/withdrawals/#cancel-a-withdrawal"
        }
      }
    },
    "/activity/presets": {
      "get": {
        "operationId": "wallet-activity.retrieve-activity-presets",
        "summary": "Retrieve activity presets",
        "description": "Returns the chains a farm can run on and the request limits.\n\nThe web app loads it when the Generate Activity modal opens and shows an error state if it fails.",
        "tags": [
          "Wallet activity"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "chains": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Chain IDs a farm can run on."
                    },
                    "limits": {
                      "type": "object",
                      "properties": {
                        "max_duration_days": {
                          "type": "integer",
                          "description": "Longest duration in days."
                        },
                        "max_duration_hours": {
                          "type": "integer",
                          "description": "Longest duration in hours."
                        },
                        "max_tx_per_day": {
                          "type": "integer",
                          "description": "Highest `tx_per_day_max`."
                        },
                        "max_wallets_per_request": {
                          "type": "integer",
                          "description": "Most wallets per run."
                        }
                      },
                      "description": "Request limits."
                    }
                  }
                },
                "example": {
                  "chains": [
                    "sol",
                    "eth",
                    "bsc",
                    "base"
                  ],
                  "limits": {
                    "max_duration_days": 30,
                    "max_duration_hours": 720,
                    "max_tx_per_day": 50,
                    "max_wallets_per_request": 200
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. Retry after a short wait; the failure is on the farming service's side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-activity/#retrieve-activity-presets"
        }
      }
    },
    "/activity/estimate": {
      "post": {
        "operationId": "wallet-activity.estimate-an-activity-plan",
        "summary": "Estimate an activity plan",
        "description": "Returns per-wallet feasibility, planned volume and cost for a plan without enrolling anything.\n\nTakes the same body as [Run an activity plan](#run-an-activity-plan). The web app calls it debounced while the plan is edited.",
        "tags": [
          "Wallet activity"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets of the account to farm, SVM and EVM mixed. At most `limits.max_wallets_per_request`."
                  },
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Chain IDs to farm on, from the presets."
                  },
                  "tier": {
                    "type": "string",
                    "description": "Tier passed to the farming service. Not set by the web app."
                  },
                  "tx_per_day_min": {
                    "type": "integer",
                    "description": "Minimum transactions per day per wallet, at least 1."
                  },
                  "tx_per_day_max": {
                    "type": "integer",
                    "description": "Maximum transactions per day per wallet, at least `tx_per_day_min` and at most `limits.max_tx_per_day`."
                  },
                  "duration_hours": {
                    "type": "integer",
                    "description": "Farm duration in hours. Send this or `duration_days`."
                  },
                  "duration_days": {
                    "type": "integer",
                    "description": "Farm duration in days. Send this or `duration_hours`."
                  },
                  "volume_target": {
                    "type": "object",
                    "description": "Target volume per chain ID, in native base units as positive decimal strings. Every key must be in `chains`."
                  },
                  "budgets": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "object",
                      "properties": {
                        "min_native": {
                          "type": "string",
                          "description": "Minimum, in native base units."
                        },
                        "max_native": {
                          "type": "string",
                          "description": "Maximum, in native base units. At least `min_native`."
                        }
                      },
                      "description": "Spend limits on one chain, keyed by chain ID."
                    },
                    "x-proxima-key": "chain_id",
                    "description": "Spend limits per chain ID, in native base units. A wallet takes the budget of its home chain only: `sol` for a Solana wallet, the first EVM chain in `chains` for an EVM wallet. A budget on another EVM chain is accepted but not applied. Every key must be in `chains`."
                  },
                  "budget_compound": {
                    "type": "boolean",
                    "description": "Passed to the farming service. Not set by the web app."
                  },
                  "token_mints": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Token addresses passed to the farming service. Not set by the web app."
                  },
                  "token_inherit_default": {
                    "type": "boolean",
                    "description": "Passed to the farming service. Not set by the web app."
                  }
                },
                "required": [
                  "wallets",
                  "chains",
                  "tx_per_day_min",
                  "tx_per_day_max"
                ]
              },
              "example": {
                "wallets": [
                  "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                  "0xa5fbbe950f155ca0ed4a15d1001c98ed78c19cf3"
                ],
                "chains": [
                  "sol",
                  "base"
                ],
                "tx_per_day_min": 4,
                "tx_per_day_max": 12,
                "duration_days": 7,
                "volume_target": {
                  "sol": "50000000000",
                  "base": "2000000000000000000"
                },
                "budgets": {
                  "sol": {
                    "max_native": "1500000000"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "feasible": {
                      "type": "boolean",
                      "description": "Whether the whole plan can run."
                    },
                    "continuous": {
                      "type": "boolean",
                      "description": "Whether the farm runs continuously."
                    },
                    "duration_secs": {
                      "type": "integer",
                      "description": "Planned duration in seconds."
                    },
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "type": "string",
                            "description": "Wallet address."
                          },
                          "feasible": {
                            "type": "boolean",
                            "description": "Whether this wallet can run the plan."
                          },
                          "reasons": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "code": {
                                  "type": "string",
                                  "description": "Machine-readable reason."
                                },
                                "message": {
                                  "type": "string",
                                  "description": "Human-readable reason."
                                }
                              }
                            },
                            "description": "Why the wallet is not feasible."
                          },
                          "chains": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "chain": {
                                  "type": "string",
                                  "description": "Chain ID."
                                },
                                "balance": {
                                  "type": "string",
                                  "description": "Current native balance."
                                },
                                "spendable": {
                                  "type": "string",
                                  "description": "Balance the farm may use."
                                },
                                "buy_size": {
                                  "type": "string",
                                  "description": "Planned size of each buy."
                                },
                                "planned_txs": {
                                  "type": "integer",
                                  "description": "Planned transactions."
                                },
                                "planned_buys": {
                                  "type": "integer",
                                  "description": "Planned buys."
                                },
                                "volume": {
                                  "type": "string",
                                  "description": "Planned volume."
                                },
                                "volume_usd": {
                                  "type": "number",
                                  "description": "Planned volume, in USD."
                                },
                                "fees": {
                                  "type": "string",
                                  "description": "Expected fees."
                                },
                                "swap_loss": {
                                  "type": "string",
                                  "description": "Expected swap loss."
                                },
                                "cost": {
                                  "type": "string",
                                  "description": "Expected total cost."
                                },
                                "cost_usd": {
                                  "type": "number",
                                  "description": "Expected total cost, in USD."
                                }
                              }
                            },
                            "description": "Estimate per chain. Native amounts are base-unit decimal strings."
                          }
                        }
                      },
                      "description": "Per-wallet estimate."
                    }
                  }
                },
                "example": {
                  "feasible": true,
                  "continuous": false,
                  "duration_secs": 604800,
                  "wallets": [
                    {
                      "address": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "feasible": true,
                      "reasons": [],
                      "chains": [
                        {
                          "chain": "sol",
                          "balance": "1500000000",
                          "spendable": "1450000000",
                          "buy_size": "480000000",
                          "planned_txs": 56,
                          "planned_buys": 28,
                          "volume": "26880000000",
                          "volume_usd": 4838.4,
                          "fees": "22680000",
                          "swap_loss": "241920000",
                          "cost": "264600000",
                          "cost_usd": 47.63
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: `chains` is empty. Send at least one chain.\n\n`bad_request`: A key of `chains`, `budgets` or `volume_target` is not a chain the API serves. Use chain IDs listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets); `monad` is no longer accepted.\n\n`unsupported_chain`: A key of `chains`, `budgets` or `volume_target` is `xlayer`, which cannot be farmed. The body adds `chain`. Farm only chains listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets).\n\n`bad_request`: `tx_per_day_min` is 0 or above `tx_per_day_max`. Keep `tx_per_day_min` between 1 and `tx_per_day_max`.\n\n`bad_request`: Neither `duration_hours` nor `duration_days` was sent. Send `duration_hours` or `duration_days`.\n\n`bad_request`: `duration_hours` or `duration_days` is 0. Send a duration of at least 1.\n\n`bad_request`: A `budgets` key is not in `chains`. Key `budgets` only by chains listed in `chains`.\n\n`bad_request`: A budget's `min_native` is above its `max_native`. Set `min_native` no higher than `max_native`.\n\n`bad_request`: A `volume_target` key is not in `chains`. Key `volume_target` only by chains listed in `chains`.\n\n`bad_request`: A `volume_target` value is neither a string nor a number. Send each target as a decimal string of base units.\n\n`bad_request`: A `volume_target` value is 0 or not a whole number of base units. Send each target as a positive whole number of base units.\n\n`bad_request`: `wallets` is empty or holds only blank strings. Send at least one wallet.\n\n`bad_request`: More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting. Send at most 200 wallets per call.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`chains` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "chains is empty"
                    }
                  },
                  "bad_request_3": {
                    "summary": "A key of `chains`, `budgets` or `volume_target` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain: <chain>"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "A key of `chains`, `budgets` or `volume_target` is `xlayer`, which cannot be farmed. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`tx_per_day_min` is 0 or above `tx_per_day_max`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "tx_per_day_min must be between 1 and tx_per_day_max"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Neither `duration_hours` nor `duration_days` was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "duration_hours or duration_days is required"
                    }
                  },
                  "bad_request_6": {
                    "summary": "`duration_hours` or `duration_days` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "duration must be at least 1"
                    }
                  },
                  "bad_request_7": {
                    "summary": "A `budgets` key is not in `chains`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "budgets names <chain>, which is not farmed"
                    }
                  },
                  "bad_request_8": {
                    "summary": "A budget's `min_native` is above its `max_native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "budgets.<chain>: min_native must not exceed max_native"
                    }
                  },
                  "bad_request_9": {
                    "summary": "A `volume_target` key is not in `chains`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "volume_target names <chain>, which is not farmed"
                    }
                  },
                  "bad_request_10": {
                    "summary": "A `volume_target` value is neither a string nor a number.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "volume_target.<chain> must be a decimal string"
                    }
                  },
                  "bad_request_11": {
                    "summary": "A `volume_target` value is 0 or not a whole number of base units.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "volume_target.<chain> must be a positive integer in base units"
                    }
                  },
                  "bad_request_12": {
                    "summary": "`wallets` is empty or holds only blank strings.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallets is empty"
                    }
                  },
                  "bad_request_13": {
                    "summary": "More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 200 wallets per request"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: A wallet is not on the account. The whole request is refused. Use wallets from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "A wallet is not on the account. The whole request is refused.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "wallet <address> is not on this license"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. Retry after a short wait; the failure is on the farming service's side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only: nothing is started."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-activity/#estimate-an-activity-plan"
        }
      }
    },
    "/activity/run": {
      "post": {
        "operationId": "wallet-activity.run-an-activity-plan",
        "summary": "Run an activity plan",
        "description": "Enrolls wallets in a farm according to a plan.\n\nWallets that cannot be enrolled are returned in `skipped`. The web app refreshes the farm list after the call.\n\nEach wallet's private key is sent to the Hushxima farming service, which then trades with the wallet's funds until the farm ends or is stopped.",
        "tags": [
          "Wallet activity"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets of the account to farm, SVM and EVM mixed. At most `limits.max_wallets_per_request`."
                  },
                  "chains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Chain IDs to farm on, from the presets."
                  },
                  "tier": {
                    "type": "string",
                    "description": "Tier passed to the farming service. Not set by the web app."
                  },
                  "tx_per_day_min": {
                    "type": "integer",
                    "description": "Minimum transactions per day per wallet, at least 1."
                  },
                  "tx_per_day_max": {
                    "type": "integer",
                    "description": "Maximum transactions per day per wallet, at least `tx_per_day_min` and at most `limits.max_tx_per_day`."
                  },
                  "duration_hours": {
                    "type": "integer",
                    "description": "Farm duration in hours. Send this or `duration_days`."
                  },
                  "duration_days": {
                    "type": "integer",
                    "description": "Farm duration in days. Send this or `duration_hours`."
                  },
                  "volume_target": {
                    "type": "object",
                    "description": "Target volume per chain ID, in native base units as positive decimal strings. Every key must be in `chains`."
                  },
                  "budgets": {
                    "type": "object",
                    "additionalProperties": {
                      "type": "object",
                      "properties": {
                        "min_native": {
                          "type": "string",
                          "description": "Minimum, in native base units."
                        },
                        "max_native": {
                          "type": "string",
                          "description": "Maximum, in native base units. At least `min_native`."
                        }
                      },
                      "description": "Spend limits on one chain, keyed by chain ID."
                    },
                    "x-proxima-key": "chain_id",
                    "description": "Spend limits per chain ID, in native base units. A wallet takes the budget of its home chain only: `sol` for a Solana wallet, the first EVM chain in `chains` for an EVM wallet. A budget on another EVM chain is accepted but not applied. Every key must be in `chains`."
                  },
                  "budget_compound": {
                    "type": "boolean",
                    "description": "Passed to the farming service. Not set by the web app."
                  },
                  "token_mints": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Token addresses passed to the farming service. Not set by the web app."
                  },
                  "token_inherit_default": {
                    "type": "boolean",
                    "description": "Passed to the farming service. Not set by the web app."
                  }
                },
                "required": [
                  "wallets",
                  "chains",
                  "tx_per_day_min",
                  "tx_per_day_max"
                ]
              },
              "example": {
                "wallets": [
                  "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                  "0xa5fbbe950f155ca0ed4a15d1001c98ed78c19cf3"
                ],
                "chains": [
                  "sol",
                  "base"
                ],
                "tx_per_day_min": 4,
                "tx_per_day_max": 12,
                "duration_days": 7,
                "volume_target": {
                  "sol": "50000000000",
                  "base": "2000000000000000000"
                },
                "budgets": {
                  "sol": {
                    "max_native": "1500000000"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "enrolled": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pubkey": {
                            "type": "string",
                            "description": "Wallet address."
                          },
                          "chains": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Chain IDs farmed."
                          },
                          "ends_at": {
                            "type": "string",
                            "description": "ISO 8601 scheduled end time."
                          },
                          "tx_per_day": {
                            "type": "integer",
                            "description": "Transactions per day drawn for this wallet."
                          },
                          "budgets": {
                            "type": "object",
                            "description": "Spend limit per chain ID, in native base units. A chain left out has no limit."
                          },
                          "purchased": {
                            "type": "boolean",
                            "description": "Purchase flag reported by the farming service."
                          },
                          "reenrolled": {
                            "type": "boolean",
                            "description": "Whether the wallet was enrolled again rather than for the first time."
                          }
                        }
                      },
                      "description": "Wallets enrolled."
                    },
                    "skipped": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "reference": {
                            "type": "string",
                            "description": "Wallet address or reference skipped."
                          },
                          "reason": {
                            "type": "string",
                            "description": "Why it was skipped."
                          }
                        }
                      },
                      "description": "Wallets not enrolled."
                    }
                  }
                },
                "example": {
                  "enrolled": [
                    {
                      "pubkey": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                      "chains": [
                        "sol"
                      ],
                      "ends_at": "2026-11-09T14:00:00Z",
                      "tx_per_day": 9,
                      "budgets": {
                        "sol": "1500000000"
                      },
                      "purchased": true,
                      "reenrolled": false
                    },
                    {
                      "pubkey": "0xa5fbbe950f155ca0ed4a15d1001c98ed78c19cf3",
                      "chains": [
                        "base"
                      ],
                      "ends_at": "2026-11-09T14:00:00Z",
                      "tx_per_day": 6,
                      "purchased": true,
                      "reenrolled": false
                    }
                  ],
                  "skipped": []
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: `chains` is empty. Send at least one chain.\n\n`bad_request`: A key of `chains`, `budgets` or `volume_target` is not a chain the API serves. Use chain IDs listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets); `monad` is no longer accepted.\n\n`unsupported_chain`: A key of `chains`, `budgets` or `volume_target` is `xlayer`, which cannot be farmed. The body adds `chain`. Farm only chains listed by [Retrieve activity presets](/reference/wallet-activity/#retrieve-activity-presets).\n\n`bad_request`: `tx_per_day_min` is 0 or above `tx_per_day_max`. Keep `tx_per_day_min` between 1 and `tx_per_day_max`.\n\n`bad_request`: Neither `duration_hours` nor `duration_days` was sent. Send `duration_hours` or `duration_days`.\n\n`bad_request`: `duration_hours` or `duration_days` is 0. Send a duration of at least 1.\n\n`bad_request`: A `budgets` key is not in `chains`. Key `budgets` only by chains listed in `chains`.\n\n`bad_request`: A budget's `min_native` is above its `max_native`. Set `min_native` no higher than `max_native`.\n\n`bad_request`: A `volume_target` key is not in `chains`. Key `volume_target` only by chains listed in `chains`.\n\n`bad_request`: A `volume_target` value is neither a string nor a number. Send each target as a decimal string of base units.\n\n`bad_request`: A `volume_target` value is 0 or not a whole number of base units. Send each target as a positive whole number of base units.\n\n`bad_request`: `wallets` is empty or holds only blank strings. Send at least one wallet.\n\n`bad_request`: More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting. Send at most 200 wallets per call.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`chains` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "chains is empty"
                    }
                  },
                  "bad_request_3": {
                    "summary": "A key of `chains`, `budgets` or `volume_target` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain: <chain>"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "A key of `chains`, `budgets` or `volume_target` is `xlayer`, which cannot be farmed. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`tx_per_day_min` is 0 or above `tx_per_day_max`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "tx_per_day_min must be between 1 and tx_per_day_max"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Neither `duration_hours` nor `duration_days` was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "duration_hours or duration_days is required"
                    }
                  },
                  "bad_request_6": {
                    "summary": "`duration_hours` or `duration_days` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "duration must be at least 1"
                    }
                  },
                  "bad_request_7": {
                    "summary": "A `budgets` key is not in `chains`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "budgets names <chain>, which is not farmed"
                    }
                  },
                  "bad_request_8": {
                    "summary": "A budget's `min_native` is above its `max_native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "budgets.<chain>: min_native must not exceed max_native"
                    }
                  },
                  "bad_request_9": {
                    "summary": "A `volume_target` key is not in `chains`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "volume_target names <chain>, which is not farmed"
                    }
                  },
                  "bad_request_10": {
                    "summary": "A `volume_target` value is neither a string nor a number.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "volume_target.<chain> must be a decimal string"
                    }
                  },
                  "bad_request_11": {
                    "summary": "A `volume_target` value is 0 or not a whole number of base units.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "volume_target.<chain> must be a positive integer in base units"
                    }
                  },
                  "bad_request_12": {
                    "summary": "`wallets` is empty or holds only blank strings.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallets is empty"
                    }
                  },
                  "bad_request_13": {
                    "summary": "More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 200 wallets per request"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: A wallet is not on the account. The whole request is refused. Use wallets from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "A wallet is not on the account. The whole request is refused.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "wallet <address> is not on this license"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: A wallet is watch-only, so there is no key to hand to the farming service. The whole request is refused. Remove watch-only wallets from `wallets`.\n\n`upstream_failure`: The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. Retry after a short wait; the failure is on the farming service's side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "A wallet is watch-only, so there is no key to hand to the farming service. The whole request is refused.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "wallet <address> is watch-only and cannot be farmed"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Before retrying, call [List farms](/reference/wallet-activity/#list-farms) and check whether the wallets already have a running farm."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-activity/#run-an-activity-plan"
        }
      }
    },
    "/activity/stop": {
      "post": {
        "operationId": "wallet-activity.stop-farms",
        "summary": "Stop farms",
        "description": "Stops the farms of the given wallets.",
        "tags": [
          "Wallet activity"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets of the account whose farm to stop. At most 200."
                  },
                  "forget": {
                    "type": "boolean",
                    "description": "Passed to the farming service with the stop. The web app always sends `false`.",
                    "default": "false"
                  }
                },
                "required": [
                  "wallets"
                ]
              },
              "example": {
                "wallets": [
                  "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44"
                ],
                "forget": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "stopped": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Wallets stopped."
                    },
                    "skipped": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "reference": {
                            "type": "string",
                            "description": "Wallet address or reference skipped."
                          },
                          "reason": {
                            "type": "string",
                            "description": "Why it was skipped."
                          }
                        }
                      },
                      "description": "Wallets not stopped."
                    }
                  }
                },
                "example": {
                  "stopped": [
                    "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44"
                  ],
                  "skipped": []
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: `wallets` is empty or holds only blank strings. Send at least one wallet.\n\n`bad_request`: More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting. Send at most 200 wallets per call.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`wallets` is empty or holds only blank strings.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallets is empty"
                    }
                  },
                  "bad_request_3": {
                    "summary": "More than 200 distinct wallets were sent. Duplicates and blank entries are dropped before counting.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 200 wallets per request"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: A wallet is not on the account. The whole request is refused. Use wallets from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "A wallet is not on the account. The whole request is refused.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "wallet <address> is not on this license"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. Retry after a short wait; the failure is on the farming service's side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Stopping a farm that is already stopped changes nothing."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-activity/#stop-farms"
        }
      }
    },
    "/activity/farms": {
      "get": {
        "operationId": "wallet-activity.list-farms",
        "summary": "List farms",
        "description": "Returns the account's farms with their progress and per-chain stats.\n\nThe web app polls it every 15 seconds in pages of 50, re-reading every loaded page on each poll.",
        "tags": [
          "Wallet activity"
        ],
        "parameters": [
          {
            "name": "include_stopped",
            "in": "query",
            "required": false,
            "description": "Also return stopped and finished farms.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size, from 1 to 200; values outside are clamped. The web app sends 50.",
            "schema": {
              "type": "integer",
              "default": "200"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of farms to skip.",
            "schema": {
              "type": "integer",
              "default": "0"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns an array of [Farm](#object-farm) objects.",
            "content": {
              "application/json": {
                "example": [
                  {
                    "pubkey": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44",
                    "network": "svm",
                    "chains": [
                      "sol"
                    ],
                    "state": "running",
                    "stop_reason": null,
                    "persona": "volume",
                    "timezone": "always_awake_burst",
                    "tier": null,
                    "tx_per_day": 9,
                    "tx_count": 23,
                    "balance": "1310000000",
                    "start_balance": "1500000000",
                    "started_at": "2026-10-30T09:12:00Z",
                    "ends_at": "2026-11-06T09:12:00Z",
                    "stopped_at": null,
                    "next_op_at": "2026-11-02T14:41:00Z",
                    "duration_secs": 604800,
                    "continuous": false,
                    "volume_reached_at": null,
                    "budgets": {
                      "sol": "1500000000"
                    },
                    "ops_completed": 23,
                    "ops_failed": 1,
                    "ops_pending": 1,
                    "ops_skipped": 0,
                    "chain_stats": [
                      {
                        "chain": "sol",
                        "volume": "21400000000",
                        "volume_usd": 3852,
                        "volume_target": "50000000000",
                        "volume_reached": false,
                        "buy_spent": "10800000000",
                        "sell_received": "10610000000",
                        "fees": "9200000",
                        "fees_usd": 1.66,
                        "swap_loss": "180800000",
                        "swap_loss_usd": 32.54,
                        "native_usd": 180,
                        "recoverable": {
                          "tokens_value": "0",
                          "tokens_unpriced": [],
                          "rent": "2039280"
                        },
                        "txs_confirmed": 23,
                        "txs_failed": 1,
                        "txs_pending_effect": 0
                      }
                    ]
                  }
                ]
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. Retry after a short wait; the failure is on the farming service's side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-activity/#list-farms"
        }
      }
    },
    "/activity/farms/{address}/ops": {
      "get": {
        "operationId": "wallet-activity.list-farm-operations",
        "summary": "List farm operations",
        "description": "Returns the transactions made by one wallet's farm.\n\nNot called by the current web app.",
        "tags": [
          "Wallet activity"
        ],
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "Wallet address. Must be a wallet of the account.",
            "schema": {
              "type": "string"
            },
            "example": "C31EeqtSvpjYHFQxBoP9bBTpqtUWV2avNhjdaN1yem44"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size, from 1 to 200; values outside are clamped.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of operations to skip.",
            "schema": {
              "type": "integer",
              "default": "0"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns an array of [Farm operation](#object-farm-operation) objects.",
            "content": {
              "application/json": {
                "example": [
                  {
                    "id": "4f9d94e0-65d2-4c21-8e36-963fe5159068",
                    "chain": "sol",
                    "op_type": "buy",
                    "status": "confirmed",
                    "tx_hash": "5K1g9bQMqoMvVUgSD92K9PUDSwmNuCpzQDU6DiEj9iBuYVDeph7qEmxrsodWFSguTfgUrZhhcZG7K3jMeSwHC2up",
                    "error": null,
                    "token_mint": "F5tEkCDmR87MF7i26oCT4Q4DBaufjAWTXioGFtiCFvob",
                    "token_symbol": "CAT",
                    "native_spent": "480000000",
                    "native_received": null,
                    "fee_native": "405000",
                    "reverted": false,
                    "created_at": "2026-11-02T13:58:10Z",
                    "settled_at": "2026-11-02T13:58:12Z"
                  }
                ]
              }
            }
          },
          "404": {
            "description": "`not_found`: The wallet is not on the account. Use wallets from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The wallet is not on the account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "wallet <address> is not on this license"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message. Retry after a short wait; the failure is on the farming service's side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The farming service could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Refusals the service states itself come back with its own status (400, 404, 409, 422 or 429) and message.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/wallet-activity/#list-farm-operations"
        }
      }
    },
    "/{chain_id}/shield/get-shield-info": {
      "get": {
        "operationId": "shield.retrieve-shield",
        "summary": "Retrieve the Shield",
        "description": "Returns the Shield state of the license.\n\nThe Shield settings badge polls this every 20 seconds, and the Shield dialog every 5 seconds while open.",
        "tags": [
          "Shield"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain id. Shield is Solana-only; any other value is rejected.",
            "schema": {
              "type": "string",
              "enum": [
                "sol"
              ]
            },
            "example": "sol"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a [Shield](#object-shield) object.",
            "content": {
              "application/json": {
                "example": {
                  "custom_ocp": "Px9mKc3TqWv7Ra2YbHn5DsLf8GzJe4Uu6Nt1Qw3Ek2B",
                  "status": "Deployed",
                  "deployer_pubkey": "DkR4mWq7TzY2bNc9HvJ3sLp8XfGa5Ue6Kt1Qw2Ey4Mh"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `{chain_id}` is not `sol`. An unknown chain id gets `unknown chain_id: <chain_id>`. Call it with `sol`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`{chain_id}` is not `sol`. An unknown chain id gets `unknown chain_id: <chain_id>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The license's Shield information could not be read. Retry after a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The license's Shield information could not be read.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Couldn't find shield info"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/shield/#retrieve-shield"
        }
      }
    },
    "/{chain_id}/shield/deploy": {
      "post": {
        "operationId": "shield.deploy-shield",
        "summary": "Deploy a Shield",
        "description": "Deploys the license's Shield, paid by one of its funders.\n\nThe status is `Pending` while the deployment runs, then `Deployed`, or `Failed` on error. The request returns when the deployment has finished. The web app lets the user pick the paying funder and requires it to hold at least 7 SOL.\n\nSpends SOL from the funder for the on-chain deployment.",
        "tags": [
          "Shield"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain id. Shield is Solana-only; any other value is rejected.",
            "schema": {
              "type": "string",
              "enum": [
                "sol"
              ]
            },
            "example": "sol"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "funder_pubkey": {
                    "type": "string",
                    "description": "Funder that pays for the deployment. Omit to use the license's default funder, but still send a JSON body (`{}`): a request without a body is rejected."
                  }
                }
              },
              "example": {
                "funder_pubkey": "DkR4mWq7TzY2bNc9HvJ3sLp8XfGa5Ue6Kt1Qw2Ey4Mh"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Result message."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully deployed ocp"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `{chain_id}` is not `sol`. An unknown chain id gets `unknown chain_id: <chain_id>`. Call it with `sol`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`{chain_id}` is not `sol`. An unknown chain id gets `unknown chain_id: <chain_id>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The license already has a deployed program. Use the deployed program, or close it with [Close the Shield](/reference/shield/#close-shield) before deploying again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The license already has a deployed program.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "On chain program already deployed"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The funder holds less than the minimum balance (7 SOL). Fund it with at least 7 SOL, or pick another funder from [List funders](/reference/funders/#list-funders).\n\n`upstream_failure`: The funder's balance could not be read from the Solana RPC. Nothing was deployed. Retry after a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The funder holds less than the minimum balance (7 SOL).",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Funder doesn't have enough balance"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The funder's balance could not be read from the Solana RPC. Nothing was deployed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <reason>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read `status` with [Retrieve the Shield](/reference/shield/#retrieve-shield) first: `Deployed` means the first call went through, `Pending` that it is still running. Deploying again while `Pending` pays for a second program."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/shield/#deploy-shield"
        }
      }
    },
    "/{chain_id}/shield/close": {
      "post": {
        "operationId": "shield.close-shield",
        "summary": "Close the Shield",
        "description": "Closes the license's Shield and reclaims the rent of its accounts.\n\nClosing cannot be undone: a new Shield needs a new deployment. Do not remove the deployer funder while the Shield is deployed, or it cannot be closed.",
        "tags": [
          "Shield"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain id. Shield is Solana-only; any other value is rejected.",
            "schema": {
              "type": "string",
              "enum": [
                "sol"
              ]
            },
            "example": "sol"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Result message."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully closed programs"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `{chain_id}` is not `sol`. An unknown chain id gets `unknown chain_id: <chain_id>`. Call it with `sol`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`{chain_id}` is not `sol`. An unknown chain id gets `unknown chain_id: <chain_id>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No deployer is recorded: the license has no deployed Shield, or it was already closed. Check `status` with [Retrieve the Shield](/reference/shield/#retrieve-shield).\n\n`not_found`: The funder that deployed the program was removed from the license. Only that funder can close it. Contact support to close the program.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No deployer is recorded: the license has no deployed Shield, or it was already closed.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No shield deployer recorded, cannot close"
                    }
                  },
                  "not_found_2": {
                    "summary": "The funder that deployed the program was removed from the license. Only that funder can close it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Shield deployer funder not found, do not remove it while shield is deployed"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The program account is still open after the close transactions. The Shield stays recorded as deployed. Retry; only the accounts still open are closed again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The program account is still open after the close transactions. The Shield stays recorded as deployed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while closing programs accounts"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A retry after a successful close returns `404` (`No shield deployer recorded, cannot close`)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/shield/#close-shield"
        }
      }
    },
    "/launch/{chain_id}/{dex}/create-mint": {
      "post": {
        "operationId": "launches.create-launch",
        "summary": "Create a launch",
        "description": "Creates a draft launch from the token metadata.\n\nUploads the token metadata and image and creates a draft launch on `chain_id` for the platform `dex`. Nothing is deployed yet: save a plan with [Update the launch plan](#update-launch-plan), fund the wallets, then [launch](/reference/launch-execution/#launch).\n\nPlatform-specific parts are only sent for their platform. The app also clones a launch by sending the copied metadata to this endpoint.\n\nOn Solana, a `pangea` launch is sent to `/launch/sol/meteoradamm/create-mint` with `create_params.pool_mode` set to `pangea`.\n\n`launch_id` is returned as a string.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to create the token on.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "dex",
            "in": "path",
            "required": true,
            "description": "Launch platform ID in lowercase, for example `pumpfun`, `bonkfun`, `meteoradbc`, `fourmeme`, `flap` or `uniswapv2`.",
            "schema": {
              "type": "string"
            },
            "example": "pumpfun"
          },
          {
            "name": "version",
            "in": "query",
            "required": false,
            "description": "Pons contract version. Sent only when `dex` is `pons`, taken from `create_params.version`.",
            "schema": {
              "type": "integer",
              "enum": [
                1,
                2
              ],
              "default": "2"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Token name."
                  },
                  "symbol": {
                    "type": "string",
                    "description": "Token ticker."
                  },
                  "image": {
                    "type": "string",
                    "format": "binary",
                    "description": "Token image. A file part, or a string the app reuses from an existing token."
                  },
                  "description": {
                    "type": "string",
                    "description": "Token description."
                  },
                  "twitter": {
                    "type": "string",
                    "description": "X (Twitter) link."
                  },
                  "telegram": {
                    "type": "string",
                    "description": "Telegram link."
                  },
                  "website": {
                    "type": "string",
                    "description": "Website link."
                  },
                  "launch_platform": {
                    "type": "string",
                    "description": "Platform name stored with the launch."
                  },
                  "video": {
                    "type": "string",
                    "format": "binary",
                    "description": "pump.fun only. MP4 or WebM, up to 10 MiB. Not sent for Ansem launches."
                  },
                  "quote_mint": {
                    "type": "string",
                    "description": "Mint of the quote token the token pairs with. See [List quote tokens](/reference/launch-platforms/#list-quote-tokens)."
                  },
                  "host": {
                    "type": "string",
                    "enum": [
                      "ipfs",
                      "proxima"
                    ],
                    "description": "Where the image and metadata JSON are published.",
                    "default": "ipfs"
                  },
                  "tracker": {
                    "type": "string",
                    "description": "`true` when the launch is deployed from the X tracker."
                  },
                  "mint": {
                    "type": "string",
                    "description": "Base58 secret key of a custom mint keypair, for a chosen token address. Not sent for Ansem launches nor for `stoxes`, `flywheel`, `coinbarrel`, `knot`, `realm`, `stonksexchange`, `pangea`, `genius` and `ignix`."
                  },
                  "is_mayhem_mode": {
                    "type": "boolean",
                    "description": "pump.fun, not Ansem: Mayhem mode, sent as `true` or `false`."
                  },
                  "is_pump_cashback": {
                    "type": "boolean",
                    "description": "pump.fun, not Ansem: cashback, sent as `true` or `false`."
                  },
                  "is_offchain_create": {
                    "type": "boolean",
                    "description": "pump.fun, not Ansem: off-chain create, sent as `true` or `false`."
                  },
                  "is_pump_holder_reward": {
                    "type": "boolean",
                    "description": "pump.fun Holder Rewards: `true` sends creator fees to holders, `false` keeps them with the creator."
                  },
                  "creator_fee_bps": {
                    "type": "string",
                    "description": "pump.fun creator-fee override, 1 to 300 (0.01% to 3%). Omit to keep the pump.fun default."
                  },
                  "pumpfun_fee_shares": {
                    "type": "string",
                    "description": "pump.fun, not Ansem: JSON array of fee-share legs `{share_bps, dev?, address?, github?, charity_id?}`. Not sent with `otcdesks`, `usepaid` or `zaio`."
                  },
                  "ansem": {
                    "type": "string",
                    "description": "pump.fun Ansem launch, as JSON `{\"tier\": \"free\" | \"gold\" | \"diamond\", \"airdrop_buy_sol\"?}`. See [Retrieve the Ansem config](/reference/launch-platforms/#retrieve-ansem-config)."
                  },
                  "otcdesks": {
                    "type": "string",
                    "description": "JSON `{reward_mint, reward_basket?}`: rewards holders in a token or basket. See [List OTC desk rewards](/reference/launch-platforms/#list-otcdesks-rewards)."
                  },
                  "usepaid": {
                    "type": "string",
                    "description": "JSON `{handle}`: a UsePaid launch for an X handle."
                  },
                  "zaio": {
                    "type": "string",
                    "description": "`true` launches on zaio.fun (pump.fun, creator fees split 50/50 with zaio)."
                  },
                  "bonk_mode_type": {
                    "type": "string",
                    "description": "bonk.fun mode."
                  },
                  "fourmeme_template_id": {
                    "type": "string",
                    "description": "Four.meme template ID."
                  },
                  "fee_claimers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "provider": {
                          "type": "string",
                          "enum": [
                            "twitter",
                            "tiktok",
                            "kick",
                            "github",
                            "address"
                          ],
                          "description": "Where `username` lives."
                        },
                        "username": {
                          "type": "string",
                          "description": "Handle, or wallet address for `address`."
                        },
                        "bps": {
                          "type": "integer",
                          "description": "Share in basis points."
                        }
                      }
                    },
                    "description": "Bags fee claimers, sent as indexed parts such as `fee_claimers[0][provider]`."
                  },
                  "printr_graduation_threshold": {
                    "type": "number",
                    "description": "Printr graduation threshold."
                  },
                  "fee_sink": {
                    "type": "string",
                    "enum": [
                      "dev",
                      "stake_pool",
                      "buyback"
                    ],
                    "description": "Printr fee sink."
                  },
                  "max_supply": {
                    "type": "string",
                    "enum": [
                      "100_million",
                      "1_billion",
                      "10_billion"
                    ],
                    "description": "Printr maximum supply."
                  },
                  "initial_market_cap": {
                    "type": "number",
                    "description": "Printr initial market cap."
                  },
                  "bc_fee_bps": {
                    "type": "integer",
                    "description": "Printr bonding-curve fee, in basis points."
                  },
                  "amm_fee_bps": {
                    "type": "integer",
                    "description": "Printr AMM fee, in basis points."
                  },
                  "api_key": {
                    "type": "string",
                    "description": "Anoncoin API key."
                  },
                  "dbc_config": {
                    "type": "string",
                    "description": "Meteora DBC config account. See [List DBC configs](/reference/launch-platforms/#list-dbc-configs)."
                  },
                  "create_params": {
                    "type": "string",
                    "description": "Platform create parameters as a JSON string, for `uniswapv2`, `uniswapv3`, `uniswapv4`, `hoodfun`, `pons`, `real`, `flap`, `meteoradamm`, `meteoradlmm`, `fourmeme`, `stonkfun`, `long`, `argus`, `foci`, `stoxes`, `flywheel`, `coinbarrel`, `knot`, `realm`, `stonksexchange`, `pangea`, `genius`, `ignix` and `anoncoin`, and for `meteoradbc` and `launchlab` drafts."
                  },
                  "stoxes": {
                    "type": "string",
                    "description": "Stoxes create body, as a JSON string."
                  },
                  "lesgo": {
                    "type": "string",
                    "description": "Lesgo create body, as JSON `{\"kind\": \"burn\" | \"dev\", \"fee_bps\", \"burn_base\"?}`."
                  }
                },
                "required": [
                  "name",
                  "symbol",
                  "image"
                ]
              },
              "example": {
                "name": "Orbit Cat",
                "symbol": "ORBIT",
                "image": "(binary orbit-cat.png)",
                "description": "A cat in low orbit.",
                "twitter": "https://x.com/orbitcat_sol",
                "website": "https://orbitcat.xyz",
                "launch_platform": "pumpfun",
                "host": "ipfs",
                "is_mayhem_mode": false,
                "is_pump_holder_reward": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the new launch ID.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "launch_id": {
                      "type": "string",
                      "description": "Public ID of the new launch."
                    },
                    "chain_id": {
                      "type": "string",
                      "enum": [
                        "sol",
                        "eth",
                        "bsc",
                        "base",
                        "robinhood",
                        "monad",
                        "arc",
                        "xlayer"
                      ],
                      "description": "Chain of the launch."
                    },
                    "mint_pubkey": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Token address, when already known."
                    },
                    "quote_mint": {
                      "type": "string",
                      "description": "Mint of the quote token."
                    },
                    "quote_symbol": {
                      "type": "string",
                      "description": "Symbol of the quote token."
                    },
                    "launch_fee_lamports": {
                      "type": "string",
                      "description": "Platform launch fee in lamports. Number or numeric string."
                    },
                    "dev_buy_lamports_per_percent": {
                      "type": "string",
                      "description": "Cost of each percent of supply for the dev buy, in lamports. Number or numeric string."
                    },
                    "max_dev_buy_percent": {
                      "type": "string",
                      "description": "Largest dev buy allowed, in percent of supply. Number or numeric string."
                    },
                    "mode": {
                      "type": "string",
                      "enum": [
                        "standard",
                        "reward"
                      ],
                      "description": "Stonkfun mode."
                    },
                    "fee_tier": {
                      "type": "string",
                      "enum": [
                        "1%",
                        "2%"
                      ],
                      "description": "Fee tier."
                    },
                    "reward_tax_bps": {
                      "type": "integer",
                      "description": "Reward tax in basis points.",
                      "enum": [
                        100,
                        300
                      ]
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully create mint datas",
                  "launch_id": "101482937561204",
                  "chain_id": "sol",
                  "mint_pubkey": "HtSTV4r6EZBnJfTQkWLf1ZbTC8UjUxL9evrE67EmuzyF"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use one of `sol`, `bsc`, `base`, `eth`, `robinhood`, `arc` or `xlayer`.\n\n`bad_request`: `dex` is a Solana platform and `chain_id` is another chain. Send Solana platforms with `chain_id` set to `sol`.\n\n`bad_request`: `dex` has no Solana create route, so a `sol` request reached the EVM route. Check `dex` against the platforms the chain supports.\n\n`bad_request`: EVM: `dex` is not a known platform, or the Pons `version` does not exist. Use a platform ID the app lists for this chain, in lowercase.\n\n`bad_request`: EVM: the platform does not deploy on this chain. Create the launch on one of the chains the message lists.\n\n`bad_request`: `name` or `symbol` is missing or empty. Send both `name` and `symbol` as non-empty parts.\n\n`bad_request`: No `image` part was sent. Send the token image as the `image` file part.\n\n`bad_request`: Solana: `name` is longer than the platform allows (32 bytes on pump.fun). An over-long `symbol` answers `Token symbol too long`. Shorten `name` and `symbol` to the platform's limits.\n\n`bad_request`: EVM: `name` is longer than the platform allows. An over-long `symbol` answers `symbol too long (max <max>)`. Shorten `name` and `symbol` to the maximum the message gives.\n\n`bad_request`: A `mint` part was sent to a platform that assigns the token address itself, which includes every EVM platform. Remove the `mint` part.\n\n`bad_request`: Solana: `mint` is not a valid base58 keypair secret. Send the base58 secret key of the mint keypair, or omit `mint` to get a generated address.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain_id: <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`dex` is a Solana platform and `chain_id` is another chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`dex` has no Solana create route, so a `sol` request reached the EVM route.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "chain_id <chain_id> is not an evm chain"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: `dex` is not a known platform, or the Pons `version` does not exist.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unsupported dex: <dex>"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the platform does not deploy on this chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<dex> is only supported on <chains> (got <chain_id>)"
                    }
                  },
                  "bad_request_6": {
                    "summary": "`name` or `symbol` is missing or empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "One of required field is missing"
                    }
                  },
                  "bad_request_7": {
                    "summary": "No `image` part was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Image is required"
                    }
                  },
                  "bad_request_8": {
                    "summary": "Solana: `name` is longer than the platform allows (32 bytes on pump.fun). An over-long `symbol` answers `Token symbol too long`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Token name too long"
                    }
                  },
                  "bad_request_9": {
                    "summary": "EVM: `name` is longer than the platform allows. An over-long `symbol` answers `symbol too long (max <max>)`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "name too long (max <max>)"
                    }
                  },
                  "bad_request_10": {
                    "summary": "A `mint` part was sent to a platform that assigns the token address itself, which includes every EVM platform.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Custom mint key is not allowed"
                    }
                  },
                  "bad_request_11": {
                    "summary": "Solana: `mint` is not a valid base58 keypair secret.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mint key"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: A `usepaid` launch was requested while UsePaid has pump.fun turned off. On Pons the message is `UsePaid has not enabled pons.family yet`. Create the launch without `usepaid`, or try again once UsePaid enables the platform.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "A `usepaid` launch was requested while UsePaid has pump.fun turned off. On Pons the message is `UsePaid has not enabled pons.family yet`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "UsePaid is disabled for pump.fun"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Solana: the image and metadata could not be pinned to IPFS. No launch was created. Send the request again; nothing was saved.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Solana: the image and metadata could not be pinned to IPFS. No launch was created.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "ipfs api issue: IPFS error while uploading"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call creates a new draft launch. Look for it in [List the license's launches](/reference/licenses/#list-mints) before sending the request again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#create-launch"
        }
      }
    },
    "/launch/{chain_id}/import-mint": {
      "post": {
        "operationId": "launches.import-launch",
        "summary": "Import a launch",
        "description": "Creates a launch around a token that already exists on-chain.\n\nThe new launch is flagged `is_imported`. Save a plan for it like any other launch.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain the token lives on.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mint": {
                    "type": "string",
                    "description": "Address of the existing token."
                  }
                },
                "required": [
                  "mint"
                ]
              },
              "example": {
                "mint": "HtSTV4r6EZBnJfTQkWLf1ZbTC8UjUxL9evrE67EmuzyF"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the new launch ID.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "launch_id": {
                      "type": "string",
                      "description": "Public ID of the new launch."
                    },
                    "chain_id": {
                      "type": "string",
                      "enum": [
                        "sol",
                        "eth",
                        "bsc",
                        "base",
                        "robinhood",
                        "monad",
                        "arc",
                        "xlayer"
                      ],
                      "description": "Chain of the launch."
                    },
                    "mint_pubkey": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Token address, when already known."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully create mint datas",
                  "launch_id": "101907315264588",
                  "chain_id": "sol",
                  "mint_pubkey": "HtSTV4r6EZBnJfTQkWLf1ZbTC8UjUxL9evrE67EmuzyF"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a chain the API serves. Use one of `sol`, `bsc`, `base`, `eth`, `robinhood`, `arc` or `xlayer`.\n\n`bad_request`: Solana: `mint` is not a valid base58 address. Send the token's mint address.\n\n`bad_request`: EVM: `mint` is not a valid `0x` address. Send the token's contract address.\n\n`bad_request`: EVM: no supported launchpad or pool was found for this token. Check the address and `chain_id`; only tokens on a supported launchpad or pool can be imported.\n\n`bad_request`: Solana: the token trades against a quote token Proxima cannot fund. Import only tokens paired with a quote token from [List quote tokens](/reference/launch-platforms/#list-quote-tokens).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a chain the API serves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain_id: <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `mint` is not a valid base58 address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mint key"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: `mint` is not a valid `0x` address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid mint address"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: no supported launchpad or pool was found for this token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "could not auto-detect launchpad"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Solana: the token trades against a quote token Proxima cannot fund.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this token settles in an unsupported quote token"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: no supported launchpad or pool trades this mint, or the mint does not exist. This refusal is answered as a 500. Check the mint and `chain_id`; only tokens on a supported launchpad or pool can be imported.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: no supported launchpad or pool trades this mint, or the mint does not exist. This refusal is answered as a 500.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Couldn't find any associated platform"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call creates a new launch, even for a token already imported. Look for the mint in [List the license's launches](/reference/licenses/#list-mints) before sending it again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#import-launch"
        }
      }
    },
    "/launch/get-launch-info/{launch_id}": {
      "get": {
        "operationId": "launches.retrieve-launch",
        "summary": "Retrieve a launch",
        "description": "Retrieves the launch plan, wallets, balances and performance of a launch.\n\nWallet secrets are never included; use [Reveal launch keys](#reveal-launch-keys). For a multi-launch container the response describes the group, with `kind`, `count`, `state` and `members`.\n\nNumeric settings such as `buy_delay`, `slippage` or `creator_fees` can arrive as numeric strings; the web app converts them to numbers.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a Launch object.",
            "content": {
              "application/json": {
                "example": {
                  "chain_id": "sol",
                  "launch_method": "Stagger",
                  "funding_type": "Classic",
                  "funding_delay": null,
                  "is_graduated": false,
                  "is_imported": false,
                  "scheduled_mode": false,
                  "mev_type": null,
                  "buy_delay": 1500,
                  "buy_delay_max": 4000,
                  "initial_buy_delay": null,
                  "slippage": 1500,
                  "fake_tip_pct": 0,
                  "routing_override": null,
                  "quote_mint": "So11111111111111111111111111111111111111112",
                  "total_supply": 1000000000,
                  "creator_fees": 184203117,
                  "creator_fee_bps": null,
                  "is_pump_holder_reward": false,
                  "unclaimed_cashback": null,
                  "dev": {
                    "key": {
                      "pubkey": "BZJTwe2bzzTQBwy5VQwwrhbzbMUbQoBZ59F9g3fUUtZU",
                      "can_export": true
                    },
                    "aged": false,
                    "archived": false,
                    "buy_native": "500000000",
                    "buy_supply": "17241379310344",
                    "native_balance": "41250000",
                    "token_balance": "17241379310344"
                  },
                  "funder": {
                    "key": {
                      "pubkey": "EpvJTvDWrKDjJcVw3DrMPM4vvZA1mQfo8NdUTsuzwjkq",
                      "can_export": true
                    },
                    "aged": false,
                    "archived": false,
                    "is_universal": false,
                    "native_balance": "2914000000"
                  },
                  "holder": [
                    {
                      "key": {
                        "pubkey": "HBwqDp7Qpmzos1wZhr5ZpwfsedZFGHubfdibhHBeH47Z",
                        "can_export": true
                      },
                      "aged": false,
                      "archived": false,
                      "buy_native": "250000000",
                      "native_balance": "3100000",
                      "token_balance": "8120443150912"
                    },
                    {
                      "key": {
                        "pubkey": "GwjXHJRZCrZjmRTzfuBCFkeuMmy6PxNMET4cPSmsvahJ",
                        "can_export": true
                      },
                      "aged": true,
                      "archived": false,
                      "buy_native": "310000000",
                      "native_balance": "2875000",
                      "token_balance": "9934021876410"
                    }
                  ],
                  "front_mev": [],
                  "back_mev": [],
                  "temp_holder": [],
                  "wallets_being_funded": 0,
                  "wallets_funded": 3,
                  "pnl_native": "1284500000",
                  "pnl_usd": "231620000",
                  "gross_volume_native": "9872000000",
                  "gross_volume_usd": "1780110000",
                  "extra_rewards_native": "0",
                  "extra_rewards_usd": "0",
                  "mm_pnl_native": "0",
                  "mm_pnl_usd": "0",
                  "mcap_live": 48210.5
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: no plan was saved for this launch yet. A partly saved plan answers the same way, for example `No funder wallet configured` or `No holder wallets saved`. Save a complete plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: no plan was saved for this launch yet. A partly saved plan answers the same way, for example `No funder wallet configured` or `No holder wallets saved`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No launch method saved"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.\n\n`not_found`: Solana: no plan was saved for this launch yet. Save a plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: no plan was saved for this launch yet.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No launch method saved"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#retrieve-launch"
        }
      }
    },
    "/launch/update-launch-plan/{launch_id}": {
      "post": {
        "operationId": "launches.update-launch-plan",
        "summary": "Update the launch plan",
        "description": "Saves the launch plan: launch method, timings and the wallets with their planned buys.\n\nSend the plan fields to set; the body is a partial [Launch](#object-launch). Wallet slots take a `key` and a planned buy. The response echoes the saved plan and the native amount the funder needs.\n\nThe SDK method then re-reads the launch with [Retrieve a launch](#retrieve-launch) and copies back the wallet `secret`s the update response returned.\n\nThe SDK converts every `buy_supply` and `buy_native` to an integer string before sending.\n\nScript plans use the same path with a different body. See [Save a script plan](/reference/launch-scripts/#save-script-plan).",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "launch_method": {
                    "type": "string",
                    "enum": [
                      "Mev",
                      "Stagger",
                      "Manual",
                      "Allowlist"
                    ],
                    "description": "How the wallets buy."
                  },
                  "funding_type": {
                    "type": "string",
                    "enum": [
                      "Classic",
                      "Cex"
                    ],
                    "description": "How the funder spreads native to the wallets."
                  },
                  "funding_delay": {
                    "type": "integer",
                    "description": "Gap between `Cex` funding transfers, in seconds."
                  },
                  "scheduled_mode": {
                    "type": "boolean",
                    "description": "Deploy first and let the wallets buy later through [Snipe a scheduled launch](/reference/launch-execution/#snipe-launch). The app always sets it for imported launches."
                  },
                  "auto_snipe_delay_ms": {
                    "type": "integer",
                    "description": "Solana scheduled launches: fire the snipe on its own this long after staging, in milliseconds."
                  },
                  "mev_type": {
                    "type": "string",
                    "enum": [
                      "buyback",
                      "airdrop"
                    ],
                    "description": "Variant of a `Mev` launch."
                  },
                  "buy_delay": {
                    "type": "integer",
                    "description": "Delay between holder buys, in milliseconds."
                  },
                  "buy_delay_max": {
                    "type": "integer",
                    "description": "Solana `Stagger` only: upper bound of the random gap between holder buys, in milliseconds."
                  },
                  "initial_buy_delay": {
                    "type": "integer",
                    "description": "Delay before the first holder buy, in milliseconds."
                  },
                  "front_to_back_delay_ms": {
                    "type": "integer",
                    "description": "Delay between front MEV and back MEV buys, in milliseconds."
                  },
                  "back_to_temp_delay_ms": {
                    "type": "integer",
                    "description": "Delay between back MEV and temporary holder buys, in milliseconds."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points."
                  },
                  "fake_tip_pct": {
                    "type": "number",
                    "description": "Fake-tip setting, in percent."
                  },
                  "fee_target": {
                    "type": "integer",
                    "description": "Fee target in native base units."
                  },
                  "is_multi": {
                    "type": "boolean",
                    "description": "Make the launch a multi-launch."
                  },
                  "count": {
                    "type": "string",
                    "description": "Number of launches of a multi-launch. The SDK sends it as a string."
                  },
                  "dev": {
                    "type": "object",
                    "properties": {
                      "key": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "object"
                          }
                        ],
                        "description": "`\"None\"` to generate a wallet, `{\"pubkey\"}` to use one of your aged wallets, or `{\"secret\"}` to bring a key."
                      },
                      "buy_supply": {
                        "type": "string",
                        "description": "Planned buy in token base units, as an integer string."
                      },
                      "buy_native": {
                        "type": "string",
                        "description": "Planned buy in native base units, as an integer string."
                      }
                    },
                    "description": "Dev wallet slot."
                  },
                  "funder": {
                    "type": "object",
                    "description": "Funder wallet slot. Its `key` usually names one of your funder wallets."
                  },
                  "holder": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Holder wallet slots, shaped like `dev`."
                  },
                  "front_mev": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Front MEV wallet slots, shaped like `dev`."
                  },
                  "back_mev": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Back MEV wallet slots, shaped like `dev`."
                  },
                  "temp_holder": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Temporary holder wallet slots, shaped like `dev`."
                  }
                }
              },
              "example": {
                "launch_method": "Stagger",
                "funding_type": "Classic",
                "funding_delay": 0,
                "scheduled_mode": false,
                "buy_delay": 1500,
                "buy_delay_max": 4000,
                "slippage": 1500,
                "fake_tip_pct": 0,
                "dev": {
                  "key": "None",
                  "buy_native": "500000000"
                },
                "funder": {
                  "key": {
                    "pubkey": "EpvJTvDWrKDjJcVw3DrMPM4vvZA1mQfo8NdUTsuzwjkq"
                  }
                },
                "holder": [
                  {
                    "key": "None",
                    "buy_native": "250000000"
                  },
                  {
                    "key": {
                      "pubkey": "GwjXHJRZCrZjmRTzfuBCFkeuMmy6PxNMET4cPSmsvahJ"
                    },
                    "buy_native": "310000000"
                  }
                ],
                "front_mev": [],
                "back_mev": [],
                "temp_holder": []
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "funder_required_native": {
                      "type": "integer",
                      "description": "Native amount the funder needs for the whole plan, in base units."
                    },
                    "plan": {
                      "type": "object",
                      "description": "The saved plan, a [Launch](#object-launch). Wallet slots can still carry the `secret`s you sent."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "funder_required_native": 1093500000,
                  "plan": {
                    "chain_id": "sol",
                    "launch_method": "Stagger",
                    "funding_type": "Classic",
                    "buy_delay": 1500,
                    "buy_delay_max": 4000,
                    "slippage": 1500,
                    "dev": {
                      "key": {
                        "pubkey": "BZJTwe2bzzTQBwy5VQwwrhbzbMUbQoBZ59F9g3fUUtZU"
                      },
                      "buy_native": "500000000"
                    },
                    "funder": {
                      "key": {
                        "pubkey": "EpvJTvDWrKDjJcVw3DrMPM4vvZA1mQfo8NdUTsuzwjkq"
                      }
                    },
                    "holder": [
                      {
                        "key": {
                          "pubkey": "HBwqDp7Qpmzos1wZhr5ZpwfsedZFGHubfdibhHBeH47Z"
                        },
                        "buy_native": "250000000"
                      },
                      {
                        "key": {
                          "pubkey": "GwjXHJRZCrZjmRTzfuBCFkeuMmy6PxNMET4cPSmsvahJ"
                        },
                        "aged": true,
                        "buy_native": "310000000"
                      }
                    ],
                    "front_mev": [],
                    "back_mev": [],
                    "temp_holder": []
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: Solana: the plan breaks a rule of its launch method or platform. Each rule has its own message, for example `At least one holder must have a non-zero buy amount` or `Imported launches must be in scheduled mode`. Fix the plan field the message names and save again.\n\n`bad_request`: EVM: `back_mev` is not empty. EVM launches use `front_mev` and optional `temp_holder` wallets. Send `back_mev` empty on EVM launches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: the plan breaks a rule of its launch method or platform. Each rule has its own message, for example `At least one holder must have a non-zero buy amount` or `Imported launches must be in scheduled mode`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Dev wallet is required for non-imported launches"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: `back_mev` is not empty. EVM launches use `front_mev` and optional `temp_holder` wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "back_mev is not supported on evm launches"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.\n\n`not_found`: Solana: a wallet slot names a `key` that is not one of your wallets. Use a wallet from [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: a wallet slot names a `key` that is not one of your wallets.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Secret not found for pubkey: <pubkey>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch is no longer a draft. This refusal is answered as a 500. Save plans only while the launch is a draft.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch is no longer a draft. This refusal is answered as a 500.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token already launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Saving the same plan again stores the same values. A wallet slot sent without a `key` gets a new wallet on each call, so read the wallets from the response."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#update-launch-plan"
        }
      }
    },
    "/launch/update-metadata/{launch_id}": {
      "post": {
        "operationId": "launches.update-launch-metadata",
        "summary": "Update launch metadata",
        "description": "Changes the token metadata of a draft launch.\n\nSend only the parts to change. On Solana, metadata can only change while the launch is a draft and not imported. On EVM, the stored metadata can change at any time, but `launch_platform` and `quote_mint` are fixed once the token is launched.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Token name."
                  },
                  "symbol": {
                    "type": "string",
                    "description": "Token ticker."
                  },
                  "image": {
                    "type": "string",
                    "format": "binary",
                    "description": "Token image. A file part, or a string the app reuses from an existing token."
                  },
                  "description": {
                    "type": "string",
                    "description": "Token description."
                  },
                  "twitter": {
                    "type": "string",
                    "description": "X (Twitter) link."
                  },
                  "telegram": {
                    "type": "string",
                    "description": "Telegram link."
                  },
                  "website": {
                    "type": "string",
                    "description": "Website link."
                  },
                  "launch_platform": {
                    "type": "string",
                    "description": "Platform name stored with the launch."
                  },
                  "video": {
                    "type": "string",
                    "format": "binary",
                    "description": "pump.fun only. MP4 or WebM, up to 10 MiB. Not sent for Ansem launches."
                  },
                  "remove_video": {
                    "type": "boolean",
                    "description": "pump.fun only. Sent as `true` to drop the current video; not combined with `video`."
                  },
                  "quote_mint": {
                    "type": "string",
                    "description": "Mint of the quote token the token pairs with. See [List quote tokens](/reference/launch-platforms/#list-quote-tokens)."
                  },
                  "is_mayhem_mode": {
                    "type": "boolean",
                    "description": "pump.fun, not Ansem: Mayhem mode, sent as `true` or `false`."
                  },
                  "is_pump_cashback": {
                    "type": "boolean",
                    "description": "pump.fun, not Ansem: cashback, sent as `true` or `false`."
                  },
                  "is_offchain_create": {
                    "type": "boolean",
                    "description": "pump.fun, not Ansem: off-chain create, sent as `true` or `false`."
                  },
                  "is_pump_holder_reward": {
                    "type": "boolean",
                    "description": "pump.fun Holder Rewards: `true` sends creator fees to holders, `false` keeps them with the creator."
                  },
                  "creator_fee_bps": {
                    "type": "string",
                    "description": "pump.fun creator-fee override, 1 to 300 (0.01% to 3%). `null` clears it; omit to keep the current value."
                  },
                  "pumpfun_fee_shares": {
                    "type": "string",
                    "description": "pump.fun, not Ansem: JSON array of fee-share legs `{share_bps, dev?, address?, github?, charity_id?}`. Not sent with `otcdesks`, `usepaid` or `zaio`."
                  },
                  "ansem": {
                    "type": "string",
                    "description": "pump.fun Ansem launch, as JSON `{\"tier\": \"free\" | \"gold\" | \"diamond\", \"airdrop_buy_sol\"?}`. See [Retrieve the Ansem config](/reference/launch-platforms/#retrieve-ansem-config)."
                  },
                  "bonk_mode_type": {
                    "type": "string",
                    "description": "bonk.fun mode."
                  },
                  "fourmeme_template_id": {
                    "type": "string",
                    "description": "Four.meme template ID."
                  },
                  "fee_claimers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "provider": {
                          "type": "string",
                          "enum": [
                            "twitter",
                            "tiktok",
                            "kick",
                            "github",
                            "address"
                          ],
                          "description": "Where `username` lives."
                        },
                        "username": {
                          "type": "string",
                          "description": "Handle, or wallet address for `address`."
                        },
                        "bps": {
                          "type": "integer",
                          "description": "Share in basis points."
                        }
                      }
                    },
                    "description": "Bags fee claimers, sent as indexed parts such as `fee_claimers[0][provider]`. Up to 15."
                  },
                  "printr_graduation_threshold": {
                    "type": "number",
                    "description": "Printr graduation threshold."
                  },
                  "fee_sink": {
                    "type": "string",
                    "enum": [
                      "dev",
                      "stake_pool",
                      "buyback"
                    ],
                    "description": "Printr fee sink."
                  },
                  "max_supply": {
                    "type": "string",
                    "enum": [
                      "100_million",
                      "1_billion",
                      "10_billion"
                    ],
                    "description": "Printr maximum supply."
                  },
                  "initial_market_cap": {
                    "type": "number",
                    "description": "Printr initial market cap."
                  },
                  "bc_fee_bps": {
                    "type": "integer",
                    "description": "Printr bonding-curve fee, in basis points."
                  },
                  "amm_fee_bps": {
                    "type": "integer",
                    "description": "Printr AMM fee, in basis points."
                  },
                  "api_key": {
                    "type": "string",
                    "description": "Anoncoin API key."
                  },
                  "dbc_config": {
                    "type": "string",
                    "description": "Meteora DBC config account. See [List DBC configs](/reference/launch-platforms/#list-dbc-configs)."
                  },
                  "create_params": {
                    "type": "string",
                    "description": "Platform create parameters as a JSON string, for `uniswapv2`, `uniswapv3`, `uniswapv4`, `hoodfun`, `pons`, `real`, `flap`, `meteoradamm`, `meteoradlmm`, `fourmeme`, `stonkfun`, `long`, `argus`, `foci`, `stoxes`, `flywheel`, `coinbarrel`, `knot`, `realm`, `stonksexchange`, `pangea`, `genius`, `ignix` and `anoncoin`."
                  },
                  "stoxes": {
                    "type": "string",
                    "description": "Stoxes create body, as a JSON string."
                  },
                  "lesgo": {
                    "type": "string",
                    "description": "Lesgo create body, as JSON `{\"kind\": \"burn\" | \"dev\", \"fee_bps\", \"burn_base\"?}`."
                  }
                }
              },
              "example": {
                "description": "A cat in a slightly higher orbit.",
                "website": "https://orbitcat.xyz",
                "creator_fee_bps": "null"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome. Sent for Solana launches only."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Metadata updated"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: The request carries no field to change. Send at least one field to change.\n\n`bad_request`: Solana: a `video` part was sent for a platform other than pump.fun. Send `video` only for pump.fun launches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The request carries no field to change.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No fields to update"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: a `video` part was sent for a platform other than pump.fun.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "A video is only supported on pumpfun"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: the launch is no longer a draft. Change Solana metadata before launching the token.\n\n`conflict`: Solana: the launch was imported, so its metadata is the existing token's. Leave the metadata of imported Solana launches unchanged.\n\n`conflict`: EVM: `launch_platform` changed on a launched token. A changed `quote_mint` answers `Cannot change the payment token after launch`. Send `launch_platform` and `quote_mint` only while the launch is a draft.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: the launch is no longer a draft.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Token already launched"
                    }
                  },
                  "conflict_2": {
                    "summary": "Solana: the launch was imported, so its metadata is the existing token's.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot update metadata on imported launches"
                    }
                  },
                  "conflict_3": {
                    "summary": "EVM: `launch_platform` changed on a launched token. A changed `quote_mint` answers `Cannot change the payment token after launch`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot change platform after launch"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sending the same fields again stores the same values."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#update-launch-metadata"
        }
      }
    },
    "/launch/routing-override/{launch_id}": {
      "post": {
        "operationId": "launches.set-routing-override",
        "summary": "Set the routing override",
        "description": "Sets how a Solana launch page's buys and sells are routed across platforms, over each wallet's default.\n\nPlatform IDs come from the wallet routing config the app reads with `proxima.wallets.getRoutingConfig()`.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch. Solana launches only.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "routing": {
                    "anyOf": [
                      {
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Share of each trade's wallets per routing platform ID, in whole percents summing to 100. Platform IDs are matched case-insensitively. `null`, or leaving the field out, clears the override."
                  }
                }
              },
              "example": {
                "routing": {
                  "direct": 60,
                  "axiom": 40
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "routing": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The override now in place, keyed by platform ID in lowercase; `null` when cleared."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "routing": {
                    "axiom": 40,
                    "direct": 60
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: The launch is not on Solana; only Solana trades are routed through platforms. Set a routing override only on Solana launches (IDs starting with `101`).\n\n`bad_request`: The body is not valid JSON, or a share is not a whole number from 0 to 255. Send `routing` as an object of whole-percent shares, or `null`.\n\n`bad_request`: A key of `routing` is not a platform that builds trades on Solana. Use platform IDs whose `chains` include `sol` in [Retrieve the routing config](/reference/wallets/#retrieve-the-routing-config).\n\n`bad_request`: The same platform appears twice in `routing`, in different letter cases. Name each platform once.\n\n`bad_request`: The shares do not add up to 100. Make the shares add up to exactly 100.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is not on Solana; only Solana trades are routed through platforms.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "only a solana launch routes its trades through a platform"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The body is not valid JSON, or a share is not a whole number from 0 to 255.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "A key of `routing` is not a platform that builds trades on Solana.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a routing names a platform this chain does not build trades on"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The same platform appears twice in `routing`, in different letter cases.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a routing names a platform twice"
                    }
                  },
                  "bad_request_6": {
                    "summary": "The shares do not add up to 100.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a routing's shares make 100"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Setting the same routing again stores the same value; `null` clears it."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#set-routing-override"
        }
      }
    },
    "/launch/set-funder/{launch_id}": {
      "post": {
        "operationId": "launches.set-launch-funder",
        "summary": "Set the launch funder",
        "description": "Replaces the funder wallet of a launch that hasn't launched yet.\n\nSolana launches only.\n\nNot called by the current web app.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkey": {
                    "type": "string",
                    "description": "Address of the new funder, one of your wallets."
                  }
                },
                "required": [
                  "pubkey"
                ]
              },
              "example": {
                "pubkey": "1SCVdnz5AsWbyy7MtiqYHH1upvvF2eVMGAVKTRuuUZd"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    }
                  }
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call this endpoint only for Solana launches.\n\n`bad_request`: `pubkey` is not a valid Solana address. Send the base58 address of one of your wallets.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`pubkey` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.\n\n`not_found`: `pubkey` is not a wallet of your license with a stored secret key. Use a wallet from [List wallets](/reference/wallets/#list-wallets) or [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "`pubkey` is not a wallet of your license with a stored secret key.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The current funder still holds SOL. Empty the current funder first, for example with [Execute a withdrawal](/reference/withdrawals/#execute-a-withdrawal).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The current funder still holds SOL.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Current funder wallet must be empty to change"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The launch is no longer a draft. This refusal is answered as a 500. Change the funder only before launching.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The launch is no longer a draft. This refusal is answered as a 500.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token already launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read `funder` with [Retrieve a launch](/reference/launches/#retrieve-launch) first: once the new funder holds SOL, a repeat answers 409 even though the change went through."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#set-launch-funder"
        }
      }
    },
    "/launch/add-wallets/{launch_id}": {
      "post": {
        "operationId": "launches.add-launch-wallets",
        "summary": "Add wallets to a launch",
        "description": "Adds generated or aged wallets to a launch as holders.\n\nNew wallets join the holder list with no planned buy. Aged wallets must be aged or archived ones from your wallets; archived wallets are reactivated.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount_to_generate": {
                    "type": "integer",
                    "description": "Number of new wallets to generate."
                  },
                  "aged_wallet_pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Addresses of aged wallets to add."
                  }
                }
              },
              "example": {
                "amount_to_generate": 5,
                "aged_wallet_pubkeys": [
                  "8DdaEAkMaV8pYhREgVSW2z2b3tdJHDMycS4ym839N3X9",
                  "71y96dRPCMak6VemQs2UrgErzzzPSU93PXcZsMqvEbTh"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "wallet_pubkeys": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Addresses of the wallets added."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "wallet_pubkeys": [
                    "8DdaEAkMaV8pYhREgVSW2z2b3tdJHDMycS4ym839N3X9",
                    "71y96dRPCMak6VemQs2UrgErzzzPSU93PXcZsMqvEbTh",
                    "1SCVdnz5AsWbyy7MtiqYHH1upvvF2eVMGAVKTRuuUZd"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: Neither `amount_to_generate` nor `aged_wallet_pubkeys` was sent. Send `amount_to_generate`, `aged_wallet_pubkeys`, or both.\n\n`bad_request`: `amount_to_generate` is over 500. A longer `aged_wallet_pubkeys` answers `aged_wallet_pubkeys cannot exceed 500`. Add at most 500 wallets per call.\n\n`bad_request`: Solana: an entry of `aged_wallet_pubkeys` is not a valid address (EVM: `Invalid aged wallet address`). A repeated entry answers `Duplicate aged wallet pubkey: <pubkey>`. Send each aged wallet address once.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Neither `amount_to_generate` nor `aged_wallet_pubkeys` was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Must provide amount_to_generate or aged_wallet_pubkeys"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`amount_to_generate` is over 500. A longer `aged_wallet_pubkeys` answers `aged_wallet_pubkeys cannot exceed 500`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "amount_to_generate cannot exceed 500"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Solana: an entry of `aged_wallet_pubkeys` is not a valid address (EVM: `Invalid aged wallet address`). A repeated entry answers `Duplicate aged wallet pubkey: <pubkey>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid aged wallet pubkey"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: An aged wallet is already part of this launch, in any role. Remove the wallets already on the launch from `aged_wallet_pubkeys`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "An aged wallet is already part of this launch, in any role.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Wallet <pubkey> already exists in this launch"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch would have more than 500 wallets across all roles. Add fewer wallets so the launch stays at 500 or fewer.\n\n`unprocessable`: An aged wallet is not one of your aged or archived wallets. Use aged wallets listed by [List wallets](/reference/wallets/#list-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch would have more than 500 wallets across all roles.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Exceeds maximum launch wallet count (500). Current: <current>, Adding: <adding>"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "An aged wallet is not one of your aged or archived wallets.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "One or more wallets are not available (not found or wrong type)"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: no plan was saved for the launch yet. This refusal is answered as a 500; EVM answers 400 `bad_request` with the same message. Save a plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: no plan was saved for the launch yet. This refusal is answered as a 500; EVM answers 400 `bad_request` with the same message.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch method saved"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat generates `amount_to_generate` more wallets, and aged wallets already added answer 409. Read the launch wallets with [Retrieve a launch](/reference/launches/#retrieve-launch) before sending it again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#add-launch-wallets"
        }
      }
    },
    "/launch/set-archive-status/{launch_id}": {
      "post": {
        "operationId": "launches.archive-launch",
        "summary": "Archive a launch",
        "description": "Archives or unarchives a launch.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "archived": {
                    "type": "boolean",
                    "description": "`true` to archive, `false` to restore."
                  }
                },
                "required": [
                  "archived"
                ]
              },
              "example": {
                "archived": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome. Sent for Solana launches only."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully set archive status"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Setting the same `archived` value again changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#archive-launch"
        }
      }
    },
    "/launch/delete-launch-plan/{launch_id}": {
      "post": {
        "operationId": "launches.delete-launch-plan",
        "summary": "Delete a launch plan",
        "description": "Deletes a launch before it is launched.\n\nAlso clears the automations planned for it (auto sell, auto buy, volume, cleanup and sniper guard) and revokes its share grants.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully deleted launch plan"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: the launch is no longer a draft. Delete plans only while the launch is a draft.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the launch is no longer a draft.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Token already launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch is no longer a draft. This refusal is answered as a 500. Delete plans only while the launch is a draft.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch is no longer a draft. This refusal is answered as a 500.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token already launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Deleting again clears a plan that is already empty."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#delete-launch-plan"
        }
      }
    },
    "/launch/reveal-key/{launch_id}": {
      "post": {
        "operationId": "launches.reveal-launch-keys",
        "summary": "Reveal launch keys",
        "description": "Returns the secret keys of the launch wallets you can export.\n\nThe dev key can be revealed by the launch owner; sub-wallet keys only by licenses that manage their keys. Wallets you can reveal carry `key.can_export` on the [Launch wallet](#object-launch-wallet). Every reveal is recorded in your history.\n\nTreat the response as sensitive: it contains private keys.\n\nThe challenge is for `keys.export` instead of `launch.reveal_key` when your account protects `keys.export`, the license manages its keys and no key unlock window is open; answering it opens the window.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Only reveal these wallets. Omit to reveal every exportable wallet. Up to 100."
                  }
                }
              },
              "example": {
                "pubkeys": [
                  "BZJTwe2bzzTQBwy5VQwwrhbzbMUbQoBZ59F9g3fUUtZU"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "keys": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "role": {
                            "type": "string",
                            "description": "Role of the wallet in the launch, such as `dev`."
                          },
                          "pubkey": {
                            "type": "string",
                            "description": "Wallet address."
                          },
                          "secret": {
                            "type": "string",
                            "description": "Secret key."
                          }
                        }
                      },
                      "description": "Revealed keys."
                    }
                  }
                },
                "example": {
                  "keys": [
                    {
                      "role": "dev",
                      "pubkey": "BZJTwe2bzzTQBwy5VQwwrhbzbMUbQoBZ59F9g3fUUtZU",
                      "secret": "<base58 secret key>"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `pubkeys` lists more than 300 keys. Ask for at most 300 keys per call.\n\n`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: The launch is an EVM multi-launch container. Reveal the keys on each member launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`pubkeys` lists more than 300 keys.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "too many pubkeys (<count>, max 300)"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch is an EVM multi-launch container.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: reveal keys on a member launch instead"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: Shared launch: a key in `pubkeys` is outside what the grant exports. A grant that exports no key answers `this share exports no key`. Ask only for the keys the grant lists in [List grants on a launch](/reference/launch-sharing/#list-grants).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "Shared launch: a key in `pubkeys` is outside what the grant exports. A grant that exports no key answers `this share exports no key`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "that key is not one this share exports"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.\n\n`not_found`: None of the launch wallets can be exported by you, or none matches `pubkeys`. Ask only for wallets that carry `key.can_export` in [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "None of the launch wallets can be exported by you, or none matches `pubkeys`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "no revealable wallets for this launch"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "launch.reveal_key",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Revealing again returns the same keys and records another reveal in history."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#reveal-launch-keys"
        }
      }
    },
    "/launch/get-metadata/{address}": {
      "get": {
        "operationId": "launches.retrieve-token-metadata",
        "summary": "Retrieve token metadata",
        "description": "Looks up the metadata of any token address, on every chain where it resolves.\n\nThe app uses it to prefill a clone or an import.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "description": "Token address (base58 mint or `0x` address).",
            "schema": {
              "type": "string"
            },
            "example": "HtSTV4r6EZBnJfTQkWLf1ZbTC8UjUxL9evrE67EmuzyF"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "chain_id": {
                            "type": "string",
                            "enum": [
                              "sol",
                              "eth",
                              "bsc",
                              "base",
                              "robinhood",
                              "monad",
                              "arc",
                              "xlayer"
                            ],
                            "description": "Chain of the token."
                          },
                          "dex": {
                            "type": "string",
                            "description": "Platform ID."
                          },
                          "launch_platform": {
                            "type": "string",
                            "description": "Platform name."
                          },
                          "name": {
                            "type": "string",
                            "description": "Token name."
                          },
                          "symbol": {
                            "type": "string",
                            "description": "Token ticker."
                          },
                          "image": {
                            "type": "string",
                            "description": "Image URL."
                          },
                          "description": {
                            "type": "string",
                            "description": "Description."
                          },
                          "twitter": {
                            "type": "string",
                            "description": "X (Twitter) link."
                          },
                          "telegram": {
                            "type": "string",
                            "description": "Telegram link."
                          },
                          "website": {
                            "type": "string",
                            "description": "Website link."
                          }
                        }
                      },
                      "description": "One entry per chain where the address resolves, shaped like the create-launch metadata."
                    }
                  }
                },
                "example": {
                  "results": [
                    {
                      "chain_id": "sol",
                      "dex": "pumpfun",
                      "launch_platform": "pumpfun",
                      "name": "Orbit Cat",
                      "symbol": "ORBIT",
                      "image": "https://ipfs.io/ipfs/bafkreigh2akiscaildcqabsyg3dfr6chu3fgpregiymsck7e7aqa4s52zy",
                      "description": "A cat in low orbit.",
                      "twitter": "https://x.com/orbitcat_sol",
                      "website": "https://orbitcat.xyz"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `address` is neither a Solana mint nor a `0x` address, or no chain returned metadata for it. A miss is remembered for 60 seconds. Check the address; for a token created moments ago, ask again after a minute.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`address` is neither a Solana mint nor a `0x` address, or no chain returned metadata for it. A miss is remembered for 60 seconds.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid token address or no metadata found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#retrieve-token-metadata"
        }
      }
    },
    "/launch/{source}/thesis/{launch_id}": {
      "get": {
        "operationId": "launches.retrieve-launch-thesis",
        "summary": "Retrieve the launch thesis feed",
        "description": "Lists the Fomoscan theses and callouts posted about the launch's token.\n\nOnly the launch owner can read it. The app shows the items as marks on the price chart and polls every 30 seconds.\n\nGated in the app by `THESIS_MARKS_ENABLED` in `src/config/chartFeatures.ts` (currently on).\n\nThe server caches each feed for 10 minutes.",
        "tags": [
          "Launches"
        ],
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "description": "Fomoscan feed to read.",
            "schema": {
              "type": "string",
              "enum": [
                "pumpfun",
                "fomo"
              ]
            },
            "example": "pumpfun"
          },
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "source": {
                      "type": "string",
                      "enum": [
                        "pumpfun",
                        "fomo"
                      ],
                      "description": "Feed that was read."
                    },
                    "mint": {
                      "type": "string",
                      "description": "Token address."
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Item ID."
                          },
                          "source": {
                            "type": "string",
                            "enum": [
                              "pumpfun",
                              "fomo"
                            ],
                            "description": "Feed the item came from."
                          },
                          "author_handle": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Author handle."
                          },
                          "author_name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Author display name."
                          },
                          "x_username": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Author X username."
                          },
                          "verified": {
                            "anyOf": [
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Author is verified."
                          },
                          "is_dev": {
                            "anyOf": [
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Author is the token's dev."
                          },
                          "text": {
                            "type": "string",
                            "description": "Thesis text."
                          },
                          "media_url": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Attached media."
                          },
                          "created_at": {
                            "type": "integer",
                            "description": "Creation time, in epoch milliseconds."
                          },
                          "likes": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Likes."
                          },
                          "mcap_at_call": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Market cap when the call was made (`pumpfun` only)."
                          },
                          "multiple": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Multiple realized since the call (`pumpfun` only)."
                          },
                          "pnl_usd": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Author profit and loss in USD (`fomo` only)."
                          },
                          "author_avatar_url": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Author avatar."
                          },
                          "token_image_url": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Token image (`fomo` only)."
                          }
                        }
                      },
                      "description": "Theses, normalized across both feeds. Fields a feed doesn't provide are `null`."
                    }
                  }
                },
                "example": {
                  "source": "pumpfun",
                  "mint": "HtSTV4r6EZBnJfTQkWLf1ZbTC8UjUxL9evrE67EmuzyF",
                  "items": [
                    {
                      "id": "th_7f3a91c2",
                      "source": "pumpfun",
                      "author_handle": "orbitwatcher",
                      "author_name": "Orbit Watcher",
                      "x_username": "orbitwatcher",
                      "verified": false,
                      "is_dev": false,
                      "text": "Clean chart, dev still holding. Watching the 50k level.",
                      "media_url": null,
                      "created_at": 1793196300000,
                      "likes": 14,
                      "mcap_at_call": 31250,
                      "multiple": 1.54,
                      "pnl_usd": null,
                      "author_avatar_url": null,
                      "token_image_url": null
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `source` is not `pumpfun` or `fomo`. Use `pumpfun` or `fomo` as `source`.\n\n`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`source` is not `pumpfun` or `fomo`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "source must be 'pumpfun' or 'fomo'"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The Fomoscan feed could not be read. A failure is cached for 5 minutes. Other causes read `fomoscan request failed` or `failed to parse fomoscan response`. The body adds `service`. Try again after 5 minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The Fomoscan feed could not be read. A failure is cached for 5 minutes. Other causes read `fomoscan request failed` or `failed to parse fomoscan response`. The body adds `service`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "fomoscan api issue: fomoscan returned an error"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call also keeps new items relayed on the realtime channel for 90 seconds; repeating it only extends that."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launches/#retrieve-launch-thesis"
        }
      }
    },
    "/launch/sol/ansem/config": {
      "get": {
        "operationId": "launch-platforms.retrieve-ansem-config",
        "summary": "Retrieve the Ansem config",
        "description": "Returns the costs and tier thresholds of a pump.fun Ansem launch.",
        "tags": [
          "Launch platforms"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "available": {
                      "type": "boolean",
                      "description": "Ansem launches can be created right now."
                    },
                    "funding_sol": {
                      "type": "string",
                      "description": "Funding required, in SOL. Number or numeric string."
                    },
                    "gas_sol": {
                      "type": "string",
                      "description": "Gas reserve, in SOL. Number or numeric string."
                    },
                    "airdrop_buy_sol": {
                      "type": "string",
                      "description": "Default airdrop buy, in SOL. Number or numeric string."
                    },
                    "airdrop_buy_min_sol": {
                      "type": "string",
                      "description": "Smallest airdrop buy, in SOL. Number or numeric string."
                    },
                    "airdrop_buy_max_sol": {
                      "type": "string",
                      "description": "Largest airdrop buy, in SOL. Number or numeric string."
                    },
                    "tier_thresholds": {
                      "type": "object",
                      "properties": {
                        "gold": {
                          "type": "string",
                          "description": "Gold tier threshold."
                        },
                        "diamond": {
                          "type": "string",
                          "description": "Diamond tier threshold."
                        }
                      },
                      "description": "Thresholds of the paid tiers."
                    },
                    "ansem_price_usd": {
                      "type": "string",
                      "description": "Price used for the thresholds, in USD. Number or numeric string."
                    }
                  }
                },
                "example": {
                  "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"
                }
              }
            }
          },
          "422": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The Ansem launchpad API could not be reached, answered an error or sent a config Proxima could not read. The body adds `service: \"ansem\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "ansem api issue: /config returned <status>: <body>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#retrieve-ansem-config"
        }
      }
    },
    "/launch/{chain_id}/otcdesks/rewards": {
      "get": {
        "operationId": "launch-platforms.list-otcdesks-rewards",
        "summary": "List OTC desk rewards",
        "description": "Lists the tokens an OTC desks launch can reward its holders in.\n\nPass 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.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rotation": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "mint": {
                            "type": "string",
                            "description": "Reward mint."
                          },
                          "symbol": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Symbol."
                          },
                          "basket_eligible": {
                            "type": "boolean",
                            "description": "Can be part of a basket."
                          },
                          "kind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "stock",
                                  "fund",
                                  "commodity",
                                  "private",
                                  "crypto"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Asset kind."
                          },
                          "company": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Company name."
                          },
                          "logo": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Logo URL."
                          },
                          "decimals": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Decimals."
                          }
                        }
                      },
                      "description": "Rewards on rotation."
                    },
                    "custom": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Other rewards, shaped like `rotation`."
                    },
                    "stocks": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Stock rewards, shaped like `rotation`."
                    },
                    "basket_min": {
                      "type": "integer",
                      "description": "Fewest mints in a basket."
                    },
                    "basket_max": {
                      "type": "integer",
                      "description": "Most mints in a basket."
                    }
                  }
                },
                "example": {
                  "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
                }
              }
            }
          },
          "400": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#list-otcdesks-rewards"
        }
      }
    },
    "/launch/{chain_id}/quote-tokens": {
      "get": {
        "operationId": "launch-platforms.list-quote-tokens",
        "summary": "List quote tokens",
        "description": "Lists the quote tokens a platform can pair a new token with.\n\nOnly Solana is served: the API answers `/launch/sol/quote-tokens`, and any other `chain_id` gets an empty `404`.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "platform",
            "in": "query",
            "required": true,
            "description": "Platform ID, for example `pumpfun` or `stonkfun`.",
            "schema": {
              "type": "string"
            },
            "example": "stonkfun"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "quotes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "mint": {
                            "type": "string",
                            "description": "Mint of the quote token."
                          },
                          "symbol": {
                            "type": "string",
                            "description": "Symbol."
                          },
                          "name": {
                            "type": "string",
                            "description": "Name."
                          },
                          "decimals": {
                            "type": "integer",
                            "description": "Decimals."
                          },
                          "token_program": {
                            "type": "string",
                            "description": "Token program that owns the mint."
                          },
                          "kind": {
                            "type": "string",
                            "enum": [
                              "crypto",
                              "rwa"
                            ],
                            "description": "Crypto asset or tokenized real-world asset."
                          },
                          "native": {
                            "type": "boolean",
                            "description": "The quote is the chain's native token."
                          },
                          "category": {
                            "type": "string",
                            "description": "Stonkfun shelf label. Absent when their catalog has not loaded."
                          },
                          "logo": {
                            "type": "string",
                            "description": "Absolute logo URL. Only for `platform=stonkfun`."
                          }
                        }
                      },
                      "description": "Accepted quote tokens."
                    }
                  }
                },
                "example": {
                  "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
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `platform` is not a Solana launch platform ID. Pass a Solana platform ID such as `pumpfun`, `meteoradbc` or `stonkfun`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`platform` is not a Solana launch platform ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Unknown launch platform"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "`platform` is `pumpfun` and pump.fun's quote config could not be read from the chain.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Failed to read Pumpfun quote config"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#list-quote-tokens"
        }
      }
    },
    "/launch/{chain_id}/quote-check": {
      "get": {
        "operationId": "launch-platforms.check-quote",
        "summary": "Check a quote token",
        "description": "Checks whether a token of your choosing can be used as the quote of a platform.\n\nSolana 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).",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query. Only `sol` is served.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "platform",
            "in": "query",
            "required": true,
            "description": "Platform the quote is checked for.",
            "schema": {
              "type": "string",
              "enum": [
                "pumpfun",
                "launchlab",
                "meteoradbc",
                "meteoradamm"
              ]
            },
            "example": "meteoradbc"
          },
          {
            "name": "mint",
            "in": "query",
            "required": true,
            "description": "Quote token to check.",
            "schema": {
              "type": "string"
            },
            "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          },
          {
            "name": "config",
            "in": "query",
            "required": false,
            "description": "`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.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "eligible": {
                      "type": "boolean",
                      "description": "The token can be the quote."
                    },
                    "mint": {
                      "type": "string",
                      "description": "Token checked."
                    },
                    "reason": {
                      "type": "string",
                      "description": "Why the token was refused. Only when `eligible` is `false`."
                    },
                    "asset": {
                      "type": "object",
                      "description": "The quote token, shaped like the items of [List quote tokens](#list-quote-tokens)."
                    },
                    "traits": {
                      "type": "object",
                      "properties": {
                        "taxed_bps": {
                          "type": "integer",
                          "description": "Transfer tax, in basis points."
                        },
                        "permanent_delegate": {
                          "type": "boolean",
                          "description": "The mint has a permanent delegate."
                        },
                        "freeze_authority": {
                          "type": "boolean",
                          "description": "The mint has a freeze authority."
                        }
                      },
                      "description": "Token traits."
                    },
                    "venue": {
                      "type": "object",
                      "description": "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": {
                      "type": "string",
                      "description": "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": {
                      "type": "object",
                      "properties": {
                        "quote_atoms": {
                          "type": "string",
                          "description": "Quote amount simulated, in base units."
                        },
                        "native_spent": {
                          "type": "string",
                          "description": "Native spent buying it, in base units."
                        },
                        "native_recovered": {
                          "type": "string",
                          "description": "Native recovered selling it back, in base units."
                        },
                        "loss_bps": {
                          "type": "integer",
                          "description": "Loss of the round trip, in basis points."
                        },
                        "max_loss_bps": {
                          "type": "integer",
                          "description": "Highest loss accepted, in basis points."
                        }
                      },
                      "description": "Simulated buy and sell of the quote with native, to measure the loss."
                    }
                  }
                },
                "example": {
                  "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
                  }
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`bad_request`: `mint` is not a valid Solana address. Send the quote token's mint address in base58.\n\n`bad_request`: `config` is not a valid Solana address. Send the config account address in base58, or leave `config` out.\n\n`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](#list-quote-tokens).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`mint` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "mint must be a pubkey"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`config` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "config must be a pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`platform` is not `pumpfun`, `launchlab`, `meteoradbc` or `meteoradamm`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<platform> takes no quote of the caller's choosing"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call reads the chain again; recording an accepted quote twice changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#check-quote"
        }
      }
    },
    "/launch/{chain_id}/pumpfun/quote-check": {
      "get": {
        "operationId": "launch-platforms.check-pumpfun-quote",
        "summary": "Check a pump.fun quote",
        "description": "Checks whether a token can be the quote of a pump.fun launch.\n\nA 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.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "mint",
            "in": "query",
            "required": true,
            "description": "Quote token to check.",
            "schema": {
              "type": "string"
            },
            "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "eligible": {
                      "type": "boolean",
                      "description": "The token can be the quote."
                    },
                    "mint": {
                      "type": "string",
                      "description": "Token checked. Only on refusals."
                    },
                    "reason": {
                      "type": "string",
                      "description": "Why the token was refused."
                    },
                    "listed": {
                      "type": "boolean",
                      "description": "pump.fun already lists the token as a quote."
                    },
                    "asset": {
                      "type": "object",
                      "description": "The quote token, shaped like the items of [List quote tokens](#list-quote-tokens)."
                    },
                    "quote_of_quote": {
                      "type": "string",
                      "description": "Unlisted only: the token the quote itself trades against."
                    },
                    "migrated": {
                      "type": "boolean",
                      "description": "Unlisted only: the quote's own market has migrated."
                    },
                    "opening_quote_reserve": {
                      "type": "string",
                      "description": "Unlisted only: opening quote reserve, in base units."
                    },
                    "graduation_raise": {
                      "type": "string",
                      "description": "Unlisted only: raise needed to graduate, in base units."
                    },
                    "round_trip": {
                      "type": "object",
                      "properties": {
                        "quote_atoms": {
                          "type": "string",
                          "description": "Quote amount simulated, in base units."
                        },
                        "native_spent": {
                          "type": "string",
                          "description": "Native spent buying it, in base units."
                        },
                        "native_recovered": {
                          "type": "string",
                          "description": "Native recovered selling it back, in base units."
                        },
                        "loss_bps": {
                          "type": "integer",
                          "description": "Loss of the round trip, in basis points."
                        },
                        "max_loss_bps": {
                          "type": "integer",
                          "description": "Highest loss accepted, in basis points."
                        }
                      },
                      "description": "Simulated buy and sell of the quote with native, to measure the loss."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "eligible": true,
                  "listed": true,
                  "asset": {
                    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                    "symbol": "USDC",
                    "name": "USD Coin",
                    "decimals": 6,
                    "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
                    "kind": "crypto",
                    "native": false
                  }
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`bad_request`: `mint` is not a valid Solana address. Send the quote token's mint address in base58.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`mint` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "mint must be a pubkey"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#check-pumpfun-quote"
        }
      }
    },
    "/launch/robinhood/flywheel/quote-check": {
      "get": {
        "operationId": "launch-platforms.check-flywheel-quote",
        "summary": "Check a Flywheel quote",
        "description": "Checks whether a token can be the quote of a Flywheel launch on Robinhood.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "mint",
            "in": "query",
            "required": true,
            "description": "Quote token address.",
            "schema": {
              "type": "string"
            },
            "example": "0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "eligible": {
                      "type": "boolean",
                      "description": "The token can be the quote."
                    },
                    "reason": {
                      "type": "string",
                      "description": "Why the token was refused. Only when `eligible` is `false`, and then `asset` and `graduation_threshold` are absent."
                    },
                    "asset": {
                      "type": "object",
                      "description": "The quote token: `mint`, `symbol`, `name`, `decimals`, `kind`, `native`."
                    },
                    "graduation_threshold": {
                      "type": "string",
                      "description": "Graduation threshold, in quote base units."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "eligible": true,
                  "asset": {
                    "mint": "0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c",
                    "symbol": "USDG",
                    "name": "Global Dollar",
                    "decimals": 6,
                    "kind": "crypto",
                    "native": false
                  },
                  "graduation_threshold": "25000000000"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `mint` is not a valid EVM address. Send the token's `0x` address.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`mint` is not a valid EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "mint must be an EVM address"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#check-flywheel-quote"
        }
      }
    },
    "/launch/{chain_id}/launchlab/platform": {
      "get": {
        "operationId": "launch-platforms.retrieve-launchlab-platform",
        "summary": "Retrieve a LaunchLab platform",
        "description": "Returns what a Raydium LaunchLab platform config allows, with the raise terms of each requested quote.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query. Only `sol` is served.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "config",
            "in": "query",
            "required": true,
            "description": "LaunchLab platform config account.",
            "schema": {
              "type": "string"
            },
            "example": "DkA5nngzxcYj2gDvnLfaYvURufYaB19AMV6QDASrecvT"
          },
          {
            "name": "quotes",
            "in": "query",
            "required": false,
            "description": "Comma-separated quote mints to price, at most 20 once duplicates are dropped. Without it, `quotes` comes back empty.",
            "schema": {
              "type": "string"
            },
            "example": "So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "platform_config": {
                      "type": "string",
                      "description": "Config checked."
                    },
                    "platform_fee_bps": {
                      "type": "integer",
                      "description": "Platform fee, in basis points."
                    },
                    "creator_fee_bps": {
                      "type": "integer",
                      "description": "Creator fee, in basis points."
                    },
                    "restricts_quotes": {
                      "type": "boolean",
                      "description": "The platform only admits some quotes."
                    },
                    "restricts_curve": {
                      "type": "boolean",
                      "description": "The platform fixes the curve."
                    },
                    "allowed_quotes": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quotes the platform admits; `null` when it admits any."
                    },
                    "quotes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "mint": {
                            "type": "string",
                            "description": "Quote mint."
                          },
                          "allowed": {
                            "type": "boolean",
                            "description": "The platform admits this quote."
                          },
                          "reason": {
                            "type": "string",
                            "description": "Why the quote is refused, such as `this platform does not allow this quote`. Only when `allowed` is `false`."
                          },
                          "raise": {
                            "type": "object",
                            "description": "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)."
                          }
                        }
                      },
                      "description": "Terms for each requested quote."
                    }
                  }
                },
                "example": {
                  "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
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`bad_request`: `config` is not a valid Solana address. Send the platform config account address in base58.\n\n`bad_request`: An entry of `quotes` is not a valid Solana address. Send base58 mint addresses separated by commas.\n\n`bad_request`: `quotes` names more than 20 distinct mints. Ask for at most 20 quotes per call.\n\n`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`config` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "config must be a pubkey"
                    }
                  },
                  "bad_request_3": {
                    "summary": "An entry of `quotes` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<quote> is not a pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`quotes` names more than 20 distinct mints.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "at most 20 quotes at once"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The platform config could not be read from the chain or is not a LaunchLab platform config. The message is the reader's reason.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<reason>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call reads the chain again; recording an accepted quote twice changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#retrieve-launchlab-platform"
        }
      }
    },
    "/launch/{chain_id}/meteoradbc/configs": {
      "get": {
        "operationId": "launch-platforms.list-dbc-configs",
        "summary": "List Meteora DBC configs",
        "description": "Lists usable Meteora DBC configs quoted in a given token.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query. Only `sol` is served.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "quote",
            "in": "query",
            "required": true,
            "description": "Quote mint. SOL and USDC are refused.",
            "schema": {
              "type": "string"
            },
            "example": "JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Most configs to return, from 1 to 100; values outside are clamped. The app sends `20`.",
            "schema": {
              "type": "integer",
              "default": "20"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "quote": {
                      "type": "string",
                      "description": "Quote mint."
                    },
                    "scanned": {
                      "type": "integer",
                      "description": "Configs scanned."
                    },
                    "configs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "config": {
                            "type": "string",
                            "description": "Config account."
                          },
                          "migration_quote_threshold": {
                            "type": "string",
                            "description": "Quote raised before migration, in base units."
                          },
                          "fee_bps": {
                            "type": "integer",
                            "description": "Trading fee, in basis points."
                          },
                          "migration_fee_option": {
                            "type": "integer",
                            "description": "Meteora migration fee option."
                          },
                          "locked_lp_bps": {
                            "type": "integer",
                            "description": "Share of LP locked at migration, in basis points."
                          },
                          "token_type": {
                            "type": "integer",
                            "description": "Meteora token type."
                          }
                        }
                      },
                      "description": "Usable configs."
                    }
                  }
                },
                "example": {
                  "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
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`bad_request`: `quote` is not a valid Solana address. Send the quote mint address in base58.\n\n`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain other than `sol`. An unrecognized slug answers `unknown chain_id: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this endpoint only supports sol, got <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`quote` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "quote must be a pubkey"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`quote` is SOL or USDC, which have too many configs to scan.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "SOL and USDC configs are listed by the picker, not here"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The scan of Meteora's DBC configs failed at the RPC. The body also carries `service: \"rpc\"`. Retry after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The scan of Meteora's DBC configs failed at the RPC. The body also carries `service: \"rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#list-dbc-configs"
        }
      }
    },
    "/launch/{chain_id}/flap/quotes": {
      "get": {
        "operationId": "launch-platforms.list-flap-quotes",
        "summary": "List Flap quotes",
        "description": "Lists the quote tokens a Flap launch can use, optionally for a given vault.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query. Flap runs on BSC, Robinhood and Arc.",
            "schema": {
              "type": "string",
              "enum": [
                "bsc",
                "robinhood",
                "arc"
              ]
            },
            "example": "bsc"
          },
          {
            "name": "vault_factory",
            "in": "query",
            "required": false,
            "description": "Vault factory the quotes must support.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "vault_kind",
            "in": "query",
            "required": false,
            "description": "Built-in vault kind the quotes must support.",
            "schema": {
              "type": "string",
              "enum": [
                "stocks",
                "buyback"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "chain_id": {
                      "type": "string",
                      "description": "Chain queried."
                    },
                    "vault_factory": {
                      "type": "string",
                      "description": "Vault factory checked."
                    },
                    "quotes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Quote token address; `null` for the native token."
                          },
                          "symbol": {
                            "type": "string",
                            "description": "Symbol."
                          },
                          "name": {
                            "type": "string",
                            "description": "Name."
                          },
                          "kind": {
                            "type": "string",
                            "enum": [
                              "crypto",
                              "rwa"
                            ],
                            "description": "Crypto asset or tokenized real-world asset."
                          },
                          "supported": {
                            "anyOf": [
                              {
                                "type": "boolean"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "The quote can be used with the requested vault."
                          }
                        }
                      },
                      "description": "Quote tokens."
                    }
                  }
                },
                "example": {
                  "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
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`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.\n\n`bad_request`: `vault_factory` is not an EVM address. Send the factory as a `0x`-prefixed 20-byte address.\n\n`bad_request`: `vault_kind` is neither `stocks` nor `buyback`. Set `vault_kind` to `stocks` or `buyback`, or pass `vault_factory` instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap is not deployed on <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`vault_factory` or `vault_kind` was sent on a chain where Flap vault launches are off (Arc).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap vault launches are not enabled on <chain_id>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`vault_factory` is not an EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "bad vault_factory: <reason>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`vault_kind` is neither `stocks` nor `buyback`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown vault_kind: <vault_kind>"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "A vault was named and the chain's RPC failed while reading which quotes its factory takes. The body adds `service: \"evm_rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_rpc api issue: <detail>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#list-flap-quotes"
        }
      }
    },
    "/launch/{chain_id}/flap/stocks": {
      "get": {
        "operationId": "launch-platforms.list-flap-stocks",
        "summary": "List Flap stock assets",
        "description": "Lists the tokenized stocks a Flap stocks vault can hold.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query. Flap runs on BSC, Robinhood and Arc.",
            "schema": {
              "type": "string",
              "enum": [
                "bsc",
                "robinhood",
                "arc"
              ]
            },
            "example": "bsc"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "chain_id": {
                      "type": "string",
                      "description": "Chain queried."
                    },
                    "assets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "type": "string",
                            "description": "Token address."
                          },
                          "name": {
                            "type": "string",
                            "description": "Name."
                          }
                        }
                      },
                      "description": "Stock tokens."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "chain_id": "bsc",
                  "assets": [
                    {
                      "address": "0xda8984160efb2fc27e207d259da92f381b9ef2a4",
                      "name": "Tesla xStock"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`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`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap is not deployed on <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Flap runs on this chain but its vault launches are off (Arc), so it has no stocks vault.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap vault launches are not enabled on <chain_id>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#list-flap-stocks"
        }
      }
    },
    "/launch/{chain_id}/flap/dividend-tokens": {
      "get": {
        "operationId": "launch-platforms.list-flap-dividend-tokens",
        "summary": "List Flap dividend tokens",
        "description": "Lists the tokens a Flap launch can pay dividends in, for a given quote.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query. Flap runs on BSC, Robinhood and Arc.",
            "schema": {
              "type": "string",
              "enum": [
                "bsc",
                "robinhood",
                "arc"
              ]
            },
            "example": "bsc"
          },
          {
            "name": "quote",
            "in": "query",
            "required": false,
            "description": "Quote token address. Omit for the native quote.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "chain_id": {
                      "type": "string",
                      "description": "Chain queried."
                    },
                    "quote": {
                      "type": "object",
                      "description": "The quote: `address` (`null` for native), `symbol`, `name`, `decimals`, `kind`, `native`."
                    },
                    "dividend_tokens": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "value": {
                            "type": "string",
                            "description": "`quote`, `self`, or a token address. Use it as the dividend token of the create params."
                          },
                          "symbol": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Symbol."
                          },
                          "name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Name."
                          },
                          "kind": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "crypto",
                                  "rwa"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Asset kind."
                          },
                          "supported": {
                            "type": "boolean",
                            "description": "Usable with this quote."
                          }
                        }
                      },
                      "description": "Dividend choices."
                    }
                  }
                },
                "example": {
                  "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
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`bad_request`: `quote` is not an EVM address. Send the quote as a `0x`-prefixed address, or omit it for the native quote.\n\n`bad_request`: `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).\n\n`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](/reference/launch-platforms/#list-flap-quotes).\n\n`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](/reference/launch-platforms/#list-flap-quotes).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap is not deployed on <chain_id>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`quote` is not an EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "quote token must be an address: <reason>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`quote` is not a quote token Proxima knows on this chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<quote> is not a known quote token on <chain_id>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`quote` is a known token that Flap does not take as a quote on this chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap does not support the <symbol> quote on <chain_id>"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`quote` was omitted on a chain where Flap takes no native quote.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap requires an explicit quote token on <chain_id>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#list-flap-dividend-tokens"
        }
      }
    },
    "/launch/{chain_id}/flap/vault-schema": {
      "get": {
        "operationId": "launch-platforms.retrieve-flap-vault-schema",
        "summary": "Retrieve a Flap vault schema",
        "description": "Returns the fields a Flap vault factory expects, with its standing and policies.\n\nPass either `factory` for a custom vault factory or `kind` for a built-in vault.",
        "tags": [
          "Launch platforms"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to query. Flap runs on BSC, Robinhood and Arc.",
            "schema": {
              "type": "string",
              "enum": [
                "bsc",
                "robinhood",
                "arc"
              ]
            },
            "example": "bsc"
          },
          {
            "name": "factory",
            "in": "query",
            "required": false,
            "description": "Vault factory address.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "Built-in vault kind.",
            "schema": {
              "type": "string",
              "enum": [
                "stocks",
                "buyback"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "chain_id": {
                      "type": "string",
                      "description": "Chain queried."
                    },
                    "factory": {
                      "type": "string",
                      "description": "Factory described."
                    },
                    "spec_version": {
                      "type": "string",
                      "description": "Schema version."
                    },
                    "description": {
                      "type": "string",
                      "description": "What the vault does."
                    },
                    "is_array": {
                      "type": "boolean",
                      "description": "The vault takes a list of entries."
                    },
                    "fields": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string",
                            "description": "Field name."
                          },
                          "type": {
                            "type": "string",
                            "description": "Solidity type."
                          },
                          "decimals": {
                            "type": "integer",
                            "description": "Decimals of numeric fields."
                          },
                          "description": {
                            "type": "string",
                            "description": "What the field is."
                          }
                        }
                      },
                      "description": "Fields to fill."
                    },
                    "standing": {
                      "type": "object",
                      "description": "Registry standing: `registered`, `official`, `risk_level`, `policy`, `policy_description`."
                    },
                    "policies": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Constraints on the fields: `target`, `operator`, `value`, `description`."
                    },
                    "quotes": {
                      "anyOf": [
                        {
                          "type": "array",
                          "items": {
                            "type": "object"
                          }
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quotes the vault supports, shaped like [List Flap quotes](#list-flap-quotes)."
                    }
                  }
                },
                "example": {
                  "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
                }
              }
            }
          },
          "400": {
            "description": "`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`.\n\n`bad_request`: `factory` is not an EVM address. Send the factory as a `0x`-prefixed 20-byte address.\n\n`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`.\n\n`bad_request`: Flap runs on this chain but its vault launches are off (Arc). Call it with `chain_id` set to `bsc` or `robinhood`.\n\n`bad_request`: The factory declares no schema. Check the factory address; a factory older than the vault spec cannot be configured through this form.\n\n`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "Neither `factory` nor a `kind` of `stocks` or `buyback` was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "pass factory=0x… , or kind=stocks|buyback for an official one"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`factory` is not an EVM address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "bad factory: <reason>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`chain_id` is a chain Flap does not run on. `sol` and unknown slugs answer `unknown chain: <chain_id>` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap is not deployed on <chain_id>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Flap runs on this chain but its vault launches are off (Arc).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "flap vault launches are not enabled on <chain_id>"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The factory declares no schema.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "factory <factory> declares no vaultDataSchema: <reason>"
                    }
                  },
                  "bad_request_6": {
                    "summary": "The vault factory registry or its policy could not be read for this factory. The policy read answers `vault factory policy read failed: <reason>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "vault factory registry read failed: <reason>"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The chain's RPC failed while reading the factory. The body adds `service: \"evm_rpc\"`. Retry in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The chain's RPC failed while reading the factory. The body adds `service: \"evm_rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_rpc api issue: <detail>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-platforms/#retrieve-flap-vault-schema"
        }
      }
    },
    "/launch/distribute/{launch_id}": {
      "post": {
        "operationId": "launch-execution.fund-launch-wallets",
        "summary": "Fund the launch wallets",
        "description": "Starts sending native from the funder to every wallet of the launch plan.\n\nOn Solana, and on EVM when the plan has a `funding_delay`, funding runs in the background after the call returns and the response carries its `funding_job_id`. On EVM with no delay, the transfers are sent before the call returns. For a `Cex` launch, `plan` lists the exchange sources to route through.",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "plan": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "IDs of the exchange sources to fund through. Sent only when non-empty."
                  },
                  "cex_provider": {
                    "type": "string",
                    "enum": [
                      "husher"
                    ],
                    "description": "Exchange route provider."
                  }
                }
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the funding started or nothing was needed."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome, for example `No funding needed` when every wallet is already at its target. Absent from an immediate EVM transfer."
                    },
                    "funding_job_id": {
                      "type": "string",
                      "description": "ID of the funding job started in the background. Absent when nothing was needed and from an immediate EVM transfer."
                    },
                    "tx_hash": {
                      "type": "string",
                      "description": "EVM with no `funding_delay`: hash of the first transfer."
                    },
                    "tx_hashes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "EVM with no `funding_delay`: hashes of every transfer, sent before the call returned."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "funding_job_id": "3f2b7c1e-8a4d-4f6b-9c2e-5d1a0b7e9f34",
                  "message": "Successfully started distribution"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: the token is already deployed. A staged scheduled launch can still fund its holders. Fund launch wallets before the launch; afterwards, move native with [Create a funding draft](/reference/funding/#create-a-funding-draft).\n\n`bad_request`: EVM: the saved plan has no wallet to fund. Add wallets to the plan with [Update the launch plan](/reference/launches/#update-launch-plan), then fund again.\n\n`bad_request`: A `Cex` launch was funded with no exchange in `plan`. Send at least one exchange in `plan`, chosen from [List funding sources](/reference/funding/#list-funding-sources).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the token is already deployed. A staged scheduled launch can still fund its holders.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token already launched"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the saved plan has no wallet to fund.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no wallets configured to fund"
                    }
                  },
                  "bad_request_4": {
                    "summary": "A `Cex` launch was funded with no exchange in `plan`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No cex kinds provided"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: the funder cannot cover the transfers plus its safety reserve. Nothing was sent. The existing typo is the API's. Top up the funder or lower the planned buys, then fund again.\n\n`unprocessable`: EVM: the node refused the transfers because the funder cannot pay for them. Top up the funder named in the message, check [Retrieve required funding](/reference/launch-funding/#get-required-funding), then fund again.\n\n`unprocessable`: Solana `Cex` launch: a wallet's amount is below the minimum of every exchange in `plan`. Add an exchange with a lower minimum to `plan` (see [List funding sources](/reference/funding/#list-funding-sources)) or raise the wallet's planned buy.\n\n`unprocessable`: Solana: a plan wallet's account was turned into a durable nonce or carries data, so it cannot send. The message lists each wallet with its role. Replace the listed wallets in the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and stop using their keys.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: the funder cannot cover the transfers plus its safety reserve. Nothing was sent. The existing typo is the API's.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Funder don't have enough funds"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "EVM: the node refused the transfers because the funder cannot pay for them.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "funder <funder> cannot cover this distribution (<amount> wei); top it up and retry"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "Solana `Cex` launch: a wallet's amount is below the minimum of every exchange in `plan`.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "At least one wallet's funding amount is below the minimum of every selected exchange"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "Solana: a plan wallet's account was turned into a durable nonce or carries data, so it cannot send. The message lists each wallet with its role.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Wallet cannot spend: <wallets>. Its account was turned into a durable nonce or carries data, so its key is compromised; replace it"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: a funding job started by an earlier call is still running. Wait for the running job to finish, then read [Retrieve required funding](/reference/launch-funding/#get-required-funding) before funding again.\n\n`internal_error`: Solana: no launch plan has been saved for this launch yet. Save a plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: a funding job started by an earlier call is still running.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funding already running"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: no launch plan has been saved for this launch yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch method saved"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat only tops up wallets still below target, but on EVM nothing refuses it while an earlier job is still sending, so the wallets can be funded twice. Read [Retrieve required funding](/reference/launch-funding/#get-required-funding) and the `funding.execute` event in [List a launch's activity events](/reference/history/#list-launch-events) first."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#fund-launch-wallets"
        }
      }
    },
    "/launch/sol/stoxes/prepare-config/{launch_id}": {
      "post": {
        "operationId": "launch-execution.prepare-stoxes-config",
        "summary": "Prepare a Stoxes config",
        "description": "Lands the per-token Stoxes config on Solana before an instant `Mev` launch.\n\nThe dev wallet pays the config rent. Calling it again after the config landed is safe and answers `already_landed: true` with only `ok`, `config` and `already_landed`.",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "config": {
                      "type": "string",
                      "description": "Stoxes config account."
                    },
                    "damm_config": {
                      "type": "string",
                      "description": "Meteora DAMM config account."
                    },
                    "token_decimals": {
                      "type": "integer",
                      "description": "Token decimals."
                    },
                    "already_landed": {
                      "type": "boolean",
                      "description": "The config existed before this call."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "config": "DkA5nngzxcYj2gDvnLfaYvURufYaB19AMV6QDASrecvT",
                  "damm_config": "GoLaX2BGrP7x3TXMxahjvPfRTeKsMDVd3vMhQT7y3X3x",
                  "token_decimals": 6,
                  "already_landed": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call this endpoint only for Solana launches.\n\n`bad_request`: The launch was not created on Stoxes. Call it only for launches created with `dex` set to `stoxes`.\n\n`bad_request`: The launch was imported: its market already has a config. Skip this step for imported launches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch was not created on Stoxes.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "This launch is not a stoxes launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch was imported: its market already has a config.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "An imported market already has its config"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.\n\n`not_found`: No launch plan has been saved for this launch yet. Save a plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "No launch plan has been saved for this launch yet.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No launch method saved"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Stoxes is not accepting launches right now. Retry later.\n\n`unprocessable`: The config did not finish, or Stoxes failed it. Other messages come from the same step, such as `the platform never read the config as finalized` or the platform's own failure reason. Call this endpoint again: it resumes from the step that did not finish.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Stoxes is not accepting launches right now.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "stoxes compact launch lookup is not ready"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The config did not finish, or Stoxes failed it. Other messages come from the same step, such as `the platform never read the config as finalized` or the platform's own failure reason.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the launch's config never finished"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Resumable: a repeat continues from the step where the previous call stopped, and once the config landed it answers `already_landed: true` without sending anything."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#prepare-stoxes-config"
        }
      }
    },
    "/launch/sol/lesgo/prepare-config/{launch_id}": {
      "post": {
        "operationId": "launch-execution.prepare-lesgo-config",
        "summary": "Prepare a Lesgo config",
        "description": "Lands the per-token Lesgo config on Solana before the launch.\n\nLesgo launches are being withdrawn: recent API builds no longer serve this route or the other `/launch/sol/lesgo/*` routes.\n\nCalling it again after the config landed is safe and answers `already_landed: true` with only `ok`, `config` and `already_landed`.",
        "tags": [
          "Launch execution"
        ],
        "deprecated": true,
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "config": {
                      "type": "string",
                      "description": "Lesgo config account."
                    },
                    "damm_config": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Meteora DAMM config account."
                    },
                    "pool": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Pool account."
                    },
                    "token_decimals": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Token decimals."
                    },
                    "already_landed": {
                      "type": "boolean",
                      "description": "The config existed before this call."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "config": "DkA5nngzxcYj2gDvnLfaYvURufYaB19AMV6QDASrecvT",
                  "damm_config": "GoLaX2BGrP7x3TXMxahjvPfRTeKsMDVd3vMhQT7y3X3x",
                  "pool": null,
                  "token_decimals": 6,
                  "already_landed": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call this endpoint only for Solana launches.\n\n`bad_request`: The launch was not created on Lesgo. Call it only for launches created with `dex` set to `lesgo`.\n\n`bad_request`: The launch was imported: its market already has a config. Skip this step for imported launches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch was not created on Lesgo.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "This launch is not a lesgo launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch was imported: its market already has a config.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "An imported market already has its config"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.\n\n`not_found`: No launch plan has been saved for this launch yet. Save a plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "No launch plan has been saved for this launch yet.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No launch method saved"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The config transaction was sent but did not land. Other messages come from the same step, such as `the lesgo config could not be sent: <reason>`. Call this endpoint again: it reads a config already on chain instead of creating a second one.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The config transaction was sent but did not land. Other messages come from the same step, such as `the lesgo config could not be sent: <reason>`.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the lesgo config transaction did not land"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Resumable: a repeat continues from the step where the previous call stopped, and once the config landed it answers `already_landed: true` without sending anything."
        },
        "x-proxima-stability": "deprecated",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#prepare-lesgo-config"
        }
      }
    },
    "/launch/{launch_id}": {
      "post": {
        "operationId": "launch-execution.launch",
        "summary": "Launch a token",
        "description": "Deploys the token and runs the launch plan, streaming progress.\n\nSend no body. On success the response is a server-sent event stream: each `data:` line carries a [Launch progress event](#object-launch-progress-event).\n\nAn `Allowlist` launch answers once with JSON `{\"ok\": true, \"launch_method\": \"Allowlist\"}` instead of a stream.\n\nWhen the metadata upload is unfinished or failed, the launch is refused with `code: media_not_ready` and a `media_state` of `pending` or `failed`; the SDK throws `MediaNotReadyError`.\n\nScript plans launch through the same path. See [Launch a script plan](/reference/launch-scripts/#launch-script-plan).",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "Streams Launch progress events, one `data:` line each.",
            "content": {
              "text/event-stream": {
                "example": [
                  {
                    "step": 1,
                    "total": 4,
                    "ok": true,
                    "message": "Uploading metadata"
                  },
                  {
                    "step": 2,
                    "total": 4,
                    "ok": true,
                    "message": "Token deployed",
                    "token_address": "HtSTV4r6EZBnJfTQkWLf1ZbTC8UjUxL9evrE67EmuzyF"
                  },
                  {
                    "step": 3,
                    "total": 4,
                    "ok": true,
                    "message": "Dev buy confirmed"
                  },
                  {
                    "step": 4,
                    "total": 4,
                    "ok": true,
                    "message": "Launch complete"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: the token is already deployed. Do not launch again; read the launch with [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the token is already deployed.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token already launched"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The launch has a script plan and your session has no script access. EVM answers `admin role required`. Launch script plans from an admin session, or save a regular plan with [Update the launch plan](/reference/launches/#update-launch-plan).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The launch has a script plan and your session has no script access. EVM answers `admin role required`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required: this launch's plan is a script"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: A launch of this token is already running. Do not launch again: follow the running launch in [List a launch's activity events](/reference/history/#list-launch-events).\n\n`conflict`: Solana: the wallets do not hold the plan's minimum funding. Fund the wallets with [Fund the launch wallets](/reference/launch-execution/#fund-launch-wallets) and launch once [Retrieve required funding](/reference/launch-funding/#get-required-funding) reports the funding in place.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "A launch of this token is already running.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Token is currently deploying"
                    }
                  },
                  "conflict_2": {
                    "summary": "Solana: the wallets do not hold the plan's minimum funding.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Funding not completed"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: the plan's `launch_method` is `Mev` on a platform that does not support it. Set `launch_method` to `Stagger` or `Manual` with [Update the launch plan](/reference/launches/#update-launch-plan).\n\n`unprocessable`: Solana: an instant `Mev` Stoxes launch whose per-token config is not on chain yet. Call [Prepare a Stoxes config](/reference/launch-execution/#prepare-stoxes-config), fund the wallets again with [Fund the launch wallets](/reference/launch-execution/#fund-launch-wallets), then launch.\n\n`unprocessable`: Solana: a Lesgo launch whose per-token config is not on chain yet. Call [Prepare a Lesgo config](/reference/launch-execution/#prepare-lesgo-config), fund the wallets again with [Fund the launch wallets](/reference/launch-execution/#fund-launch-wallets), then launch.\n\n`unprocessable`: Solana: a plan wallet's account was turned into a durable nonce or carries data, so it cannot send. The message lists each wallet with its role. Replace the listed wallets in the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and stop using their keys.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: the plan's `launch_method` is `Mev` on a platform that does not support it.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "This platform owns its opening block: its launches are stagger or manual"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Solana: an instant `Mev` Stoxes launch whose per-token config is not on chain yet.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Stoxes block0 needs its config on chain first: POST /launch/sol/stoxes/prepare-config/{id}, then fund again"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "Solana: a Lesgo launch whose per-token config is not on chain yet.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Lesgo needs its config on chain first: POST /launch/sol/lesgo/prepare-config/{id}, then fund again"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "Solana: a plan wallet's account was turned into a durable nonce or carries data, so it cannot send. The message lists each wallet with its role.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Wallet cannot spend: <wallets>. Its account was turned into a durable nonce or carries data, so its key is compromised; replace it"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is already deployed. Do not launch again; read the launch with [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`internal_error`: Solana: no launch plan has been saved for this launch yet. Save a plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is already deployed.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token already launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: no launch plan has been saved for this launch yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch method saved"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A launch never deploys twice: a repeat is refused while it runs and once the token is deployed. After a dropped stream, read `launch_status` in [List the license's launches](/reference/licenses/#list-mints) and the deploy events in [List a launch's activity events](/reference/history/#list-launch-events) before launching again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#launch"
        }
      }
    },
    "/snipe/{launch_id}": {
      "post": {
        "operationId": "launch-execution.snipe-launch",
        "summary": "Snipe a scheduled launch",
        "description": "Runs the buys of a scheduled launch whose token is already deployed, streaming progress.\n\nFor launches saved with `scheduled_mode`. The bundle runs without the deploy and dev buy, which already happened. On Solana the snipe can also fire on its own after `auto_snipe_delay_ms`.",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "Streams Launch progress events, one `data:` line each.",
            "content": {
              "text/event-stream": {
                "example": [
                  {
                    "step": 1,
                    "total": 2,
                    "ok": true,
                    "message": "Holder buys sent"
                  },
                  {
                    "step": 2,
                    "total": 2,
                    "ok": true,
                    "message": "Snipe complete"
                  }
                ]
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: the launch is not a scheduled launch waiting to be sniped. Snipe only a `scheduled_mode` launch whose `launch_status` in [List the license's launches](/reference/licenses/#list-mints) is `Staged`.\n\n`bad_request`: EVM: the plan has no holder wallet to buy with. Add holders to the plan with [Update the launch plan](/reference/launches/#update-launch-plan).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the launch is not a scheduled launch waiting to be sniped.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch is not staged for snipe"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the plan has no holder wallet to buy with.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no holder wallets to snipe"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: a launch or snipe of this token is already running. EVM answers `snipe already running`. Do not snipe again: follow the running one in [List a launch's activity events](/reference/history/#list-launch-events).\n\n`conflict`: Solana: the holder wallets do not hold their minimum funding. EVM answers `Holder funding not completed`, or `Launch funding not completed` on a pons `Mev` launch. Fund the wallets with [Fund the launch wallets](/reference/launch-execution/#fund-launch-wallets), then snipe.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: a launch or snipe of this token is already running. EVM answers `snipe already running`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Token is currently deploying"
                    }
                  },
                  "conflict_2": {
                    "summary": "Solana: the holder wallets do not hold their minimum funding. EVM answers `Holder funding not completed`, or `Launch funding not completed` on a pons `Mev` launch.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Subs funding not completed"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: the launch has a script plan, which snipes as part of its own run. Run it with [Launch a script plan](/reference/launch-scripts/#launch-script-plan).\n\n`unprocessable`: Solana: allowlist launches are never sniped. Follow the allowlist run with [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status) instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: the launch has a script plan, which snipes as part of its own run.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "This launch's plan is a script: POST /launch/{ext_id} runs it"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Solana: allowlist launches are never sniped.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "an allowlist launch is never sniped: its curve admits only its own wallets"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch is not a scheduled launch waiting to be sniped, for example because it was already sniped. Snipe only a `scheduled_mode` launch whose `launch_status` in [List the license's launches](/reference/licenses/#list-mints) is `Staged`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch is not a scheduled launch waiting to be sniped, for example because it was already sniped.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Cannot execute snipe on this current launch"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A snipe runs once: as soon as it starts, the launch leaves `Staged` and a repeat is refused. After a dropped stream, read `launch_status` in [List the license's launches](/reference/licenses/#list-mints) and the buys in [List a launch's activity events](/reference/history/#list-launch-events)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#snipe-launch"
        }
      }
    },
    "/tracker/deploy/{chain_id}/{dex}": {
      "post": {
        "operationId": "launch-execution.tracker-deploy",
        "summary": "Deploy from the X tracker",
        "description": "Creates the token, saves its launch plan and launches it in one request.\n\nUsed by the admin X tracker. The body is the [create-launch](/reference/launches/#create-launch) metadata plus a `plan` part. The response is an event stream once the upload is accepted: stage events report each phase and are interleaved with [Launch progress events](#object-launch-progress-event).\n\nStages: `created` (with `launch_id`), `planned`, `media`, `short` (some wallets lack funds; the stream ends) and `error` (with `message`).\n\nEvery other metadata part of [Create a launch](/reference/launches/#create-launch) is sent the same way.\n\nA refusal before the stream starts answers JSON with a `message`.",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain to deploy on. The tracker uses `sol`.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "dex",
            "in": "path",
            "required": true,
            "description": "Launch platform ID in lowercase, for example `pumpfun`, `bonkfun`, `meteoradbc`, `fourmeme`, `flap` or `uniswapv2`.",
            "schema": {
              "type": "string"
            },
            "example": "pumpfun"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Token name."
                  },
                  "symbol": {
                    "type": "string",
                    "description": "Token ticker."
                  },
                  "image": {
                    "type": "string",
                    "format": "binary",
                    "description": "Token image."
                  },
                  "plan": {
                    "type": "string",
                    "description": "Launch plan as JSON, shaped like the body of [Update the launch plan](/reference/launches/#update-launch-plan)."
                  },
                  "tracker": {
                    "type": "string",
                    "description": "`true`: the launch comes from the X tracker."
                  },
                  "description": {
                    "type": "string",
                    "description": "Token description."
                  }
                },
                "required": [
                  "name",
                  "symbol",
                  "image",
                  "plan"
                ]
              },
              "example": {
                "name": "Orbit Cat",
                "symbol": "ORBIT",
                "image": "(binary orbit-cat.png)",
                "tracker": "true",
                "plan": "{\"launch_method\":\"Stagger\",\"buy_delay\":0,\"dev\":{\"key\":\"None\",\"buy_native\":\"500000000\"},\"holder\":[]}"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Streams stage events, then Launch progress events.",
            "content": {
              "text/event-stream": {
                "example": [
                  {
                    "stage": "created",
                    "launch_id": 101250846193377
                  },
                  {
                    "stage": "planned"
                  },
                  {
                    "stage": "media"
                  },
                  {
                    "step": 1,
                    "total": 3,
                    "ok": true,
                    "message": "Token deployed",
                    "token_address": "HtSTV4r6EZBnJfTQkWLf1ZbTC8UjUxL9evrE67EmuzyF"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat creates and launches a second token. If the stream dropped, look for the new launch in [List the license's launches](/reference/licenses/#list-mints) (the `created` stage carries its `launch_id`) before deploying again."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#tracker-deploy"
        }
      }
    },
    "/launch/streamflow/resume/{launch_id}": {
      "post": {
        "operationId": "launch-execution.resume-streamflow-airdrop",
        "summary": "Resume a Streamflow airdrop",
        "description": "Resumes the Streamflow airdrop of an `airdrop` MEV launch on Solana.\n\nSafe to call again: wallets already claimed are skipped. The SDK waits up to 120 seconds for the answer.",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`false` when at least one wallet failed to claim. The status is still 200."
                    },
                    "distributor": {
                      "type": "string",
                      "description": "Streamflow distributor account."
                    },
                    "claimed": {
                      "type": "integer",
                      "description": "Wallets claimed in this run."
                    },
                    "skipped": {
                      "type": "integer",
                      "description": "Wallets skipped, already claimed."
                    },
                    "failed": {
                      "type": "integer",
                      "description": "Wallets that failed to claim."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "distributor": "ANMQCTKS1HJC1gwbMGo1r62E1PLwWCXBGgZzvKvQcZY",
                  "claimed": 12,
                  "skipped": 30,
                  "failed": 0
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: The launch is not on Solana. Call this endpoint only for Solana `airdrop` launches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is not on Solana.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "streamflow resume not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Direct airdrop: no holder has a target supply. Check the holders' planned amounts with [Retrieve a launch](/reference/launches/#retrieve-launch); there is nothing to resume.\n\n`unprocessable`: Airdrop through temporary holders: no temporary holder has a target supply. Check the temporary holders with [Retrieve a launch](/reference/launches/#retrieve-launch); there is nothing to resume.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Direct airdrop: no holder has a target supply.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "launch has no holders with a target supply"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Airdrop through temporary holders: no temporary holder has a target supply.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "launch has no temp holders with a target supply"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Idempotent: wallets that already claimed are counted in `skipped` and receive nothing more."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#resume-streamflow-airdrop"
        }
      }
    },
    "/launch/get-mev-contract/{launch_id}": {
      "get": {
        "operationId": "launch-execution.list-mev-contracts",
        "summary": "List MEV contracts",
        "description": "Lists the MEV proxy contracts of an EVM launch with their balances.\n\nEVM launches only. The app polls it every 5 seconds on BSC `Mev` launches.",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "mev_contracts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "type": "string",
                            "description": "Proxy contract address."
                          },
                          "role": {
                            "type": "string",
                            "enum": [
                              "front_mev",
                              "temp_holder"
                            ],
                            "description": "Wallet role the proxy serves."
                          },
                          "owner": {
                            "type": "string",
                            "description": "Wallet that owns the proxy."
                          },
                          "token_balance": {
                            "type": "string",
                            "description": "Token balance in base units."
                          },
                          "native_balance": {
                            "type": "string",
                            "description": "Native balance in wei."
                          }
                        }
                      },
                      "description": "Proxy contracts of the launch. Empty when it has none."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "mev_contracts": [
                    {
                      "address": "0x959dadb30ec13dd11052df859f2663f43eeab12a",
                      "role": "front_mev",
                      "owner": "0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c",
                      "token_balance": "18250000000000000000000000",
                      "native_balance": "0"
                    },
                    {
                      "address": "0xcce967904e6db57ae72838ba12b60ccc1f76081c",
                      "role": "temp_holder",
                      "owner": "0xda8984160efb2fc27e207d259da92f381b9ef2a4",
                      "token_balance": "0",
                      "native_balance": "1200000000000000"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: The launch is on Solana, which has no MEV proxy contracts. Call this endpoint only for EVM launches.\n\n`bad_request`: The token is not deployed yet, so it has no proxies. Call it after the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is on Solana, which has no MEV proxy contracts.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "get-mev-contract not supported for sol"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The token is not deployed yet, so it has no proxies.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#list-mev-contracts"
        }
      }
    },
    "/launch/rescue-mev-contract/{launch_id}": {
      "post": {
        "operationId": "launch-execution.rescue-mev-contracts",
        "summary": "Rescue MEV contracts",
        "description": "Moves the tokens and native left in the MEV proxy contracts back to their owners.\n\nTokens that can be transferred freely are sent back; tokens still on a bonding curve are sold through the proxy, then the native is swept to the owner.\n\nEVM launches only.",
        "tags": [
          "Launch execution"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`. A proxy whose send failed is skipped, not reported."
                    },
                    "rescued": {
                      "type": "integer",
                      "description": "Proxies whose tokens were sent back or sold."
                    },
                    "rescued_native": {
                      "type": "integer",
                      "description": "Proxies whose native was swept to the dev wallet."
                    },
                    "strategy": {
                      "type": "string",
                      "enum": [
                        "direct_transfer",
                        "mev_sell_then_sweep"
                      ],
                      "description": "`direct_transfer` when the token transfers freely, `mev_sell_then_sweep` when it is still on a bonding curve."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "rescued": 2,
                  "rescued_native": 3,
                  "strategy": "mev_sell_then_sweep"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: The launch is on Solana, which has no MEV proxy contracts. Call this endpoint only for EVM launches.\n\n`bad_request`: The token is not deployed yet, so it has no proxies. Call it after the launch.\n\n`bad_request`: The launch has no MEV or temporary holder wallets. Nothing to rescue: only launches with front MEV or temporary holder wallets have proxies.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is on Solana, which has no MEV proxy contracts.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "rescue-mev-contract not supported for sol"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The token is not deployed yet, so it has no proxies.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The launch has no MEV or temporary holder wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no MEV or temp_holder wallets"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat only sends for proxies that still hold tokens or native, so value is never moved twice. Read what is left with [List MEV contracts](/reference/launch-execution/#list-mev-contracts)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-execution/#rescue-mev-contracts"
        }
      }
    },
    "/launch/quote/{launch_id}": {
      "post": {
        "operationId": "launch-trading.quote-launch-trade",
        "summary": "Quote a trade",
        "description": "Simulates buys or sells of the launch token for one or more amounts.\n\nReturns one leg per amount, in the same order. The app refreshes it every 5 seconds while a trade form is open.\n\nWhen every amount is zero the SDK answers zero legs locally without calling the API.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "direction": {
                    "type": "string",
                    "enum": [
                      "buy",
                      "sell"
                    ],
                    "description": "Buy or sell the token."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "exact_in",
                      "exact_out"
                    ],
                    "description": "`exact_in` quotes what an input amount returns; `exact_out` what an output amount costs."
                  },
                  "amounts": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Amounts to quote, in base units, as integer strings."
                  }
                },
                "required": [
                  "direction",
                  "mode",
                  "amounts"
                ]
              },
              "example": {
                "direction": "buy",
                "mode": "exact_in",
                "amounts": [
                  "100000000",
                  "500000000",
                  "1000000000"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns a JSON array of legs.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "number",
                        "description": "Resulting amount, in base units. EVM launches answer it as an integer string."
                      },
                      "price_impact": {
                        "type": "number",
                        "description": "Price impact of the trade."
                      },
                      "mcap_change_bps": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Market cap change, in basis points."
                      }
                    }
                  }
                },
                "example": [
                  {
                    "amount": 3412095512331,
                    "price_impact": 0.41,
                    "mcap_change_bps": 82
                  },
                  {
                    "amount": 16801447209012,
                    "price_impact": 2.03,
                    "mcap_change_bps": 412
                  },
                  {
                    "amount": 32790051733240,
                    "price_impact": 4.1,
                    "mcap_change_bps": 838
                  }
                ]
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: Solana: a buy was quoted in `exact_out` mode. Quote buys with `exact_in`.\n\n`bad_request`: EVM: `exact_out` is not supported in either direction. Quote with `exact_in` on EVM launches.\n\n`bad_request`: EVM: an entry of `amounts` is not a base-10 integer string. One above 2^128 answers `amount too large`. Send each amount as an integer string of base units, below 2^128.\n\n`bad_request`: EVM: the token is not deployed yet. Quote once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: a buy was quoted in `exact_out` mode.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "buy/exact_out not supported"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: `exact_out` is not supported in either direction.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "exact_out not supported on EVM"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: an entry of `amounts` is not a base-10 integer string. One above 2^128 answers `amount too large`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid amount"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: no sell amount could be priced, and the message is the venue's reason. When only some fail, those legs answer an `amount` of `0`. Read the venue's reason in the message, then quote again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: no sell amount could be priced, and the message is the venue's reason. When only some fail, those legs answer an `amount` of `0`.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "<reason>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Quote once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A pure read sent as POST: it prices the amounts and sends nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#quote-launch-trade"
        }
      }
    },
    "/launch/buyback/info/{launch_id}": {
      "post": {
        "operationId": "launch-trading.retrieve-buyback-max",
        "summary": "Retrieve the buyback maximum",
        "description": "Returns the most the selected wallets can spend on a buyback.\n\n`max_buy_amount` can exceed the JSON safe integer range; the SDK reads it as a string to keep every digit.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallet_sources": {
                    "type": "object",
                    "properties": {
                      "include_dev": {
                        "type": "boolean",
                        "description": "Include the dev wallet."
                      },
                      "include_mev": {
                        "type": "boolean",
                        "description": "Include the MEV wallets."
                      },
                      "include_holders": {
                        "type": "boolean",
                        "description": "Include the holder wallets."
                      }
                    },
                    "description": "Wallets to use: either flags `include_dev`, `include_mev` and `include_holders`, or an array of wallet addresses."
                  }
                }
              },
              "example": {
                "wallet_sources": {
                  "include_dev": false,
                  "include_mev": true,
                  "include_holders": true
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "max_buy_amount": {
                      "type": "string",
                      "description": "Largest buyback, in quote base units. Solana launches answer it as a number."
                    },
                    "eligible_wallet_count": {
                      "type": "integer",
                      "description": "Wallets able to buy."
                    }
                  }
                },
                "example": {
                  "max_buy_amount": "7412500000",
                  "eligible_wallet_count": 18
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: the token is not deployed yet. Call it once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Call it once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A pure read sent as POST: it reads the wallets' balances and sends nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#retrieve-buyback-max"
        }
      }
    },
    "/launch/buyback/{launch_id}": {
      "post": {
        "operationId": "launch-trading.buyback",
        "summary": "Buy back the token",
        "description": "Buys the launch token with several launch wallets at once.\n\nThe amount is split across the selected wallets according to `selection_mode`, `dispersion` and `distribution`, then executed one after the other or in parallel. Use [Retrieve the buyback maximum](#retrieve-buyback-max) to size it.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string",
                    "description": "Quote to spend in total, in base units, as an integer string. `0` spends everything available."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance, in basis points."
                  },
                  "selection_mode": {
                    "type": "string",
                    "enum": [
                      "random",
                      "low_tokens",
                      "high_tokens"
                    ],
                    "description": "Which wallets buy first.",
                    "default": "random"
                  },
                  "dispersion": {
                    "type": "integer",
                    "description": "How many of the selected wallets buy, from `0` (fewest) to `100` (all)."
                  },
                  "distribution": {
                    "type": "string",
                    "description": "How the amount is split: `equal`, `weighted`, or `{\"random\": {\"deviation_pct\"}}` (deviation defaults to 20).",
                    "default": "equal"
                  },
                  "execution": {
                    "type": "object",
                    "properties": {
                      "mode": {
                        "type": "string",
                        "enum": [
                          "stagger",
                          "parallel"
                        ],
                        "description": "One after the other, or all at once."
                      },
                      "delay_ms": {
                        "type": "integer",
                        "description": "`stagger` only: delay between buys, in milliseconds.",
                        "default": "1000"
                      }
                    },
                    "description": "How the buys are sent.",
                    "default": "stagger"
                  },
                  "fake_tip_pct": {
                    "type": "number",
                    "description": "Not used to build the trades. EVM refuses a value above 100; Solana ignores it. The app sends `0`."
                  },
                  "wallet_sources": {
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "include_dev": {
                            "type": "boolean",
                            "description": "Include the dev wallet."
                          },
                          "include_mev": {
                            "type": "boolean",
                            "description": "Include the MEV wallets."
                          },
                          "include_holders": {
                            "type": "boolean",
                            "description": "Include the holder wallets."
                          }
                        }
                      },
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    ],
                    "description": "Wallets to use: either flags `include_dev`, `include_mev` and `include_holders`, or an array of wallet addresses."
                  },
                  "terminal": {
                    "type": "string",
                    "enum": [
                      "direct",
                      "axiom",
                      "padre",
                      "gmgn"
                    ],
                    "description": "Sent by the SDK, not read by the API."
                  },
                  "routing": {
                    "type": "object",
                    "description": "Sent by the SDK, not read by the API."
                  }
                },
                "required": [
                  "amount",
                  "slippage"
                ]
              },
              "example": {
                "amount": "2500000000",
                "slippage": 1500,
                "selection_mode": "random",
                "distribution": "equal",
                "execution": {
                  "mode": "stagger",
                  "delay_ms": 1000
                },
                "fake_tip_pct": 0,
                "wallet_sources": [
                  "HBwqDp7Qpmzos1wZhr5ZpwfsedZFGHubfdibhHBeH47Z",
                  "GwjXHJRZCrZjmRTzfuBCFkeuMmy6PxNMET4cPSmsvahJ"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when at least one buy landed. On Solana a buyback where every buy failed still answers 200, with `ok: false`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "total_wallets": {
                      "type": "integer",
                      "description": "Wallets used."
                    },
                    "successful": {
                      "type": "integer",
                      "description": "Buys that landed."
                    },
                    "failed": {
                      "type": "integer",
                      "description": "Buys that failed."
                    },
                    "total_token_bought": {
                      "type": "number",
                      "description": "Tokens bought, in base units."
                    },
                    "total_quote_spent": {
                      "type": "number",
                      "description": "Quote spent, in base units."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Buyback completed: 2 successful, 0 failed",
                  "total_wallets": 2,
                  "successful": 2,
                  "failed": 0,
                  "total_token_bought": 81244031872,
                  "total_quote_spent": 2500000000
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: `slippage` is above 10000 basis points. A stagger `delay_ms` above 60000 answers `Stagger delay cannot exceed 60000ms`, and a `fake_tip_pct` above 100 answers `fake_tip_pct must be between 0 and 100`. Keep `slippage` at most 10000, `delay_ms` at most 60000 and `fake_tip_pct` at most 100.\n\n`bad_request`: EVM: the token is not deployed yet. Buy back once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: `amount` is more than the selected wallets can spend. Size `amount` with [Retrieve the buyback maximum](/reference/launch-trading/#retrieve-buyback-max), or send `0` to spend everything available.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: `slippage` is above 10000 basis points. A stagger `delay_ms` above 60000 answers `Stagger delay cannot exceed 60000ms`, and a `fake_tip_pct` above 100 answers `fake_tip_pct must be between 0 and 100`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Slippage cannot exceed 10000 (100%)"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`amount` is more than the selected wallets can spend.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Requested amount <amount> exceeds total available <total>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: `wallet_sources` selects no wallet of the launch. Select at least one of the launch's wallets in `wallet_sources`, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`unprocessable`: None of the selected wallets has quote left to spend. Fund the wallets or select others, then size the buy with [Retrieve the buyback maximum](/reference/launch-trading/#retrieve-buyback-max).\n\n`unprocessable`: The split gave none of the selected wallets a share of `amount`. Raise `amount` or `dispersion`, then buy again.\n\n`upstream_failure`: EVM: every buy reverted. Without a reason from the sender the message ends `all buybacks reverted`. The `buy` activity event is still written. Check the reason and the wallets' balances in [Retrieve a launch](/reference/launches/#retrieve-launch) before buying again.\n\n`unprocessable`: EVM: every buy was refused for lack of gas. The message names the dev wallet even when the buying wallets are the ones short. Top up the buying wallets' gas, then buy again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "`wallet_sources` selects no wallet of the launch.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No wallets available for buyback"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "None of the selected wallets has quote left to spend.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No eligible wallets available"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "The split gave none of the selected wallets a share of `amount`.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No wallets selected for buyback"
                    }
                  },
                  "upstream_failure": {
                    "summary": "EVM: every buy reverted. Without a reason from the sender the message ends `all buybacks reverted`. The `buy` activity event is still written.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_tx_engine api issue: <reason>"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "EVM: every buy was refused for lack of gas. The message names the dev wallet even when the buying wallets are the ones short.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "dev wallet <address> has insufficient native balance to pay gas; fund it and retry"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: `slippage` is above 10000 basis points. A stagger `delay_ms` above 60000 answers `Stagger delay cannot exceed 60000ms`. Keep `slippage` at most 10000 and `delay_ms` at most 60000.\n\n`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Buy back once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: `slippage` is above 10000 basis points. A stagger `delay_ms` above 60000 answers `Stagger delay cannot exceed 60000ms`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Slippage cannot exceed 10000 (100%)"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Nothing refuses a repeat, so it buys again. Look for the `buy` event the call writes in [List a launch's activity events](/reference/history/#list-launch-events) before sending it again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#buyback"
        }
      }
    },
    "/launch/sell-dev-supply/{launch_id}": {
      "post": {
        "operationId": "launch-trading.sell-dev-supply",
        "summary": "Sell the dev supply",
        "description": "Sells tokens from the dev wallet.\n\nWhen the dev holds nothing, the call answers 200 with the message `No tokens to sell`.\n\nThe SDK types also accept `terminal` and `routing`, but does not send them.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token_amount": {
                    "type": "string",
                    "description": "Tokens to sell, in base units, as an integer string. `0` sells the whole balance."
                  },
                  "quote_target": {
                    "type": "string",
                    "description": "Quote to receive, in base units, as an integer string. Use instead of `token_amount`, not both."
                  },
                  "fake_tip": {
                    "type": "boolean",
                    "description": "Sent by the app, not read by the API."
                  }
                }
              },
              "example": {
                "token_amount": "0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "token_sold": {
                      "type": "number",
                      "description": "Tokens sold, in base units."
                    },
                    "quote_received": {
                      "type": "number",
                      "description": "Quote received, in base units."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully sold",
                  "token_sold": 17241379310344,
                  "quote_received": 612004118
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: Solana: `token_amount` and `quote_target` were both sent. Send only one of `token_amount` and `quote_target`.\n\n`bad_request`: EVM: a non-zero `quote_target` was sent. EVM sales take a token amount only. Pass `token_amount` instead, sized with [Quote a trade](/reference/launch-trading/#quote-launch-trade) if you target a quote amount.\n\n`bad_request`: EVM: the token is not deployed yet. Sell once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: the dev wallet is watch-only and cannot sign. A launch with no dev wallet answers `no dev wallet configured`. Sell the dev supply only on launches whose dev wallet key Proxima holds.\n\n`bad_request`: EVM: `token_amount` is more than the dev wallet holds. Lower `token_amount`, or send `0` to sell the whole balance.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `token_amount` and `quote_target` were both sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token_amount and quote_target are mutually exclusive"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: a non-zero `quote_target` was sent. EVM sales take a token amount only.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "quote_target is not supported on evm launches; pass token_amount"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the dev wallet is watch-only and cannot sign. A launch with no dev wallet answers `no dev wallet configured`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev wallet is watched, cannot sign"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: `token_amount` is more than the dev wallet holds.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "amount <requested> exceeds dev balance <balance>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`lane_pending`: Solana: the execution engine sent the sale but has not confirmed it, so it can still land. It also answers this, before sending anything, while the dev wallet has an earlier send unconfirmed. Do not resend: once the hashes in `tx_hashes` settle, check [List a launch's activity events](/reference/history/#list-launch-events) and retry only the part that failed.\n\n`launch_migrating`: EVM: the launch is moving from its curve to its pool, so nothing trades it for a few seconds. Wait a few seconds, then sell again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "lane_pending": {
                    "summary": "Solana: the execution engine sent the sale but has not confirmed it, so it can still land. It also answers this, before sending anything, while the dev wallet has an earlier send unconfirmed.",
                    "value": {
                      "ok": false,
                      "code": "lane_pending",
                      "message": "sent, not confirmed: do not send it again"
                    }
                  },
                  "launch_migrating": {
                    "summary": "EVM: the launch is moving from its curve to its pool, so nothing trades it for a few seconds.",
                    "value": {
                      "ok": false,
                      "code": "launch_migrating",
                      "message": "this launch is migrating to its pool, trading reopens in a few seconds"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: `token_amount` is more than the dev wallet holds. Lower `token_amount`, or send `0` to sell the whole balance.\n\n`unprocessable`: The execution engine cannot carry this sale. On EVM it never carries a sale from wallets its vault holds. Nothing was sent. Do not repeat the call unchanged: the reason names what the execution engine cannot carry.\n\n`upstream_failure`: Solana: the sale was not confirmed as landed. When it was split into several bundles, earlier ones may have landed. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch), then sell again only what is left.\n\n`upstream_failure`: EVM: the sale transaction failed, and the message carries the sender's reason. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch) before selling again.\n\n`unprocessable`: EVM: the dev wallet cannot pay the sale's gas. Top up the dev wallet's gas, then sell again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: `token_amount` is more than the dev wallet holds.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Supply to sell exceeds dev supply"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The execution engine cannot carry this sale. On EVM it never carries a sale from wallets its vault holds. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this sale cannot go through lane: <reason>. Nothing was sent"
                    }
                  },
                  "upstream_failure": {
                    "summary": "Solana: the sale was not confirmed as landed. When it was split into several bundles, earlier ones may have landed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while selling dev tokens"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "EVM: the sale transaction failed, and the message carries the sender's reason.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_tx_engine api issue: <detail>"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "EVM: the dev wallet cannot pay the sale's gas.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "dev wallet <address> has insufficient native balance to pay gas; fund it and retry"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Sell once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`internal_error`: Solana: the launch was imported without its dev wallet's key. Sell the dev supply only on launches whose dev wallet key Proxima holds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: the launch was imported without its dev wallet's key.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No dev keypair for imported token"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat sells again. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch) and look for the `launch.sell_dev_supply` event in [List a launch's activity events](/reference/history/#list-launch-events) first."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#sell-dev-supply"
        }
      }
    },
    "/launch/sell-subs-supply/{launch_id}": {
      "post": {
        "operationId": "launch-trading.sell-subs-supply",
        "summary": "Sell the sub-wallet supply",
        "description": "Sells tokens from the holder and MEV wallets of a launch.\n\nWhen the wallets hold nothing, the call answers 200 with the message `No tokens to sell`.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token_amount": {
                    "type": "string",
                    "description": "Tokens to sell, in base units, as an integer string. `0` sells the whole balance."
                  },
                  "quote_target": {
                    "type": "string",
                    "description": "Quote to receive, in base units, as an integer string. Use instead of `token_amount`, not both."
                  },
                  "fake_tip": {
                    "type": "boolean",
                    "description": "Sent by the app, not read by the API."
                  },
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets to sell from. Omit or send an empty list to sell from every holder and MEV wallet."
                  },
                  "fake_tip_pct": {
                    "type": "number",
                    "description": "Sent by the app, not read by the API."
                  }
                }
              },
              "example": {
                "token_amount": "9000000000000",
                "wallets": [
                  "HBwqDp7Qpmzos1wZhr5ZpwfsedZFGHubfdibhHBeH47Z",
                  "GwjXHJRZCrZjmRTzfuBCFkeuMmy6PxNMET4cPSmsvahJ"
                ],
                "fake_tip_pct": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "token_sold": {
                      "type": "number",
                      "description": "Tokens sold, in base units."
                    },
                    "quote_received": {
                      "type": "number",
                      "description": "Quote received, in base units."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully sold",
                  "token_sold": 9000000000000,
                  "quote_received": 301877402
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: Solana: `token_amount` and `quote_target` were both sent. Send only one of `token_amount` and `quote_target`.\n\n`bad_request`: EVM: a non-zero `quote_target` was sent. EVM sales take a token amount only. Pass `token_amount` instead, sized with [Quote a trade](/reference/launch-trading/#quote-launch-trade) if you target a quote amount.\n\n`bad_request`: EVM: the token is not deployed yet. Sell once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: a wallet in `wallets` is not one of the launch's. A malformed address answers `invalid wallet address: <address>`. List only the launch's holder and MEV wallets in `wallets`, as shown by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: EVM: no wallet is left to sell from. Check `wallets` against the launch's wallets in [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `token_amount` and `quote_target` were both sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token_amount and quote_target are mutually exclusive"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: a non-zero `quote_target` was sent. EVM sales take a token amount only.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "quote_target is not supported on evm launches; pass token_amount"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: a wallet in `wallets` is not one of the launch's. A malformed address answers `invalid wallet address: <address>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet not found on launch: <address>"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: no wallet is left to sell from.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no wallets to sell"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana allowlist launch: its run is still trading. Pause the run with [Pause an allowlist run](/reference/allowlist/#pause-allowlist), then sell.\n\n`lane_pending`: Solana: the execution engine sent the sale but has not confirmed it, so it can still land. It also answers this, before sending anything, while one of the wallets has an earlier send unconfirmed. Do not resend: once the hashes in `tx_hashes` settle, check [List a launch's activity events](/reference/history/#list-launch-events) and retry only the part that failed.\n\n`launch_migrating`: EVM: every sale failed because the launch is moving from its curve to its pool. Wait a few seconds, then sell again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana allowlist launch: its run is still trading.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the allowlist run is trading: pause it before selling"
                    }
                  },
                  "lane_pending": {
                    "summary": "Solana: the execution engine sent the sale but has not confirmed it, so it can still land. It also answers this, before sending anything, while one of the wallets has an earlier send unconfirmed.",
                    "value": {
                      "ok": false,
                      "code": "lane_pending",
                      "message": "sent, not confirmed: do not send it again"
                    }
                  },
                  "launch_migrating": {
                    "summary": "EVM: every sale failed because the launch is moving from its curve to its pool.",
                    "value": {
                      "ok": false,
                      "code": "launch_migrating",
                      "message": "this launch is migrating to its pool, trading reopens in a few seconds"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The execution engine cannot carry this sale. On EVM it never carries a sale from wallets its vault holds. Nothing was sent. Do not repeat the call unchanged: the reason names what the execution engine cannot carry.\n\n`unprocessable`: Solana: the execution engine's vault signs some of the selected wallets and not others, and one sale cannot mix them. Nothing was sent. Sell the two wallets the message names in separate calls through `wallets`.\n\n`upstream_failure`: EVM: every wallet's sale failed, and the message carries the sender's reason. When only some fail, the call answers 200 with per-wallet counts. Check the wallets' balances in [Retrieve a launch](/reference/launches/#retrieve-launch) before selling again.\n\n`unprocessable`: EVM: every sale was refused for lack of gas. The message names the dev wallet even when the selling wallets are the ones short. Top up the selling wallets' gas, then sell again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The execution engine cannot carry this sale. On EVM it never carries a sale from wallets its vault holds. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this sale cannot go through lane: <reason>. Nothing was sent"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Solana: the execution engine's vault signs some of the selected wallets and not others, and one sale cannot mix them. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the vault holds <held_wallet> and not <local_wallet>: one send is signed in one place"
                    }
                  },
                  "upstream_failure": {
                    "summary": "EVM: every wallet's sale failed, and the message carries the sender's reason. When only some fail, the call answers 200 with per-wallet counts.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_tx_engine api issue: <detail>"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "EVM: every sale was refused for lack of gas. The message names the dev wallet even when the selling wallets are the ones short.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "dev wallet <address> has insufficient native balance to pay gas; fund it and retry"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Sell once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`internal_error`: Solana: a wallet in `wallets` does not belong to your license. A watch-only wallet answers `Wallet is watch-only and cannot sign`. List only the launch's holder and MEV wallets in `wallets`, as shown by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`internal_error`: Solana: an amount was sent, but the selected wallets hold none of the token. Without an amount the call answers 200 with `No tokens to sell`. Check the wallets' balances in [Retrieve a launch](/reference/launches/#retrieve-launch) before selling.\n\n`internal_error`: Solana: not every sale landed. Some may have, and the message does not say which. Check the wallets' balances in [Retrieve a launch](/reference/launches/#retrieve-launch), then sell again only what is left.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: a wallet in `wallets` does not belong to your license. A watch-only wallet answers `Wallet is watch-only and cannot sign`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Wallet not found in license"
                    }
                  },
                  "internal_error_3": {
                    "summary": "Solana: an amount was sent, but the selected wallets hold none of the token. Without an amount the call answers 200 with `No tokens to sell`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Not enough balance to sell. Available: 0"
                    }
                  },
                  "internal_error_4": {
                    "summary": "Solana: not every sale landed. Some may have, and the message does not say which.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Error while selling some subs tokens"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat sells again. Check the wallets' balances in [Retrieve a launch](/reference/launches/#retrieve-launch) and look for the `launch.sell_subs_supply` event in [List a launch's activity events](/reference/history/#list-launch-events) first."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#sell-subs-supply"
        }
      }
    },
    "/launch/nuke/{launch_id}": {
      "post": {
        "operationId": "launch-trading.nuke",
        "summary": "Nuke a launch",
        "description": "Sells every token held by the launch wallets.\n\nWith `consolidate`, the holders' tokens are first pooled onto one wallet with plain transfers, then sold from it.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "include_dev": {
                    "type": "boolean",
                    "description": "Also sell the dev wallet.",
                    "default": "true"
                  },
                  "consolidate": {
                    "type": "boolean",
                    "description": "Pool the tokens onto one wallet before selling.",
                    "default": "false"
                  }
                }
              },
              "example": {
                "include_dev": true,
                "consolidate": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the nuke ran. On EVM it stays `true` when sales failed: read `failed`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome. Solana only."
                    },
                    "token_sold": {
                      "type": "number",
                      "description": "Tokens sold, in base units."
                    },
                    "quote_received": {
                      "type": "number",
                      "description": "Quote received, in base units."
                    },
                    "succeeded": {
                      "type": "integer",
                      "description": "EVM only: wallets that sold."
                    },
                    "failed": {
                      "type": "integer",
                      "description": "EVM only: wallets that failed to sell."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully sold",
                  "token_sold": 52115420310522,
                  "quote_received": 1702330118
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: Solana: another nuke of this launch is still running. Wait for the running nuke to finish, then check the `launch.nuke` event in [List a launch's activity events](/reference/history/#list-launch-events).\n\n`bad_request`: EVM: the token is not deployed yet. Nuke only a live launch, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: No selected wallet holds the token. EVM answers `all wallets have zero token balance`, or `no wallets to nuke` when the launch has no wallets. Nothing is left to sell: confirm with the balances in [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: EVM: every holder lacks the gas the sale reserves. Top up the holders' gas, or nuke again with `consolidate: true`.\n\n`bad_request`: With `consolidate`, no holder has enough SOL to pay the pooling and the sale. EVM answers `consolidate needs one holder funded enough to pay the sell`. Fund one holder, or nuke without `consolidate`.\n\n`bad_request`: EVM, with `consolidate`: after the pooling transfers, no wallet held tokens to sell. Check the balances in [Retrieve a launch](/reference/launches/#retrieve-launch), then nuke again without `consolidate`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: another nuke of this launch is still running.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a nuke is already running for this launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_4": {
                    "summary": "No selected wallet holds the token. EVM answers `all wallets have zero token balance`, or `no wallets to nuke` when the launch has no wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no wallets with tokens to sell"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: every holder lacks the gas the sale reserves.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "every holder is under the sell's gas escrow of <wei> wei; fund them or retry with consolidate"
                    }
                  },
                  "bad_request_6": {
                    "summary": "With `consolidate`, no holder has enough SOL to pay the pooling and the sale. EVM answers `consolidate needs one holder funded enough to pay the sell`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "consolidate needs one holder funded enough to pay the pooling batches and the sell"
                    }
                  },
                  "bad_request_7": {
                    "summary": "EVM, with `consolidate`: after the pooling transfers, no wallet held tokens to sell.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "consolidate left no wallet holding tokens"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana allowlist launch: its run is still trading. Pause the run with [Pause an allowlist run](/reference/allowlist/#pause-allowlist), then nuke.\n\n`lane_pending`: Solana: the execution engine sent a sale but has not confirmed it, so it can still land. It also answers this before selling anything, when the bots the nuke stops still have sends unconfirmed. Do not resend: once the hashes in `tx_hashes` settle, check [List a launch's activity events](/reference/history/#list-launch-events) and retry only the part that failed.\n\n`launch_migrating`: EVM: every sale failed because the launch is moving from its curve to its pool. When only some fail, the call answers 200 with `ok: true` and per-wallet counts. Wait a few seconds, then nuke again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana allowlist launch: its run is still trading.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the allowlist run is trading: pause it before selling"
                    }
                  },
                  "lane_pending": {
                    "summary": "Solana: the execution engine sent a sale but has not confirmed it, so it can still land. It also answers this before selling anything, when the bots the nuke stops still have sends unconfirmed.",
                    "value": {
                      "ok": false,
                      "code": "lane_pending",
                      "message": "sent, not confirmed: do not send it again"
                    }
                  },
                  "launch_migrating": {
                    "summary": "EVM: every sale failed because the launch is moving from its curve to its pool. When only some fail, the call answers 200 with `ok: true` and per-wallet counts.",
                    "value": {
                      "ok": false,
                      "code": "launch_migrating",
                      "message": "this launch is migrating to its pool, trading reopens in a few seconds"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Solana: the wallets' balances could not be read. Nothing was sent. Nuke again in a few seconds.\n\n`unprocessable`: The execution engine cannot carry this nuke. Refused before the first round, nothing was sent and the message ends `Nothing was sent`; refused at a later round, the message does not, and earlier rounds may have landed. On EVM it never carries a nuke of wallets its vault holds. Check the balances in [Retrieve a launch](/reference/launches/#retrieve-launch), and do not repeat the call unchanged.\n\n`unprocessable`: Solana: the execution engine's vault signs some of the launch's wallets and not others, and one nuke cannot mix them. Nothing was sent. Sell the wallets the message names separately with [Sell the sub-wallet supply](/reference/launch-trading/#sell-subs-supply).\n\n`upstream_failure`: Solana: not every sale landed, and some may have. Through the execution engine the message goes on with the round that was not sent and the sales that landed before it. Check the balances in [Retrieve a launch](/reference/launches/#retrieve-launch), then nuke again to sell what is left.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Solana: the wallets' balances could not be read. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: could not read the balances to nuke"
                    }
                  },
                  "unprocessable": {
                    "summary": "The execution engine cannot carry this nuke. Refused before the first round, nothing was sent and the message ends `Nothing was sent`; refused at a later round, the message does not, and earlier rounds may have landed. On EVM it never carries a nuke of wallets its vault holds.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this nuke cannot go through lane: <reason>. Nothing was sent"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Solana: the execution engine's vault signs some of the launch's wallets and not others, and one nuke cannot mix them. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the vault holds <held_wallet> and not <local_wallet>: one send is signed in one place"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "Solana: not every sale landed, and some may have. Through the execution engine the message goes on with the round that was not sent and the sales that landed before it.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while nuking launch"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Nuke only a live launch, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`internal_error`: Solana: the launch's platform has no nuke. Sell with [Sell the sub-wallet supply](/reference/launch-trading/#sell-subs-supply) and [Sell the dev supply](/reference/launch-trading/#sell-dev-supply) instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: the launch's platform has no nuke.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Unimplemented platform"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat sells only what the wallets still hold, but on EVM nothing refuses it while the first nuke is still selling. Before nuking again, check the balances in [Retrieve a launch](/reference/launches/#retrieve-launch) and the `launch.nuke` event in [List a launch's activity events](/reference/history/#list-launch-events)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#nuke"
        }
      }
    },
    "/launch/transfer-token/{launch_id}": {
      "post": {
        "operationId": "launch-trading.transfer-tokens",
        "summary": "Transfer tokens",
        "description": "Sends the launch token from launch wallets to other addresses.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "transfers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "from": {
                          "type": "string",
                          "description": "Launch wallet to send from."
                        },
                        "recipient": {
                          "type": "string",
                          "description": "Address to send to."
                        },
                        "amount": {
                          "type": "string",
                          "description": "Tokens to send, in base units."
                        }
                      },
                      "required": [
                        "from",
                        "recipient",
                        "amount"
                      ]
                    },
                    "description": "Transfers to make."
                  }
                },
                "required": [
                  "transfers"
                ]
              },
              "example": {
                "transfers": [
                  {
                    "from": "HBwqDp7Qpmzos1wZhr5ZpwfsedZFGHubfdibhHBeH47Z",
                    "recipient": "1SCVdnz5AsWbyy7MtiqYHH1upvvF2eVMGAVKTRuuUZd",
                    "amount": "2500000000000"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when every transfer went out. On EVM a 200 can carry `false`, with the misses in `failures`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome. Solana only."
                    },
                    "succeeded": {
                      "type": "integer",
                      "description": "EVM only: transfers that went out."
                    },
                    "failed": {
                      "type": "integer",
                      "description": "EVM only: transfers that did not."
                    },
                    "tx_hashes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "EVM only: hashes of the transfers that went out."
                    },
                    "failures": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "EVM only: one entry per transfer that did not go out, with `recipient`, `sender`, `amount_token_atomic` and `error`."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully transferred"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: `transfers` is empty. Send at least one transfer.\n\n`bad_request`: Solana: a `recipient` is not a valid address. A bad `from` answers `One of the from pubkey is invalid`; EVM answers `invalid recipient address` or `invalid from address: <from>`. Send valid addresses for the launch's chain in `recipient` and `from`.\n\n`bad_request`: Solana: a transfer's `from` and `recipient` are the same wallet. Send to a different `recipient`.\n\n`bad_request`: EVM: the token is not deployed yet. Transfer once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: A `from` is not one of the launch's wallets. Send from the launch's wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: No transfer names a `from` wallet, so there is no sender. Set `from` on every transfer to one of the launch's wallets.\n\n`bad_request`: A `from` wallet lacks the tokens for its transfer, or the SOL or gas to send it. EVM answers `from wallet <from> cannot cover its transfer of <amount> (out of tokens or gas)`, or `from wallet <from> holds no tokens or cannot pay for a transfer`. Lower the amount or top up the sender, checking its balances in [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: Every `amount` is `0`. Send at least one transfer with a non-zero `amount`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: `transfers` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no transfers specified"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: a `recipient` is not a valid address. A bad `from` answers `One of the from pubkey is invalid`; EVM answers `invalid recipient address` or `invalid from address: <from>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "One of the recipient pubkey is invalid"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Solana: a transfer's `from` and `recipient` are the same wallet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Sender and recipient are the same wallet. Choose a different recipient."
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_6": {
                    "summary": "A `from` is not one of the launch's wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "from wallet <wallet> is not one of this launch's wallets"
                    }
                  },
                  "bad_request_7": {
                    "summary": "No transfer names a `from` wallet, so there is no sender.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no senders selected (set from_dev and/or from_holder)"
                    }
                  },
                  "bad_request_8": {
                    "summary": "A `from` wallet lacks the tokens for its transfer, or the SOL or gas to send it. EVM answers `from wallet <from> cannot cover its transfer of <amount> (out of tokens or gas)`, or `from wallet <from> holds no tokens or cannot pay for a transfer`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "sender <from> cannot cover its transfer of <amount> (out of tokens or SOL)"
                    }
                  },
                  "bad_request_9": {
                    "summary": "Every `amount` is `0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "nothing to transfer"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`lane_pending`: The execution engine sent a transfer but has not confirmed it, so it can still land. It also answers this, before sending anything, while one of the senders has an earlier send unconfirmed. Do not resend: once the hashes in `tx_hashes` settle, check [List a launch's activity events](/reference/history/#list-launch-events) and retry only the part that failed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "lane_pending": {
                    "summary": "The execution engine sent a transfer but has not confirmed it, so it can still land. It also answers this, before sending anything, while one of the senders has an earlier send unconfirmed.",
                    "value": {
                      "ok": false,
                      "code": "lane_pending",
                      "message": "sent, not confirmed: do not send it again"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The execution engine cannot carry this transfer. Nothing was sent. Do not repeat the call unchanged: the reason names what the execution engine cannot carry.\n\n`unprocessable`: The execution engine's vault signs some of the senders and not others, and one call cannot mix them. Nothing was sent. Send the transfers of the two wallets the message names in separate calls.\n\n`upstream_failure`: Solana: not every transfer landed. Bundles sent before the failing one may have landed. Check the senders' balances in [Retrieve a launch](/reference/launches/#retrieve-launch), then send again only the transfers that did not land.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The execution engine cannot carry this transfer. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this transfer cannot go through lane: <reason>"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The execution engine's vault signs some of the senders and not others, and one call cannot mix them. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the vault holds <held_wallet> and not <local_wallet>: one send is signed in one place"
                    }
                  },
                  "upstream_failure": {
                    "summary": "Solana: not every transfer landed. Bundles sent before the failing one may have landed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while transferring tokens"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Transfer once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat sends the tokens again. Before resending, check the senders' balances in [Retrieve a launch](/reference/launches/#retrieve-launch) and the `launch.transfer_token` event in [List a launch's activity events](/reference/history/#list-launch-events); on EVM, resend only the entries listed in `failures`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#transfer-tokens"
        }
      }
    },
    "/launch/burn-dev-supply/{launch_id}": {
      "post": {
        "operationId": "launch-trading.burn-dev-supply",
        "summary": "Burn the dev supply",
        "description": "Burns tokens from the dev wallet.\n\nBurning is irreversible.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string",
                    "description": "Tokens to burn, in base units. `0` burns the whole dev balance."
                  }
                },
                "required": [
                  "amount"
                ]
              },
              "example": {
                "amount": "5000000000000"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome. Solana only."
                    },
                    "signature": {
                      "type": "string",
                      "description": "Transaction signature, or transaction hash on EVM."
                    },
                    "token_burned": {
                      "type": "string",
                      "description": "EVM only: tokens burned, in base units."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully burnt dev supply",
                  "signature": "5ysXA38PjKtmRfyDZ7J6j7JES83EdpKnjkvUtkLxm964QbYGPDbQD9vppVqXmA7a2NBnJUDoWi5Sb6zsexsoo2a1"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: `amount` is missing. Send `amount`, or `0` to burn the whole dev balance.\n\n`bad_request`: EVM: the token is not deployed yet. Burn once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: EVM: the dev wallet is watch-only and cannot sign. A launch with no dev wallet answers `no dev wallet configured`. Burn only on launches whose dev wallet key Proxima holds.\n\n`bad_request`: EVM: the dev wallet holds none of the token. Solana answers 200 with the message `No tokens to burn` instead. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch): there is nothing to burn.\n\n`bad_request`: EVM: `amount` is more than the dev wallet holds. Lower `amount`, or send `0` to burn the whole balance.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: `amount` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "amount is required: pass the exact amount to burn, or 0 to burn the whole dev balance"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: the dev wallet is watch-only and cannot sign. A launch with no dev wallet answers `no dev wallet configured`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev wallet is watched, cannot sign"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the dev wallet holds none of the token. Solana answers 200 with the message `No tokens to burn` instead.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev has no tokens to burn"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: `amount` is more than the dev wallet holds.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "amount <requested> exceeds dev balance <balance>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: `amount` is more than the dev wallet holds. Lower `amount`, or send `0` to burn the whole balance.\n\n`upstream_failure`: Solana: the burn was not confirmed as landed. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch) before burning again.\n\n`upstream_failure`: EVM: the burn transaction failed, and the message carries the sender's reason. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch) before burning again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: `amount` is more than the dev wallet holds.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Supply to burn exceeds dev supply"
                    }
                  },
                  "upstream_failure": {
                    "summary": "Solana: the burn was not confirmed as landed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while burning dev supply"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "EVM: the burn transaction failed, and the message carries the sender's reason.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_tx_engine api issue: <detail>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Burn once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`internal_error`: Solana: the launch was imported without its dev wallet's key. Burn only on launches whose dev wallet key Proxima holds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: the launch was imported without its dev wallet's key.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No dev keypair for imported token"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat burns again, and `0` burns whatever is left. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch) and look for the `launch.burn_dev_supply` event in [List a launch's activity events](/reference/history/#list-launch-events) first."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#burn-dev-supply"
        }
      }
    },
    "/launch/lock-token/{launch_id}": {
      "post": {
        "operationId": "launch-trading.lock-dev-supply",
        "summary": "Lock the dev supply",
        "description": "Locks tokens from the dev wallet in a Streamflow lock on Solana.\n\nSolana launches only.",
        "tags": [
          "Launch trading"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string",
                    "description": "Tokens to lock, in base units. At least 100000000."
                  },
                  "period": {
                    "type": "integer",
                    "description": "Lock duration, in seconds. At least 60."
                  }
                },
                "required": [
                  "amount",
                  "period"
                ]
              },
              "example": {
                "amount": "50000000000000",
                "period": 2592000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "strm_metadata": {
                      "type": "string",
                      "description": "Streamflow lock account."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully locked token",
                  "strm_metadata": "ANMQCTKS1HJC1gwbMGo1r62E1PLwWCXBGgZzvKvQcZY"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is not on Solana. Call this endpoint only for Solana launches.\n\n`bad_request`: `amount` is below 100000000 base units. An `amount` of `0` answers `Invalid lock amount`. Lock at least 100000000 base units.\n\n`bad_request`: `period` is below 60 seconds. Lock for at least 60 seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`amount` is below 100000000 base units. An `amount` of `0` answers `Invalid lock amount`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Lock amount too small"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`period` is below 60 seconds.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Lock period too small"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The dev wallet holds less than `amount` plus Streamflow's 0.5% fee. Lower `amount` so it fits the dev balance shown in [Retrieve a launch](/reference/launches/#retrieve-launch), fee included.\n\n`unprocessable`: The dev wallet holds less than the 0.175 SOL the lock needs. Top up the dev wallet to at least 0.175 SOL, then lock again.\n\n`upstream_failure`: The lock was not confirmed as landed. Check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch) before locking again, since a second call creates a second lock.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The dev wallet holds less than `amount` plus Streamflow's 0.5% fee.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Not enough tokens"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The dev wallet holds less than the 0.175 SOL the lock needs.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Not enough SOL"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The lock was not confirmed as landed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while locking token"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead. Lock once the launch is live, as shown by `launch_status` in [List the license's launches](/reference/licenses/#list-mints).\n\n`internal_error`: The launch was imported without its dev wallet's key. Lock only on launches whose dev wallet key Proxima holds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The token is not deployed yet. A launch with no saved plan answers `No launch data saved` or `No launch method saved` instead.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "The launch was imported without its dev wallet's key.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No dev keypair for imported token"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat creates a second lock. Look for the `launch.lock_token` event, which carries the lock's `strm_metadata`, in [List a launch's activity events](/reference/history/#list-launch-events), and check the dev wallet's balance in [Retrieve a launch](/reference/launches/#retrieve-launch) first."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-trading/#lock-dev-supply"
        }
      }
    },
    "/launch/collect-fees/{launch_id}": {
      "post": {
        "operationId": "launch-fees.collect-fees",
        "summary": "Collect creator fees",
        "description": "Claims the creator fees the launch has earned.\n\nAnswers once the claim transaction has landed. The fields returned depend on the platform: one or several transaction hashes, the amount received, or, for Meteora DAMM, a signature and the native and token legs.\n\nA refusal can come back as 200 with `ok: false` and a `message`; the SDK turns it into an error.",
        "tags": [
          "Launch fees"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "tx_hash": {
                      "type": "string",
                      "description": "Transaction hash."
                    },
                    "tx_hashes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Transaction hashes, when several were sent."
                    },
                    "fee_received": {
                      "type": "string",
                      "description": "Fees received, in base units."
                    },
                    "note": {
                      "type": "string",
                      "description": "Extra information about the claim."
                    },
                    "signature": {
                      "type": "string",
                      "description": "Meteora DAMM and Stonk.fun: signature of the claim."
                    },
                    "fees_native": {
                      "type": "string",
                      "description": "Meteora DAMM: native leg, in base units."
                    },
                    "fees_token": {
                      "type": "string",
                      "description": "Meteora DAMM: token leg, in base units."
                    },
                    "amount": {
                      "type": "integer",
                      "description": "Solana: fees received, in base units of the quote token."
                    },
                    "amount_usd": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "pump.fun: value of `amount` in micro-USD, when it can be priced."
                    },
                    "proxima_fee": {
                      "type": "string",
                      "description": "EVM: Proxima's fee on the claim, in base units."
                    },
                    "already_submitted": {
                      "type": "boolean",
                      "description": "Stonk.fun: the claim was already relayed, and `signature` is the original one."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "tx_hash": "0xbf464b78fce614b8966ba8ec73e25795f0c475aa2247fe43f71a2bc500dc774b",
                  "fee_received": "184203117000000000"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: The launch's platform has no creator fees this endpoint can collect. On Solana it collects pump.fun, Bonk.fun, Surge, Bags, Meteora DAMM, Stonk.fun and meme.fun fees. Call it only for a launch on a platform that pays its creator fees.\n\n`bad_request`: On EVM, the launch has not been deployed yet, so it has earned no fees. Meteora DAMM answers `launch is not deployed yet`. Wait until the launch is deployed, then call again.\n\n`bad_request`: Anoncoin pays this launch's creator fees into an account it keeps for your API key. Claim these fees from Anoncoin.\n\n`bad_request`: On Meteora DAMM, the launch holds no pool position of its own, as with an imported pool. Collect fees only on a pool the launch created.\n\n`bad_request`: On Meteora DAMM, the position has no fees yet, or they are worth less than landing the claim costs. Let more fees accrue, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch's platform has no creator fees this endpoint can collect. On Solana it collects pump.fun, Bonk.fun, Surge, Bags, Meteora DAMM, Stonk.fun and meme.fun fees.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "collect-fees not supported for platform <platform>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On EVM, the launch has not been deployed yet, so it has earned no fees. Meteora DAMM answers `launch is not deployed yet`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Anoncoin pays this launch's creator fees into an account it keeps for your API key.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "anoncoin pays this launch's creator fees to the account it custodies for your api key, so they are claimed from anoncoin rather than from here"
                    }
                  },
                  "bad_request_5": {
                    "summary": "On Meteora DAMM, the launch holds no pool position of its own, as with an imported pool.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch holds no position (imported pools are not ours)"
                    }
                  },
                  "bad_request_6": {
                    "summary": "On Meteora DAMM, the position has no fees yet, or they are worth less than landing the claim costs.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no fees to collect"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The launch was imported, so its creator fees belong to whoever created the token. Claim these fees from the wallet that created the token.\n\n`conflict`: The launch pays its creator fees to its holders, through pump.fun Holder Rewards or a Stonk.fun reward launch, so the creator has nothing to claim. Don't collect fees on a launch that pays its holders.\n\n`conflict`: A partner takes the whole creator fee stream: OTC desks, UsePaid, or Ansem, which keeps the creator. On EVM, a UsePaid launch answers `UsePaid claims this launch's creator fees`. Don't collect fees on a launch whose fee stream goes to a partner.\n\n`conflict`: On meme.fun, the launch doesn't trade a meme.fun curve, or the curve pays a creator other than the launch's dev wallet. Check the launch's dev wallet with [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`conflict`: On Stonk.fun, an earlier claim on this launch has not landed yet. Wait for the earlier claim to land, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The launch was imported, so its creator fees belong to whoever created the token.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot claim fees on imported launch"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch pays its creator fees to its holders, through pump.fun Holder Rewards or a Stonk.fun reward launch, so the creator has nothing to claim.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Pumpfun distributes these rewards to holders; the creator cannot claim or redirect them"
                    }
                  },
                  "conflict_3": {
                    "summary": "A partner takes the whole creator fee stream: OTC desks, UsePaid, or Ansem, which keeps the creator. On EVM, a UsePaid launch answers `UsePaid claims this launch's creator fees`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "<partner> takes the whole creator fee stream, this launch earns none"
                    }
                  },
                  "conflict_4": {
                    "summary": "On meme.fun, the launch doesn't trade a meme.fun curve, or the curve pays a creator other than the launch's dev wallet.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "The curve pays its creator <address>, which is not this launch's dev wallet"
                    }
                  },
                  "conflict_5": {
                    "summary": "On Stonk.fun, an earlier claim on this launch has not landed yet.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "a claim is already running on this launch, wait for it to land"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Nothing has accrued since the last claim. On EVM, an empty claim answers 200 with a `fee_received` of `\"0\"` instead. Call again once the token has traded more.\n\n`unprocessable`: The dev wallet can't pay for the claim. On Solana it needs at least 0.01 SOL; on EVM the message names the wallet that can't pay the gas. Fund the dev wallet, then call again.\n\n`unprocessable`: On Meteora DAMM, nothing prices the launch's quote token right now, so the claim can't be weighed against its cost. Call again in a few minutes.\n\n`upstream_failure`: The claim transaction failed or did not land. On EVM the service is `evm_tx_engine`, on Stonk.fun `stonkfun`. Call again: it claims only what is still owed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Nothing has accrued since the last claim. On EVM, an empty claim answers 200 with a `fee_received` of `\"0\"` instead.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No fees to claim"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The dev wallet can't pay for the claim. On Solana it needs at least 0.01 SOL; on EVM the message names the wallet that can't pay the gas.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Dev wallet needs at least 0.01 SOL to claim creator rewards"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "On Meteora DAMM, nothing prices the launch's quote token right now, so the claim can't be weighed against its cost.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "nothing prices this launch's quote right now, the claim cannot be valued"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The claim transaction failed or did not land. On EVM the service is `evm_tx_engine`, on Stonk.fun `stonkfun`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: <detail>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On Solana, the launch has not been deployed yet. Wait until the launch is deployed, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On Solana, the launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat claims only what has accrued since. With nothing owed, Solana answers 422 `No fees to claim` and EVM answers a `fee_received` of `\"0\"`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-fees/#collect-fees"
        }
      }
    },
    "/launch/pumpfun/claim-cashback/{launch_id}": {
      "post": {
        "operationId": "launch-fees.claim-pump-cashback",
        "summary": "Claim pump.fun cashback",
        "description": "Claims the pump.fun cashback the launch has accumulated.",
        "tags": [
          "Launch fees"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "amount": {
                      "type": "number",
                      "description": "Cashback claimed."
                    },
                    "amount_usd": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Value of `amount` in micro-USD, when it can be priced."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully claimed cashback",
                  "amount": 48120000
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is on an EVM chain. Call this endpoint only for Solana launches.\n\n`bad_request`: The launch is not on pump.fun. Claim cashback only on pump.fun launches.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is on an EVM chain.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is not on pump.fun.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Cashback only available for pumpfun launches"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The token was created without pump.fun cashback. Claim cashback only on tokens created with cashback enabled.\n\n`conflict`: The launch's deploy has not finished. Wait until the deploy finishes, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The token was created without pump.fun cashback.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cashback not enabled for this launch"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch's deploy has not finished.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Launch must be deployed to claim cashback"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: None of the launch's wallets has cashback left to claim. Call again after the wallets have traded more.\n\n`unprocessable`: The funder pays the claim fees and holds less than 0.1 SOL. Top up the launch's funder, listed by [List funders](/reference/funders/#list-funders), then call again.\n\n`upstream_failure`: At least one claim transaction did not land; the others may have. Call again: it claims only the cashback still unclaimed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "None of the launch's wallets has cashback left to claim.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No unclaimed cashback"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The funder pays the claim fees and holds less than 0.1 SOL.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Funder has insufficient SOL (min 0.1 SOL required)"
                    }
                  },
                  "upstream_failure": {
                    "summary": "At least one claim transaction did not land; the others may have.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while claiming cashback"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The launch has not been deployed yet. Wait until the launch is deployed, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat claims only the cashback still unclaimed, then answers 422 `No unclaimed cashback`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-fees/#claim-pump-cashback"
        }
      }
    },
    "/launch/pumpfun/update-fee-shares/{launch_id}": {
      "post": {
        "operationId": "launch-fees.update-fee-shares",
        "summary": "Update pump.fun fee shares",
        "description": "Changes how the creator fees of a live pump.fun token are split.\n\nEach leg names exactly one of `address`, `github` or `charity_id`.\n\nSolana pump.fun launches only.",
        "tags": [
          "Launch fees"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "new_shares": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "address": {
                          "type": "string",
                          "description": "Recipient wallet."
                        },
                        "github": {
                          "type": "string",
                          "description": "Recipient GitHub username."
                        },
                        "charity_id": {
                          "type": "string",
                          "description": "Recipient charity ID."
                        },
                        "share_bps": {
                          "type": "integer",
                          "description": "Share of the fees, in basis points."
                        }
                      },
                      "required": [
                        "share_bps"
                      ]
                    },
                    "description": "The new split. Shares must add up to 10000."
                  }
                },
                "required": [
                  "new_shares"
                ]
              },
              "example": {
                "new_shares": [
                  {
                    "address": "BZJTwe2bzzTQBwy5VQwwrhbzbMUbQoBZ59F9g3fUUtZU",
                    "share_bps": 7000
                  },
                  {
                    "github": "orbitcat-dev",
                    "share_bps": 3000
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully updated pump fee shares"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is on an EVM chain. Call this endpoint only for Solana launches.\n\n`bad_request`: `new_shares` is empty, doesn't add up to 10000, gives every charity leg a `share_bps` of 0, or has a leg with an invalid address, an empty GitHub username, or not exactly one of `address`, `github` and `charity_id`. Send legs that each name one recipient and together add up to 10000.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is on an EVM chain.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`new_shares` is empty, doesn't add up to 10000, gives every charity leg a `share_bps` of 0, or has a leg with an invalid address, an empty GitHub username, or not exactly one of `address`, `github` and `charity_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Fee shares must sum to 10000 (bps)"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: pump.fun no longer lets the creator change this token's fee split. Keep the current split, which can't be changed anymore.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "pump.fun no longer lets the creator change this token's fee split.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "The dev can no longer change these fee shares"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The launch is imported, uses Holder Rewards, or assigned the whole fee stream at deploy. Update fee shares only on a launch you created whose fees still go to its creator.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The launch is imported, uses Holder Rewards, or assigned the whole fee stream at deploy.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot update fees on imported launch"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: pump.fun couldn't resolve a charity leg. Check each `charity_id`, then call again.\n\n`upstream_failure`: The update transaction did not land. Call again with the same split.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "pump.fun couldn't resolve a charity leg.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "pumpfun api issue: Failed to aggregate charity config"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "The update transaction did not land.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: Error while updating fee shares"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The launch has not been deployed yet. Wait until the launch is deployed, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sending the same split again leaves the same state, though it sends another transaction."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-fees/#update-fee-shares"
        }
      }
    },
    "/launch/fee-recipient/{launch_id}": {
      "get": {
        "operationId": "launch-fees.retrieve-fee-recipient",
        "summary": "Retrieve the fee recipient",
        "description": "Returns where the launch's creator fees go today.\n\nEVM launches on Pons, Pons v2, Znipe, Foci, Lift or Long. The app uses it for Pons and Foci.",
        "tags": [
          "Launch fees"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "recipient": {
                      "type": "string",
                      "description": "Address the creator fees now go to."
                    },
                    "tx_hashes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Transactions sent to make the change; empty when nothing changed."
                    },
                    "can_change": {
                      "type": "boolean",
                      "description": "`false` once the fees go to a holder distributor, which can't be undone."
                    },
                    "already_set": {
                      "type": "boolean",
                      "description": "The recipient was already the requested one."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "recipient": "0xab2b93519e1fbc3bfc0e79f066f6b11af5d97d9c",
                  "tx_hashes": [],
                  "can_change": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is on Solana. Call this endpoint only for EVM launches.\n\n`bad_request`: The launch has not been deployed yet. Wait until the launch is deployed, then call again.\n\n`bad_request`: The launch's platform exposes no creator fee recipient. Pons, Pons v2, Znipe, Foci, Lift and Long do. Call it only for a launch on one of those platforms.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is on Solana.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch's platform exposes no creator fee recipient. Pons, Pons v2, Znipe, Foci, Lift and Long do.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<platform> does not expose a creator fee recipient"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-fees/#retrieve-fee-recipient"
        }
      },
      "post": {
        "operationId": "launch-fees.set-fee-recipient",
        "summary": "Set the fee recipient",
        "description": "Points the launch's creator fees at its dev, another wallet, or its holders.\n\nA `holders` target first deploys the launchpad's per-launch distributor, and the fees can't be pointed elsewhere afterwards.\n\nEVM launches on Pons, Pons v2, Znipe or Long; only Pons v2 and Znipe take a `holders` target.",
        "tags": [
          "Launch fees"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "target": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "type": "string",
                        "enum": [
                          "dev",
                          "wallet",
                          "holders"
                        ],
                        "description": "Who receives the fees."
                      },
                      "address": {
                        "type": "string",
                        "description": "Wallet to pay. Required when `kind` is `wallet`."
                      }
                    },
                    "required": [
                      "kind"
                    ],
                    "description": "New recipient."
                  }
                },
                "required": [
                  "target"
                ]
              },
              "example": {
                "target": {
                  "kind": "wallet",
                  "address": "0x8627fb3110f34ad0e7b7be160fba95f0b0c4022a"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "recipient": {
                      "type": "string",
                      "description": "Address the creator fees now go to."
                    },
                    "tx_hashes": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Transactions sent to make the change; empty when nothing changed."
                    },
                    "can_change": {
                      "type": "boolean",
                      "description": "`false` once the fees go to a holder distributor, which can't be undone."
                    },
                    "already_set": {
                      "type": "boolean",
                      "description": "The recipient was already the requested one."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "recipient": "0x8627fb3110f34ad0e7b7be160fba95f0b0c4022a",
                  "tx_hashes": [
                    "0x99d1712689894d446aa4115fef4bb10f325c7a6f0b75853c573cda1ac1a3f350"
                  ],
                  "can_change": true,
                  "already_set": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`unsupported_chain`: The launch is on Solana. Call this endpoint only for EVM launches.\n\n`bad_request`: `target` has no `kind`, an unknown `kind`, or is a `wallet` target without a valid `address`. Send `target.kind` as `dev`, `wallet` or `holders`, with an `address` for `wallet`.\n\n`bad_request`: The launch has not been deployed yet. Wait until the launch is deployed, then call again.\n\n`bad_request`: The launch's platform can't repoint its creator fees, or has no holder distributor for a `holders` target. Pons, Pons v2, Znipe and Long can move them, and only Pons v2 and Znipe take `holders`. Pick a target the launch's platform supports.\n\n`bad_request`: The fees already go to the holders' distributor, which can't hand them back; `can_change` is `false`. Leave the recipient as it is.\n\n`bad_request`: The fee recipient is controlled by a wallet your license doesn't hold. Change the recipient from the wallet that controls it.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is on Solana.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`target` has no `kind`, an unknown `kind`, or is a `wallet` target without a valid `address`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a wallet target needs an `address`"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The launch's platform can't repoint its creator fees, or has no holder distributor for a `holders` target. Pons, Pons v2, Znipe and Long can move them, and only Pons v2 and Znipe take `holders`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<platform> cannot move its creator fees"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The fees already go to the holders' distributor, which can't hand them back; `can_change` is `false`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch shares its creator fees with its holders; <address> pays them out and cannot hand them back"
                    }
                  },
                  "bad_request_6": {
                    "summary": "The fee recipient is controlled by a wallet your license doesn't hold.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch's creator fees are controlled by <address>, which is not a wallet on this license"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: UsePaid controls where this launch's creator fees go. Change the recipient through UsePaid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "UsePaid controls where this launch's creator fees go.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "UsePaid holds this launch's creator fee recipient"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The dev wallet can't pay the gas. Fund the dev wallet, then call again.\n\n`unprocessable`: The change was sent, but a chain read still shows the old recipient. Read it back with [Retrieve the fee recipient](/reference/launch-fees/#retrieve-fee-recipient), and call again if it hasn't changed.\n\n`upstream_failure`: The transaction failed or did not land. Call again: once the recipient is set, a repeat sends nothing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The dev wallet can't pay the gas.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "dev wallet <address> has insufficient native balance to pay gas; fund it and retry"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The change was sent, but a chain read still shows the old recipient.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch still pays its creator fees to <address>"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The transaction failed or did not land.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_tx_engine api issue: <detail>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Settled on a chain read: when the recipient is already the one asked for, it answers `already_set: true` and sends nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-fees/#set-fee-recipient"
        }
      }
    },
    "/launch/dividends/{launch_id}": {
      "get": {
        "operationId": "launch-fees.retrieve-dividends",
        "summary": "Retrieve dividends",
        "description": "Returns the dividends the launch wallets hold.\n\nOn EVM this is the tax a Flap, Argus or Ignix coin pays its holders, answered as the flat fields and again as the one entry of `assets`. On Solana it is the OTC desks reward, answered as `assets` only. A launch without dividends answers an error.",
        "tags": [
          "Launch fees"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "type": "string",
                      "description": "Dividend token."
                    },
                    "symbol": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Symbol."
                    },
                    "decimals": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Decimals."
                    },
                    "total_atomic": {
                      "type": "string",
                      "description": "Total held, in base units."
                    },
                    "total_native": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Total value in the chain's native token, in base units (lamports or wei)."
                    },
                    "total_usd": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Total value in micro-USD (millionths of a dollar)."
                    },
                    "assets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "One entry per dividend token, with the same fields. Solana answers only this list; EVM answers one entry beside the flat fields."
                    }
                  }
                },
                "example": {
                  "assets": [
                    {
                      "token": "2jJhjeLE7KA64hNmGp5pwvb7cySPnTnFxvDuzMXyyirB",
                      "symbol": "NVDAx",
                      "decimals": 8,
                      "total_atomic": "412500000",
                      "total_native": "3218000000",
                      "total_usd": "580440000"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: On EVM, the launch has not been deployed yet. Wait until the launch is deployed, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "On EVM, the launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch pays no dividend. On EVM only a taxed Flap, Argus or Ignix coin does; on Solana, an OTC desks reward launch. Call it only for a launch that pays dividends.\n\n`unprocessable`: The dividend is the launch's own token. Sell it with [Nuke a launch](/reference/launch-trading/#nuke).\n\n`unprocessable`: On EVM, the dividend is already the chain's gas token, so there is nothing to sell. Read it as the wallets' native balance with [List wallets](/reference/wallets/#list-wallets).\n\n`unprocessable`: On Solana, an OTC desks pair reward sits in the launch's trading quote balance rather than as a separate dividend. Manage it through the launch's quote balance.\n\n`unprocessable`: None of the launch's wallets holds any dividend right now. Call again once dividends have accrued.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch pays no dividend. On EVM only a taxed Flap, Argus or Ignix coin does; on Solana, an OTC desks reward launch.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch pays no dividend"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The dividend is the launch's own token.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch is paid in its own coin, sell it through nuke"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "On EVM, the dividend is already the chain's gas token, so there is nothing to sell.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "dividends are already in the gas token"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "On Solana, an OTC desks pair reward sits in the launch's trading quote balance rather than as a separate dividend.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Otcdesks pair rewards share the trading quote balance; manage them through quote balances"
                    }
                  },
                  "unprocessable_5": {
                    "summary": "None of the launch's wallets holds any dividend right now.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "no dividend held on this launch's wallets"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On Solana, the launch has not been deployed yet. Wait until the launch is deployed, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On Solana, the launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-fees/#retrieve-dividends"
        }
      }
    },
    "/launch/sell-dividends/{launch_id}": {
      "post": {
        "operationId": "launch-fees.sell-dividends",
        "summary": "Sell dividends",
        "description": "Sells the dividends held by the launch wallets.",
        "tags": [
          "Launch fees"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallets to sell from. Omit for all."
                  },
                  "slippage_bps": {
                    "type": "integer",
                    "description": "Slippage tolerance, in basis points. Defaults to 50 on Solana."
                  }
                }
              },
              "example": {
                "slippage_bps": 100
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "wallet": {
                            "type": "string",
                            "description": "Wallet."
                          },
                          "token": {
                            "type": "string",
                            "description": "Token handled."
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "swapped",
                              "sold",
                              "claimed",
                              "skipped",
                              "failed"
                            ],
                            "description": "Outcome."
                          },
                          "reason": {
                            "type": "string",
                            "description": "Why it was skipped or failed."
                          },
                          "amount": {
                            "type": "string",
                            "description": "Amount handled, in base units."
                          },
                          "tx_hash": {
                            "type": "string",
                            "description": "Transaction hash or signature."
                          }
                        }
                      },
                      "description": "One result per wallet and token."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "results": [
                    {
                      "wallet": "HBwqDp7Qpmzos1wZhr5ZpwfsedZFGHubfdibhHBeH47Z",
                      "token": "2jJhjeLE7KA64hNmGp5pwvb7cySPnTnFxvDuzMXyyirB",
                      "status": "sold",
                      "amount": "206250000",
                      "tx_hash": "2bvqLBp2kyWxAuJnvJ2ZnffCHUWEPW3XoJthATsJNozs7ryhPgC9pALXNnL1jH1TsGQ63kG1MtN6t6vLeNGu5uGE"
                    },
                    {
                      "wallet": "GwjXHJRZCrZjmRTzfuBCFkeuMmy6PxNMET4cPSmsvahJ",
                      "token": "2jJhjeLE7KA64hNmGp5pwvb7cySPnTnFxvDuzMXyyirB",
                      "status": "skipped",
                      "reason": "Nothing to sell"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`bad_request`: An entry of `wallets` is not a valid address, or, on EVM, is not a wallet of this launch (`wallet does not belong to this launch`). Send addresses of this launch's wallets, as listed by [List wallets](/reference/wallets/#list-wallets).\n\n`bad_request`: On EVM, the launch has not been deployed yet. Wait until the launch is deployed, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "An entry of `wallets` is not a valid address, or, on EVM, is not a wallet of this launch (`wallet does not belong to this launch`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid wallet address"
                    }
                  },
                  "bad_request_3": {
                    "summary": "On EVM, the launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: On Solana, an entry of `wallets` is not a wallet of this launch. Send addresses of this launch's wallets, as listed by [List wallets](/reference/wallets/#list-wallets).\n\n`unprocessable`: `wallets` is an empty list. Omit `wallets` to sell from every launch wallet.\n\n`unprocessable`: The launch pays no dividend. On EVM only a taxed Flap, Argus or Ignix coin does; on Solana, an OTC desks reward launch. Call it only for a launch that pays dividends.\n\n`unprocessable`: The dividend is the launch's own token. Sell it with [Nuke a launch](/reference/launch-trading/#nuke).\n\n`unprocessable`: On EVM, the dividend is already the chain's gas token, so there is nothing to sell. Read it as the wallets' native balance with [List wallets](/reference/wallets/#list-wallets).\n\n`unprocessable`: On Solana, an OTC desks pair reward sits in the launch's trading quote balance rather than as a separate dividend. Manage it through the launch's quote balance.\n\n`unprocessable`: None of the launch's wallets, or of the ones named, holds any dividend right now. Call again once dividends have accrued.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "On Solana, an entry of `wallets` is not a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "wallet <address> not in launch"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "`wallets` is an empty list.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "no wallets named"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "The launch pays no dividend. On EVM only a taxed Flap, Argus or Ignix coin does; on Solana, an OTC desks reward launch.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch pays no dividend"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "The dividend is the launch's own token.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch is paid in its own coin, sell it through nuke"
                    }
                  },
                  "unprocessable_5": {
                    "summary": "On EVM, the dividend is already the chain's gas token, so there is nothing to sell.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "dividends are already in the gas token"
                    }
                  },
                  "unprocessable_6": {
                    "summary": "On Solana, an OTC desks pair reward sits in the launch's trading quote balance rather than as a separate dividend.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Otcdesks pair rewards share the trading quote balance; manage them through quote balances"
                    }
                  },
                  "unprocessable_7": {
                    "summary": "None of the launch's wallets, or of the ones named, holds any dividend right now.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "no dividend held on this launch's wallets"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: On Solana, the launch has not been deployed yet. Wait until the launch is deployed, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "On Solana, the launch has not been deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat sells only what the wallets still hold. The answer is 200 even when some legs fail, so check each `status` in `results`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-fees/#sell-dividends"
        }
      }
    },
    "/launch/{chain_id}/{launch_id}/script/validate": {
      "post": {
        "operationId": "launch-scripts.validate-script",
        "summary": "Validate a script",
        "description": "Checks a script against a launch without saving it.\n\nAnswers 200 with every error found; `ok` is `false` when there is any, including unfinished funding of a draft.\n\nNot called by the current web app.",
        "tags": [
          "Launch scripts"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the launch.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "script": {
                    "type": "object",
                    "description": "Script to check."
                  }
                },
                "required": [
                  "script"
                ]
              },
              "example": {
                "script": {
                  "version": 1,
                  "wallets": {
                    "dev": {
                      "count": 1
                    }
                  },
                  "steps": {
                    "a": {
                      "product": {
                        "name": "nope",
                        "params": {}
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "errors": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "code": {
                            "type": "string",
                            "description": "Error code, for example `script_plan` or `unknown_action`."
                          },
                          "path": {
                            "type": "string",
                            "description": "Dotted path into the script, such as `steps.snipe.params.buys.1.wallet`. Empty for plan-level errors."
                          },
                          "position": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Position in the script source."
                          },
                          "feature": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Language feature involved."
                          },
                          "message": {
                            "type": "string",
                            "description": "What is wrong."
                          }
                        }
                      },
                      "description": "Errors found."
                    }
                  }
                },
                "example": {
                  "ok": false,
                  "errors": [
                    {
                      "code": "unknown_action",
                      "path": "steps.a.product",
                      "position": null,
                      "feature": null,
                      "message": "no product verb nope is registered"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`). Pass the launch's own chain, such as `sol` or `bsc`, with its `launch_id`.\n\n`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain \"<chain>\""
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: Your session has no script access. Call this endpoint from an admin session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "Your session has no script access.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID exists. Check `chain_id` and `launch_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Validation saves nothing and sends nothing."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-scripts/#validate-script"
        }
      }
    },
    "/launch/funding/get-expected-funding/{launch_id}": {
      "post": {
        "operationId": "launch-scripts.retrieve-script-expected-funding",
        "summary": "Retrieve script plan funding",
        "description": "Returns the funding a saved script plan needs.\n\nFor a script plan the body is not read: the stored script states the plan. Projections such as `max_loss` and market caps are `null`.\n\nSame route as [Retrieve expected funding](/reference/launch-funding/#get-expected-funding) for regular plans.",
        "tags": [
          "Launch scripts"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "expected_funding": {
                      "type": "string",
                      "description": "Total funding needed, in native base units. Number or numeric string."
                    },
                    "expected_supply": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Expected token supply bought. Number or numeric string."
                    },
                    "breakdown": {
                      "type": "object",
                      "description": "Funding split: `dev_supply_cost`, `dev_extra_funding`, `holder_supply_cost`, `holder_extra_funding`, `funding_extra_funding`."
                    },
                    "max_loss": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Projected maximum loss."
                    },
                    "estimated_duration_ms": {
                      "type": "integer",
                      "description": "Estimated duration of the launch, in milliseconds."
                    }
                  }
                },
                "example": {
                  "expected_funding": "412000000",
                  "expected_supply": null,
                  "breakdown": {
                    "dev_supply_cost": "200000000",
                    "dev_extra_funding": "30000000",
                    "holder_supply_cost": "160000000",
                    "holder_extra_funding": "10000000",
                    "funding_extra_funding": "12000000"
                  },
                  "max_loss": null
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID belongs to your license. Check the ID, and that your token is upgraded onto the license that owns the launch.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "It only reads the stored plan."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-scripts/#retrieve-script-expected-funding"
        }
      }
    },
    "/launch/{chain_id}/{launch_id}/script/panel": {
      "get": {
        "operationId": "launch-scripts.retrieve-script-panel",
        "summary": "Retrieve the script panel",
        "description": "Returns the live state of the launch's script plan: steps, inputs and approvals.\n\nDescribes the launch's open plan, else its newest. `verbs` lists what you may apply to each step now, and `control_seq` is the `expect` value of a `skip`. The app polls it every 2 seconds while visible (10 seconds hidden) until the plan is `completed`, `aborted` or `failed`.\n\n`ui` objects are free-form display hints the plan never reads.",
        "tags": [
          "Launch scripts"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the launch.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "plan_id": {
                      "type": "string",
                      "description": "Plan ID (UUID)."
                    },
                    "status": {
                      "type": "string",
                      "description": "Plan status, such as `running`, `completed`, `aborted` or `failed`."
                    },
                    "origin": {
                      "type": "string",
                      "description": "Where the script came from, such as `custom`."
                    },
                    "version": {
                      "type": "integer",
                      "description": "Plan version."
                    },
                    "running_here": {
                      "type": "boolean",
                      "description": "This API host runs the plan."
                    },
                    "panel": {
                      "type": "object",
                      "properties": {
                        "plan": {
                          "type": "string",
                          "description": "Plan ID."
                        },
                        "status": {
                          "type": "string",
                          "description": "Plan status."
                        },
                        "steps": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Steps with `key`, `label`, `form` (`single`, `continuous`, `repeat`, `for_each`), `status`, `epoch`, `paused_by`, `verbs`, `control_seq`, `skip_next` and `ui`."
                        },
                        "inputs": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Value inputs with `name`, `label`, `unit`, `min`, `max`, `step`, `default`, `value`, `revision`, `affects` and `ui`."
                        },
                        "approvals": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Approval inputs with `name`, `label`, `ui`, `approved`, `closed` and `by`."
                        }
                      },
                      "description": "Panel state."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "plan_id": "84ac09e4-2eaa-42b8-9236-d5c07d2efffb",
                  "status": "running",
                  "origin": "custom",
                  "version": 4,
                  "running_here": true,
                  "panel": {
                    "plan": "84ac09e4-2eaa-42b8-9236-d5c07d2efffb",
                    "status": "running",
                    "steps": [
                      {
                        "key": "snipe",
                        "label": "Snipe",
                        "form": "single",
                        "status": "landed",
                        "epoch": 1,
                        "paused_by": [],
                        "verbs": [],
                        "control_seq": 0
                      },
                      {
                        "key": "stagger",
                        "label": "Stagger buys",
                        "form": "repeat",
                        "status": "running",
                        "epoch": 1,
                        "paused_by": [],
                        "verbs": [
                          "cancel",
                          "skip"
                        ],
                        "control_seq": 2
                      }
                    ],
                    "inputs": [
                      {
                        "name": "size",
                        "label": "Buy size",
                        "unit": "SOL",
                        "min": "0.05",
                        "max": "1",
                        "step": "0.05",
                        "default": "0.2",
                        "value": "0.25",
                        "revision": 1
                      }
                    ],
                    "approvals": [
                      {
                        "name": "stop",
                        "label": "Stop the stagger",
                        "ui": {
                          "color": "#d64545"
                        },
                        "approved": false,
                        "closed": false,
                        "by": [
                          "OWNER"
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`). Pass the launch's own chain, such as `sol` or `bsc`, with its `launch_id`.\n\n`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain \"<chain>\""
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: Your session has no script access. Call this endpoint from an admin session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "Your session has no script access.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID exists. Check `chain_id` and `launch_id`.\n\n`not_found`: No script plan has started on this launch. The app's panel hook, not the SDK, turns this into `null`. Start one with [Launch a script plan](/reference/launch-scripts/#launch-script-plan).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "No script plan has started on this launch. The app's panel hook, not the SDK, turns this into `null`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch has no script plan"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-scripts/#retrieve-script-panel"
        }
      }
    },
    "/launch/{chain_id}/{launch_id}/script/journal": {
      "get": {
        "operationId": "launch-scripts.list-script-journal",
        "summary": "List script journal lines",
        "description": "Pages through the journal of the launch's script plan.\n\nPass `next_after` as the next `after` while `more` is `true`.\n\nNot called by the current web app.",
        "tags": [
          "Launch scripts"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the launch.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "description": "Return lines after this sequence number. Start at `0`.",
            "schema": {
              "type": "integer",
              "default": "0"
            },
            "example": 0
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Lines per page, 1 to 500. The SDK sends 200.",
            "schema": {
              "type": "integer",
              "default": "100"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "plan_id": {
                      "type": "string",
                      "description": "Plan ID."
                    },
                    "status": {
                      "type": "string",
                      "description": "Plan status."
                    },
                    "lines": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "seq": {
                            "type": "integer",
                            "description": "Sequence number."
                          },
                          "kind": {
                            "type": "string",
                            "description": "Line kind, such as `plan.status`."
                          },
                          "subject": {
                            "type": "string",
                            "description": "What the line is about."
                          },
                          "detail": {
                            "anyOf": [
                              {
                                "type": "object"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Details."
                          }
                        }
                      },
                      "description": "Journal lines."
                    },
                    "next_after": {
                      "type": "integer",
                      "description": "Value of `after` for the next page."
                    },
                    "more": {
                      "type": "boolean",
                      "description": "More lines are available."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "plan_id": "84ac09e4-2eaa-42b8-9236-d5c07d2efffb",
                  "status": "running",
                  "lines": [
                    {
                      "seq": 1,
                      "kind": "plan.status",
                      "subject": "plan",
                      "detail": {}
                    }
                  ],
                  "next_after": 1,
                  "more": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`). Pass the launch's own chain, such as `sol` or `bsc`, with its `launch_id`.\n\n`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain \"<chain>\""
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: Your session has no script access. Call this endpoint from an admin session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "Your session has no script access.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID exists. Check `chain_id` and `launch_id`.\n\n`not_found`: No script plan has started on this launch. Start one with [Launch a script plan](/reference/launch-scripts/#launch-script-plan).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "No script plan has started on this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch has no script plan"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-scripts/#list-script-journal"
        }
      }
    },
    "/launch/{chain_id}/{launch_id}/script/control": {
      "post": {
        "operationId": "launch-scripts.control-script-step",
        "summary": "Control a script step",
        "description": "Cancels, pauses, resumes or skips a step, sets a value input, or grants an approval.\n\nEvery call carries an idempotency `key`: the same key with the same call answers the same record. Refusals answer `{ok: false, code, message, record}`.",
        "tags": [
          "Launch scripts"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the launch.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "verb": {
                    "type": "string",
                    "enum": [
                      "cancel",
                      "pause",
                      "resume",
                      "skip",
                      "set_input",
                      "approve"
                    ],
                    "description": "Control to apply."
                  },
                  "group": {
                    "type": "string",
                    "enum": [
                      "steps",
                      "finally"
                    ],
                    "description": "Group the step belongs to. Defaults to `steps`."
                  },
                  "step": {
                    "type": "string",
                    "description": "Step key. Required for every verb except `approve` and `set_input`."
                  },
                  "input": {
                    "type": "string",
                    "description": "Input to write. Required for `approve`, which grants an approval, and `set_input`, which sets a value input."
                  },
                  "value": {
                    "type": "string",
                    "description": "`set_input` only, required: the new value."
                  },
                  "expect": {
                    "type": "integer",
                    "description": "`skip` only, required: the step's current `control_seq`."
                  },
                  "fires": {
                    "type": "integer",
                    "description": "`skip` only: number of firings to skip."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Why, kept in the record."
                  },
                  "key": {
                    "type": "string",
                    "description": "Idempotency key."
                  }
                },
                "required": [
                  "verb",
                  "key"
                ]
              },
              "example": {
                "verb": "skip",
                "step": "stagger",
                "expect": 2,
                "key": "ops-2026-10-28-skip-1",
                "reason": "skip one round"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "record": {
                      "type": "object",
                      "properties": {
                        "seq": {
                          "type": "integer",
                          "description": "Sequence number of the record."
                        },
                        "by": {
                          "type": "object",
                          "description": "Who applied it."
                        },
                        "key": {
                          "type": "string",
                          "description": "Idempotency key of the call."
                        },
                        "verb": {
                          "type": "string",
                          "description": "Verb applied."
                        },
                        "outcome": {
                          "type": "string",
                          "description": "Outcome, such as `applied`."
                        }
                      },
                      "description": "The control as recorded."
                    },
                    "approved": {
                      "type": "string",
                      "description": "Name of the approval granted, for `approve`."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "record": {
                    "seq": 3,
                    "by": {
                      "role": "operator"
                    },
                    "key": "ops-2026-10-28-skip-1",
                    "verb": "skip",
                    "outcome": "applied"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`). Pass the launch's own chain, such as `sol` or `bsc`, with its `launch_id`.\n\n`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`idempotency_key_required`: `key` is missing or empty. Send a unique `key` with every control.\n\n`invalid_key`: `key` is longer than 128 characters. Send a `key` of at most 128 characters.\n\n`missing_field`: A field the verb needs is missing: `step` for a step verb, `input` for `approve` and `set_input`, and `value` for `set_input`. Send the fields the verb needs.\n\n`verb_not_offered`: `verb` is not one this endpoint takes. Send one of `pause`, `resume`, `cancel`, `skip`, `set_input` or `approve`.\n\n`invalid_value`: `group` is neither `steps` nor `finally`, `fires` is too large, or `approve` names a value input. Correct the field the message names.\n\n`unknown_input`: `approve` names an input the script doesn't declare. Use an approval name listed under `approvals` by [Retrieve the script panel](/reference/launch-scripts/#retrieve-script-panel).\n\n`if_match_required`: The control needs the step's current `control_seq` in `expect`. Send the step's `control_seq` from [Retrieve the script panel](/reference/launch-scripts/#retrieve-script-panel) as `expect`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain \"<chain>\""
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "idempotency_key_required": {
                    "summary": "`key` is missing or empty.",
                    "value": {
                      "ok": false,
                      "code": "idempotency_key_required",
                      "message": "key is required: the same key repeats the same answer"
                    }
                  },
                  "invalid_key": {
                    "summary": "`key` is longer than 128 characters.",
                    "value": {
                      "ok": false,
                      "code": "invalid_key",
                      "message": "key is at most 128 characters"
                    }
                  },
                  "missing_field": {
                    "summary": "A field the verb needs is missing: `step` for a step verb, `input` for `approve` and `set_input`, and `value` for `set_input`.",
                    "value": {
                      "ok": false,
                      "code": "missing_field",
                      "message": "a verb names its step in `step`"
                    }
                  },
                  "verb_not_offered": {
                    "summary": "`verb` is not one this endpoint takes.",
                    "value": {
                      "ok": false,
                      "code": "verb_not_offered",
                      "message": "\"<verb>\" is not offered here: pause, resume, cancel, skip, set_input or approve"
                    }
                  },
                  "invalid_value": {
                    "summary": "`group` is neither `steps` nor `finally`, `fires` is too large, or `approve` names a value input.",
                    "value": {
                      "ok": false,
                      "code": "invalid_value",
                      "message": "group is steps or finally, not \"<group>\""
                    }
                  },
                  "unknown_input": {
                    "summary": "`approve` names an input the script doesn't declare.",
                    "value": {
                      "ok": false,
                      "code": "unknown_input",
                      "message": "the script declares no input <input>"
                    }
                  },
                  "if_match_required": {
                    "summary": "The control needs the step's current `control_seq` in `expect`.",
                    "value": {
                      "ok": false,
                      "code": "if_match_required",
                      "message": "skip names the control_seq it read, in `expect`"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: Your session has no script access. Call this endpoint from an admin session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "Your session has no script access.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID exists. Check `chain_id` and `launch_id`.\n\n`not_found`: No script plan has started on this launch. Start one with [Launch a script plan](/reference/launch-scripts/#launch-script-plan).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "No script plan has started on this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch has no script plan"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`hold_refused`: This host holds no running action, so `pause` is refused. Send `cancel` to stop the step instead.\n\n`terminal`: The plan is `completed`, `aborted` or `failed`, so it takes no more controls. Check the plan's `status` with [Retrieve the script panel](/reference/launch-scripts/#retrieve-script-panel) before sending controls.\n\n`key_reused`: The `key` was already used for a different call. Send a new `key` for each distinct control.\n\n`role`: The script reserves this control to another role. Leave this control to the role the script names.\n\n`plan_held_elsewhere`: Another host runs the plan. Send the same call again.\n\n`plan_gone`: The process running the plan stopped before it answered, so the control may not have been applied. Send the same call with the same `key` again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "hold_refused": {
                    "summary": "This host holds no running action, so `pause` is refused.",
                    "value": {
                      "ok": false,
                      "code": "hold_refused",
                      "message": "this host holds no running action: pause is refused, cancel stops the step"
                    }
                  },
                  "terminal": {
                    "summary": "The plan is `completed`, `aborted` or `failed`, so it takes no more controls.",
                    "value": {
                      "ok": false,
                      "code": "terminal",
                      "message": "the plan has ended"
                    }
                  },
                  "key_reused": {
                    "summary": "The `key` was already used for a different call.",
                    "value": {
                      "ok": false,
                      "code": "key_reused",
                      "message": "this idempotency key carried another call"
                    }
                  },
                  "role": {
                    "summary": "The script reserves this control to another role.",
                    "value": {
                      "ok": false,
                      "code": "role",
                      "message": "this role may not do this"
                    }
                  },
                  "plan_held_elsewhere": {
                    "summary": "Another host runs the plan.",
                    "value": {
                      "ok": false,
                      "code": "plan_held_elsewhere",
                      "message": "another process runs this plan: ask again"
                    }
                  },
                  "plan_gone": {
                    "summary": "The process running the plan stopped before it answered, so the control may not have been applied.",
                    "value": {
                      "ok": false,
                      "code": "plan_gone",
                      "message": "the plan's runner stopped before it answered"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Send the same `key`: a repeat answers the first call's record instead of applying it again."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-scripts/#control-script-step"
        }
      }
    },
    "/launch/{chain_id}/{launch_id}/script/input": {
      "post": {
        "operationId": "launch-scripts.write-script-input",
        "summary": "Write a script input",
        "description": "Grants an approval, sets a value input or sends an event to an input the running script declares.\n\nWhat the body carries depends on the input's kind: an approval names its input alone, a value input carries `value` and an idempotency `key`, and an event input carries an arrival `id` and an optional `value`. An admin acts as the plan's operator; the license that owns the launch acts as its owner and cannot grant the launch's snipe approval.",
        "tags": [
          "Launch scripts"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "path",
            "required": true,
            "description": "Chain of the launch.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            },
            "example": "sol"
          },
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Public ID of the launch.",
            "schema": {
              "type": "string"
            },
            "example": "101482937561204"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "input": {
                    "type": "string",
                    "description": "Name of an input the script declares."
                  },
                  "id": {
                    "type": "string",
                    "description": "Event input only, required: the arrival's ID, at most 128 bytes. The same ID is taken once."
                  },
                  "value": {
                    "type": "string",
                    "description": "Value input, required: the new value. Event input: an optional payload for the arrival."
                  },
                  "key": {
                    "type": "string",
                    "description": "Value input only, required: idempotency key, at most 128 characters."
                  },
                  "expect": {
                    "type": "integer",
                    "description": "Value input only: optional, passed to the plan with the write."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Value input only: why, kept in the record."
                  }
                },
                "required": [
                  "input"
                ]
              },
              "example": {
                "input": "size",
                "value": "0.3",
                "key": "ops-2026-10-28-size-2"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "record": {
                      "type": "object",
                      "properties": {
                        "seq": {
                          "type": "integer",
                          "description": "Sequence number of the record."
                        },
                        "by": {
                          "type": "object",
                          "description": "Who applied it."
                        },
                        "key": {
                          "type": "string",
                          "description": "Idempotency key of the call."
                        },
                        "verb": {
                          "type": "string",
                          "description": "Verb applied."
                        },
                        "outcome": {
                          "type": "string",
                          "description": "Outcome, such as `applied`."
                        }
                      },
                      "description": "The control as recorded."
                    },
                    "approved": {
                      "type": "string",
                      "description": "Name of the approval granted, for `approve`."
                    },
                    "input": {
                      "type": "string",
                      "description": "Event input: the input the arrival was sent to."
                    },
                    "id": {
                      "type": "string",
                      "description": "Event input: ID of the arrival."
                    },
                    "count": {
                      "type": "integer",
                      "description": "Event input: arrival count reported by the plan."
                    },
                    "duplicate": {
                      "type": "boolean",
                      "description": "Event input: `true` when this `id` was already taken, so nothing new arrived."
                    }
                  }
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The body is not valid JSON, `input` is missing, a field has the wrong type, or the body has a field this endpoint does not take. Send only `input`, `id`, `value`, `key`, `expect` and `reason`, with the types listed above.\n\n`bad_request`: `chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`). Pass the launch's own chain, such as `sol` or `bsc`, with its `launch_id`.\n\n`bad_request`: `launch_id` is not a valid launch ID. Pass the `launch_id` returned when the launch was created, as listed by [List the license's launches](/reference/licenses/#list-mints).\n\n`missing_field`: `input` is empty. Send the name of an input listed by [Retrieve the script panel](/reference/launch-scripts/#retrieve-script-panel).\n\n`unknown_input`: `input` names an input the script does not declare. Use an input name listed by [Retrieve the script panel](/reference/launch-scripts/#retrieve-script-panel).\n\n`invalid_value`: The input is of a kind this endpoint does not write. Write only approval, value and event inputs.\n\n`invalid_value`: A value input was sent with an `id`. Drop `id` and send a `key`.\n\n`missing_field`: A value input was sent without `value`. Send the new value in `value`.\n\n`idempotency_key_required`: A value input was sent without a `key`, or with an empty one. Send a unique `key` with every write.\n\n`invalid_key`: `key` is longer than 128 characters. Send a `key` of at most 128 characters.\n\n`invalid_value`: An approval was sent with an `id` or a `value`. Send only `input` for an approval.\n\n`invalid_value`: An event input was sent with a `key` or `expect`. Drop `key` and `expect` and send an `id`.\n\n`missing_field`: An event input was sent without an `id`, or with an empty one. Send a unique `id` for each arrival.\n\n`invalid_value`: The event's `id` is longer than 128 bytes. Send an `id` of at most 128 bytes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The body is not valid JSON, `input` is missing, a field has the wrong type, or the body has a field this endpoint does not take.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`chain_id` is not a known chain, or `launch_id` belongs to another chain (`this launch id belongs to another chain`).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown chain \"<chain>\""
                    }
                  },
                  "bad_request_3": {
                    "summary": "`launch_id` is not a valid launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "missing_field": {
                    "summary": "`input` is empty.",
                    "value": {
                      "ok": false,
                      "code": "missing_field",
                      "message": "input names the input the script declares"
                    }
                  },
                  "unknown_input": {
                    "summary": "`input` names an input the script does not declare.",
                    "value": {
                      "ok": false,
                      "code": "unknown_input",
                      "message": "the script declares no input <input>"
                    }
                  },
                  "invalid_value": {
                    "summary": "The input is of a kind this endpoint does not write.",
                    "value": {
                      "ok": false,
                      "code": "invalid_value",
                      "message": "<input> is an input of kind <kind>, which this route does not take"
                    }
                  },
                  "invalid_value_2": {
                    "summary": "A value input was sent with an `id`.",
                    "value": {
                      "ok": false,
                      "code": "invalid_value",
                      "message": "a value input is written under `key`, not an `id`"
                    }
                  },
                  "missing_field_2": {
                    "summary": "A value input was sent without `value`.",
                    "value": {
                      "ok": false,
                      "code": "missing_field",
                      "message": "a value input carries its new value in `value`"
                    }
                  },
                  "idempotency_key_required": {
                    "summary": "A value input was sent without a `key`, or with an empty one.",
                    "value": {
                      "ok": false,
                      "code": "idempotency_key_required",
                      "message": "key is required: the same key repeats the same answer"
                    }
                  },
                  "invalid_key": {
                    "summary": "`key` is longer than 128 characters.",
                    "value": {
                      "ok": false,
                      "code": "invalid_key",
                      "message": "key is at most 128 characters"
                    }
                  },
                  "invalid_value_3": {
                    "summary": "An approval was sent with an `id` or a `value`.",
                    "value": {
                      "ok": false,
                      "code": "invalid_value",
                      "message": "an approval carries neither an id nor a value"
                    }
                  },
                  "invalid_value_4": {
                    "summary": "An event input was sent with a `key` or `expect`.",
                    "value": {
                      "ok": false,
                      "code": "invalid_value",
                      "message": "an event arrives under its own `id`: it takes no key or expect"
                    }
                  },
                  "missing_field_3": {
                    "summary": "An event input was sent without an `id`, or with an empty one.",
                    "value": {
                      "ok": false,
                      "code": "missing_field",
                      "message": "an event arrives under its own `id`: the same id is taken once"
                    }
                  },
                  "invalid_value_5": {
                    "summary": "The event's `id` is longer than 128 bytes.",
                    "value": {
                      "ok": false,
                      "code": "invalid_value",
                      "message": "an arrival's id is at most 128 bytes"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: Your session is neither an admin's nor that of the license that owns the launch. Call it from an admin session or with a token of the license that owns the launch.\n\n`snipe_approval`: The launch's owner tried to grant the approval that stands for the launch's snipe. Grant it with [Snipe a scheduled launch](/reference/launch-execution/#snipe-launch).\n\n`forbidden`: The call comes through a launch share whose grant does not include `automation.script`. Ask the launch's owner to add `automation.script` to the grant with [Update a grant](/reference/launch-sharing/#update-grant).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "Your session is neither an admin's nor that of the license that owns the launch.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role or the launch's own license required"
                    }
                  },
                  "snipe_approval": {
                    "summary": "The launch's owner tried to grant the approval that stands for the launch's snipe.",
                    "value": {
                      "ok": false,
                      "code": "snipe_approval",
                      "message": "<input> is this launch's snipe: POST /snipe/{ext_id} grants it"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The call comes through a launch share whose grant does not include `automation.script`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not grant automation.script"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch with this ID exists. Check `chain_id` and `launch_id`.\n\n`not_found`: No script plan has started on this launch. Start one with [Launch a script plan](/reference/launch-scripts/#launch-script-plan).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "No script plan has started on this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch has no script plan"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`terminal`: The plan is `completed`, `aborted` or `failed`, so it takes no more inputs. Check the plan's `status` with [Retrieve the script panel](/reference/launch-scripts/#retrieve-script-panel) before writing inputs.\n\n`key_reused`: A value input's `key` was already used for a different call. Send a new `key` for each distinct write.\n\n`plan_held_elsewhere`: Another host runs the plan. Send the same call again.\n\n`plan_gone`: The process running the plan stopped before it answered, so the input may not have been written. Send the same call with the same `key` or `id` again.\n\n`input_refused`: The plan refused the event's arrival. The message is its reason. Check the input in [Retrieve the script panel](/reference/launch-scripts/#retrieve-script-panel), then send the event again if it still applies.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "terminal": {
                    "summary": "The plan is `completed`, `aborted` or `failed`, so it takes no more inputs.",
                    "value": {
                      "ok": false,
                      "code": "terminal",
                      "message": "the plan has ended"
                    }
                  },
                  "key_reused": {
                    "summary": "A value input's `key` was already used for a different call.",
                    "value": {
                      "ok": false,
                      "code": "key_reused",
                      "message": "this idempotency key carried another call"
                    }
                  },
                  "plan_held_elsewhere": {
                    "summary": "Another host runs the plan.",
                    "value": {
                      "ok": false,
                      "code": "plan_held_elsewhere",
                      "message": "another process runs this plan: ask again"
                    }
                  },
                  "plan_gone": {
                    "summary": "The process running the plan stopped before it answered, so the input may not have been written.",
                    "value": {
                      "ok": false,
                      "code": "plan_gone",
                      "message": "the plan's runner stopped before it answered"
                    }
                  },
                  "input_refused": {
                    "summary": "The plan refused the event's arrival. The message is its reason.",
                    "value": {
                      "ok": false,
                      "code": "input_refused",
                      "message": "<reason>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Send the same `key` for a value input or the same `id` for an event: a repeat answers the first call's record, or comes back with `duplicate: true`. A second approval changes nothing."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-scripts/#write-script-input"
        }
      }
    },
    "/launch/tags/create-tag": {
      "post": {
        "operationId": "launch-tags.create-tag",
        "summary": "Create a tag",
        "description": "Creates a launch tag.\n\nNot called by the current web app.",
        "tags": [
          "Launch tags"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Tag name, up to 25 characters."
                  },
                  "color": {
                    "type": "string",
                    "description": "Color as `#RRGGBB`."
                  }
                },
                "required": [
                  "name",
                  "color"
                ]
              },
              "example": {
                "name": "Week 44",
                "color": "#7C5CFF"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "tag_id": {
                      "type": "integer",
                      "description": "ID of the new tag."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully created tag",
                  "tag_id": 42
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `name` is longer than 25 characters. Shorten `name` to 25 characters or fewer.\n\n`bad_request`: `color` is not `#` followed by six hex digits. Send `color` as `#RRGGBB`, for example `#7C5CFF`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`name` is longer than 25 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Tag name too long"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`color` is not `#` followed by six hex digits.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "color must be a hex string like #RRGGBB"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call creates a new tag, even with the same name. Look for it in `tags` from [List the license's launches](/reference/licenses/#list-mints) before sending it again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-tags/#create-tag"
        }
      }
    },
    "/launch/tags/update-tag": {
      "post": {
        "operationId": "launch-tags.update-tag",
        "summary": "Update a tag",
        "description": "Renames and recolors a launch tag.\n\nNot called by the current web app.",
        "tags": [
          "Launch tags"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "string",
                    "description": "Tag ID, as a string."
                  },
                  "new_name": {
                    "type": "string",
                    "description": "New name, up to 25 characters."
                  },
                  "new_color": {
                    "type": "string",
                    "description": "New color as `#RRGGBB`."
                  }
                },
                "required": [
                  "tag_id",
                  "new_name",
                  "new_color"
                ]
              },
              "example": {
                "tag_id": "42",
                "new_name": "Week 44 winners",
                "new_color": "#22C55E"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully updated tag"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `new_name` is longer than 25 characters. Shorten `new_name` to 25 characters or fewer.\n\n`bad_request`: `new_color` is not `#` followed by six hex digits. Send `new_color` as `#RRGGBB`, for example `#22C55E`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`new_name` is longer than 25 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Tag name too long"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`new_color` is not `#` followed by six hex digits.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "color must be a hex string like #RRGGBB"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No tag with this `tag_id` belongs to your license. Use a tag `id` from `tags` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No tag with this `tag_id` belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Tag not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat sets the same name and color again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-tags/#update-tag"
        }
      }
    },
    "/launch/tags/delete-tag": {
      "post": {
        "operationId": "launch-tags.delete-tag",
        "summary": "Delete a tag",
        "description": "Deletes a launch tag.\n\nNot called by the current web app.",
        "tags": [
          "Launch tags"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "string",
                    "description": "Tag ID, as a string."
                  }
                },
                "required": [
                  "tag_id"
                ]
              },
              "example": {
                "tag_id": "42"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully deleted tag"
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No tag with this `tag_id` belongs to your license, or it is already deleted. Use a tag `id` from `tags` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No tag with this `tag_id` belongs to your license, or it is already deleted.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Tag not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat after a successful delete answers `404` with `Tag not found`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-tags/#delete-tag"
        }
      }
    },
    "/launch/tags/tag-launches": {
      "post": {
        "operationId": "launch-tags.tag-launches",
        "summary": "Tag launches",
        "description": "Attaches a tag to one or more launches.\n\nNot called by the current web app.",
        "tags": [
          "Launch tags"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "string",
                    "description": "Tag ID, as a string."
                  },
                  "launch_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public IDs of the launches, as strings."
                  }
                },
                "required": [
                  "tag_id",
                  "launch_ids"
                ]
              },
              "example": {
                "tag_id": "42",
                "launch_ids": [
                  "101482937561204",
                  "101907315264588"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "linked": {
                      "type": "integer",
                      "description": "Launches newly tagged. Launches that already carry the tag and IDs that do not belong to your license are skipped without an error."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully tagged launches",
                  "linked": 2
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_ids` is empty. Send at least one launch ID in `launch_ids`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_ids` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No launch ids provided"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No tag with this `tag_id` belongs to your license. Use a tag `id` from `tags` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No tag with this `tag_id` belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Tag not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Launches that already carry the tag are skipped, so a repeat answers `linked: 0`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-tags/#tag-launches"
        }
      }
    },
    "/launch/tags/untag-launches": {
      "post": {
        "operationId": "launch-tags.untag-launches",
        "summary": "Untag launches",
        "description": "Removes a tag from one or more launches.\n\nNot called by the current web app.",
        "tags": [
          "Launch tags"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "tag_id": {
                    "type": "string",
                    "description": "Tag ID, as a string."
                  },
                  "launch_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Public IDs of the launches, as strings."
                  }
                },
                "required": [
                  "tag_id",
                  "launch_ids"
                ]
              },
              "example": {
                "tag_id": "42",
                "launch_ids": [
                  "101907315264588"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the request succeeded."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable outcome."
                    },
                    "removed": {
                      "type": "integer",
                      "description": "Launches the tag was removed from. Launches without the tag and IDs that do not belong to your license are skipped without an error."
                    }
                  }
                },
                "example": {
                  "ok": true,
                  "message": "Successfully untagged launches",
                  "removed": 1
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_ids` is empty. Send at least one launch ID in `launch_ids`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_ids` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No launch ids provided"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No tag with this `tag_id` belongs to your license. Use a tag `id` from `tags` in [List the license's launches](/reference/licenses/#list-mints).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No tag with this `tag_id` belongs to your license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Tag not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat finds nothing left to remove and answers `removed: 0`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-tags/#untag-launches"
        }
      }
    },
    "/launch/funding/get-required-funding/{launch_id}": {
      "get": {
        "operationId": "launch-funding.get-required-funding",
        "summary": "Retrieve required funding",
        "description": "Returns how much native and quote funding the launch's saved plan needs and whether it is in place.\n\nThe funding page and the launch flow read this to decide whether the launch can start.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a Required funding object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "is_funding_complete": {
                      "type": "boolean",
                      "description": "`true` when every wallet holds what the plan needs and no per-mint config is pending."
                    },
                    "stoxes_config_pending": {
                      "type": "boolean",
                      "description": "`true` only for an instant Stoxes MEV plan whose curve config is not on chain yet."
                    },
                    "lesgo_config_pending": {
                      "type": "boolean",
                      "description": "`true` for a Lesgo plan with a supply target whose curve config is not on chain yet."
                    },
                    "funding_status": {
                      "type": "string",
                      "enum": [
                        "None",
                        "Running",
                        "Failed"
                      ],
                      "description": "State of the launch's funding job."
                    },
                    "native_funding": {
                      "type": "object",
                      "properties": {
                        "total_funding_native": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Total native funding the plan needs, raw units. A decimal string on EVM chains."
                        },
                        "complete": {
                          "type": "boolean",
                          "description": "`true` when the native funding is in place."
                        }
                      },
                      "required": [
                        "total_funding_native"
                      ],
                      "description": "Native-token funding."
                    },
                    "quote_funding": {
                      "type": "object",
                      "properties": {
                        "complete": {
                          "type": "boolean",
                          "description": "`true` when the quote funding is in place."
                        },
                        "total_quote_funding": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Total quote funding the plan needs, in the quote token's atomic units. A decimal string on EVM chains."
                        },
                        "total_funding_quote": {
                          "type": "integer",
                          "description": "Deprecated wire name of `total_quote_funding`; read `total_quote_funding` first."
                        }
                      },
                      "required": [
                        "complete"
                      ],
                      "description": "Quote-token funding, for launches quoted in a token other than the native one."
                    },
                    "breakdown": {
                      "type": "object",
                      "properties": {
                        "dev_supply_cost": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Cost of the dev wallet's supply buy."
                        },
                        "dev_extra_funding": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Extra funding the dev wallet needs on top of its buy (fees, rent, reserves)."
                        },
                        "mev_extra_funding": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Extra funding for the MEV wallets."
                        },
                        "holder_supply_cost": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Cost of the holders' supply buys."
                        },
                        "holder_extra_funding": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Extra funding the holder wallets need on top of their buys."
                        },
                        "funding_extra_funding": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Overhead of the funding itself."
                        },
                        "fee_target_cost": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Cost of the fee target, when the plan sets one."
                        },
                        "total": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Sum of the breakdown."
                        }
                      },
                      "required": [
                        "dev_supply_cost",
                        "dev_extra_funding",
                        "mev_extra_funding",
                        "holder_supply_cost",
                        "holder_extra_funding",
                        "funding_extra_funding",
                        "total"
                      ],
                      "description": "How the native total splits across the plan. Integers are numbers on Solana and decimal strings on EVM chains."
                    }
                  },
                  "required": [
                    "is_funding_complete",
                    "funding_status",
                    "native_funding"
                  ]
                },
                "example": {
                  "native_funding": {
                    "total_funding_native": 4825000000,
                    "complete": false
                  },
                  "quote_funding": {
                    "total_quote_funding": 0,
                    "complete": true
                  },
                  "is_funding_complete": false,
                  "stoxes_config_pending": false,
                  "lesgo_config_pending": false,
                  "funding_status": "None",
                  "breakdown": {
                    "dev_supply_cost": 1500000000,
                    "dev_extra_funding": 25000000,
                    "mev_extra_funding": 0,
                    "holder_supply_cost": 3000000000,
                    "holder_extra_funding": 250000000,
                    "funding_extra_funding": 50000000,
                    "total": 4825000000
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: the launch has no saved plan yet. The same check answers `No funder wallet configured`, `No holder wallets saved` or `No holder amounts saved` for a partial plan. Save a complete plan with [Update the launch plan](/reference/launches/#update-launch-plan), then read the funding again.\n\n`bad_request`: The launch is a multi-launch group container whose group plan has not been saved. Save the group plan with [Update the launch plan](/reference/launches/#update-launch-plan) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the launch has no saved plan yet. The same check answers `No funder wallet configured`, `No holder wallets saved` or `No holder amounts saved` for a partial plan.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No launch method saved"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch is a multi-launch group container whose group plan has not been saved.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "configure the group plan first"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the saved plan is incomplete, for example it has no funder or no holder wallets. A plan with no method answers `No launch method saved`. Save a complete plan with [Update the launch plan](/reference/launches/#update-launch-plan), then read the funding again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the saved plan is incomplete, for example it has no funder or no holder wallets. A plan with no method answers `No launch method saved`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No launch data saved"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#get-required-funding"
        }
      }
    },
    "/launch/funding/fit-to-balances/{launch_id}": {
      "post": {
        "operationId": "launch-funding.fit-to-balances",
        "summary": "Fit holder buys to balances",
        "description": "Lowers each underfunded holder's planned buy to what its wallet balance covers.\n\nLets a draft launch go out without topping up short holders. Available for Solana launches with the Stagger or Manual method and a SOL quote. The dev wallet and the creation payer are not touched: the launch still refuses to start while either is short. Takes no body.\n\nRewrites the holders' planned buy amounts in the saved plan.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "adjusted": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pubkey": {
                            "type": "string",
                            "description": "Holder wallet."
                          },
                          "from": {
                            "type": "string",
                            "description": "Previous planned buy, lamports."
                          },
                          "to": {
                            "type": "string",
                            "description": "New planned buy, lamports."
                          }
                        },
                        "required": [
                          "pubkey",
                          "from",
                          "to"
                        ]
                      },
                      "description": "Holders whose buy was lowered."
                    },
                    "funded": {
                      "type": "boolean",
                      "description": "Whether the launch now passes the funding check the launch call makes."
                    }
                  },
                  "required": [
                    "ok",
                    "adjusted",
                    "funded"
                  ]
                },
                "example": {
                  "ok": true,
                  "adjusted": [
                    {
                      "pubkey": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                      "from": "250000000",
                      "to": "187500000"
                    },
                    {
                      "pubkey": "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                      "from": "250000000",
                      "to": "0"
                    }
                  ],
                  "funded": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: The launch is on an EVM chain. Fund the holders instead: only Solana launches (IDs starting with `101`) can be fitted.\n\n`bad_request`: The launch's plan is a script. Fund the holders instead with [Fund the launch wallets](/reference/launch-execution/#fund-launch-wallets).\n\n`bad_request`: The launch method is not Stagger or Manual. Fund the holders instead: only `Stagger` and `Manual` plans can be fitted.\n\n`bad_request`: The launch is quoted in a token other than SOL. Fund the holders instead: only SOL-quoted launches can be fitted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is on an EVM chain.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Buying what the balances allow is only available on Solana"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch's plan is a script.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "A scripted launch plan cannot be fitted to balances"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The launch method is not Stagger or Manual.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Buying what the balances allow is only available for Stagger and Manual launches"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The launch is quoted in a token other than SOL.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Buying what the balances allow needs a SOL quoted launch"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The launch is no longer a draft. Read the launch with [Retrieve a launch](/reference/launches/#retrieve-launch): only a draft can be fitted.\n\n`conflict`: The launch left draft while the buys were being fitted, so nothing was saved. Read the launch with [Retrieve a launch](/reference/launches/#retrieve-launch): only a draft can be fitted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The launch is no longer a draft.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Token already launched"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch left draft while the buys were being fitted, so nothing was saved.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "The launch is no longer a draft"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: A pump.fun Stagger launch with no dev buy: fitted to their balances, every holder's buy drops to 0, so the launch would buy nothing. Nothing was saved. Fund the holder wallets with [Fund the launch wallets](/reference/launch-execution/#fund-launch-wallets) before fitting.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "A pump.fun Stagger launch with no dev buy: fitted to their balances, every holder's buy drops to 0, so the launch would buy nothing. Nothing was saved.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No wallet holds enough to buy anything"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The saved plan is incomplete, for example it has no funder or no holder wallets. A plan with no method answers `No launch method saved`. Save a complete plan with [Update the launch plan](/reference/launches/#update-launch-plan), then fit again.\n\n`internal_error`: The launch's funding job is still running. Wait for the funding job to finish or cancel it from [List funding jobs](/reference/funding/#list-funding-jobs), then fit again.\n\n`internal_error`: The wallet balances could not be read from the RPC. Nothing was changed. Retry after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The saved plan is incomplete, for example it has no funder or no holder wallets. A plan with no method answers `No launch method saved`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch data saved"
                    }
                  },
                  "internal_error_2": {
                    "summary": "The launch's funding job is still running.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funding already running"
                    }
                  },
                  "internal_error_3": {
                    "summary": "The wallet balances could not be read from the RPC. Nothing was changed.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "RPC error while fetching wallet balances"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat recomputes from the current balances and leaves holders already fitted as they are, so it answers an empty `adjusted` list. It never raises a buy back."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#fit-to-balances"
        }
      }
    },
    "/launch/funding/rescue-funding/{launch_id}": {
      "post": {
        "operationId": "launch-funding.rescue-funding",
        "summary": "Rescue funding",
        "description": "Sweeps SOL left on the launch's funding proxy accounts back to the funder.\n\nApplies to Classic funding on Solana. When a proxy cannot pay its own transaction fee, the funder pays it. The linked funding job is cancelled. Other funding types answer `No fund to rescue`. Takes no body.\n\nMoves funds on-chain from the proxy accounts to the funder wallet.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message`: `Successfully withdrew`, or `No fund to rescue` when the proxies are empty.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully withdrew"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Some proxy accounts cannot pay their own fee and the funder holds too little to pay it for them. Nothing is sent for those proxies. Send SOL to the funder wallet, then rescue again.\n\n`unprocessable`: Some proxy accounts still hold lamports two seconds after the sweep, because a transfer did not land in time. The funding job is cancelled anyway. Call it again: each call sweeps only what the proxies still hold.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Some proxy accounts cannot pay their own fee and the funder holds too little to pay it for them. Nothing is sent for those proxies.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Funder <funder> holds <balance> lamports, under the <floor> needed to pay the rescue fee for <count> proxy account(s). Fund it and rescue again."
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Some proxy accounts still hold lamports two seconds after the sweep, because a transfer did not land in time. The funding job is cancelled anyway.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "<count> proxy account(s) still hold <lamports> lamports after the rescue; rescue again"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The launch's funding job is still running. Wait for the funding job to finish or cancel it from [List funding jobs](/reference/funding/#list-funding-jobs), then rescue again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The launch's funding job is still running.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Funding already running"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call sweeps what the proxy accounts hold at that moment back to the funder, so a repeat only moves what is left and answers `No fund to rescue` once they are empty."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#rescue-funding"
        }
      }
    },
    "/launch/funding/swap-to-quote/{launch_id}": {
      "post": {
        "operationId": "launch-funding.swap-to-quote",
        "summary": "Swap funding to the quote token",
        "description": "Buys, in each launch wallet, the quote token it still needs, paying with its native funding.\n\nUsed on launches quoted in a token other than the native one, after native funding is complete. Each wallet keeps what it needs for its own gas. Takes no body.\n\nExecutes swaps on-chain from the launch wallets.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message`. Besides `Successfully swapped`, the call can succeed with `Native quote launch, no swap needed`, `No funding needed` or `Total native funding not completed` without swapping. On EVM chains the body also carries `swapped` (`wallet`, `tx_hash`) and `failed` lists, the message can be `All wallets already hold their quote`, and a partial run answers HTTP 200 with `ok: false` and `Swapped <n> of <m> wallets` or `Failed to approve quote spenders`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` on success. On EVM chains, `false` with HTTP 200 when some wallets failed."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully swapped"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is a multi-launch group container, which only holds the gas token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch groups are gas-token only"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: the quote's market is too thin: buying the funding's quote and selling it back would lose more than the allowed band. Variants: `<quote_mint> sells back to nothing`, `<quote_mint> cannot be bought: <reason>`. Fund the wallets with the quote token directly, or plan a launch with a deeper quote.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: the quote's market is too thin: buying the funding's quote and selling it back would lose more than the allowed band. Variants: `<quote_mint> sells back to nothing`, `<quote_mint> cannot be bought: <reason>`.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "<quote_mint> is too thin for this funding: buying <quote_atoms> costs <spent> lamports and selling it back returns <recovered>, <excess_bps> bps over the <band_bps> bps allowed"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: a wallet's swap got no confirmation after three attempts and may still land. Other wallets may already have swapped. Wait a minute, then check [Retrieve required funding](/reference/launch-funding/#get-required-funding) before calling again.\n\n`internal_error`: Solana: a wallet's swap failed on chain on every attempt. Other wallets may already have swapped. Call it again: wallets that already hold their quote are skipped.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: a wallet's swap got no confirmation after three attempts and may still land. Other wallets may already have swapped.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Tx unconfirmed after maximum retries"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: a wallet's swap failed on chain on every attempt. Other wallets may already have swapped.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Tx failed after maximum retries"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve required funding](/reference/launch-funding/#get-required-funding) first: once `quote_funding.complete` is `true` there is nothing left to buy. A repeat only buys what each wallet still lacks, but cannot see a swap that is still landing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#swap-to-quote"
        }
      }
    },
    "/quote/swap/{launch_id}": {
      "post": {
        "operationId": "launch-funding.quote-swap",
        "summary": "Swap between native and quote",
        "description": "Swaps between the native token and the launch's quote token in the selected launch wallets.\n\nEach wallet is handled on its own and reported in `results`; one wallet failing does not fail the call. With `exact_in`, `amount` is the input to spend and `0` sweeps the whole input balance. With `exact_out`, `amount` is the output to receive and `0` skips the wallet. Omit `wallets` to sweep every launch wallet (the funder excluded) as `exact_in`. The client sends wallet amounts as integer strings.\n\nExecutes swaps on-chain from the launch wallets.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "direction": {
                    "type": "string",
                    "enum": [
                      "quote_to_native",
                      "native_to_quote"
                    ],
                    "description": "`native_to_quote` spends the native token to buy the quote token; `quote_to_native` sells the quote token for the native token."
                  },
                  "swap_mode": {
                    "type": "string",
                    "enum": [
                      "exact_in",
                      "exact_out"
                    ],
                    "description": "Which end of each swap `amount` fixes."
                  },
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "address": {
                          "type": "string",
                          "description": "Wallet address."
                        },
                        "amount": {
                          "type": "string",
                          "description": "Amount, raw units, as an integer string."
                        }
                      },
                      "required": [
                        "address"
                      ]
                    },
                    "description": "Wallets to swap from. Each must belong to the launch; the funder may be named explicitly."
                  },
                  "slippage_bps": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points."
                  }
                },
                "required": [
                  "direction"
                ]
              },
              "example": {
                "direction": "native_to_quote",
                "swap_mode": "exact_out",
                "wallets": [
                  {
                    "address": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                    "amount": "25000000"
                  },
                  {
                    "address": "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                    "amount": "25000000"
                  }
                ],
                "slippage_bps": 100
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the batch ran."
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "wallet": {
                            "type": "string",
                            "description": "Wallet address."
                          },
                          "token": {
                            "type": "string",
                            "description": "Token involved, when relevant."
                          },
                          "status": {
                            "type": "string",
                            "enum": [
                              "swapped",
                              "skipped",
                              "failed"
                            ],
                            "description": "Outcome for this wallet."
                          },
                          "reason": {
                            "type": "string",
                            "description": "Why the wallet was skipped or failed."
                          },
                          "amount": {
                            "type": "string",
                            "description": "Fixed-end amount, raw units."
                          },
                          "tx_hash": {
                            "type": "string",
                            "description": "EVM only: hash of the swap transaction. Solana results carry no signature."
                          }
                        },
                        "required": [
                          "wallet",
                          "status"
                        ]
                      },
                      "description": "One entry per wallet."
                    }
                  },
                  "required": [
                    "ok",
                    "results"
                  ]
                },
                "example": {
                  "ok": true,
                  "results": [
                    {
                      "wallet": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                      "status": "swapped",
                      "amount": "25000000"
                    },
                    {
                      "wallet": "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                      "status": "skipped",
                      "reason": "insufficient input"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: Solana: an entry of `wallets` is not a valid address. Send base58 Solana addresses in `wallets[].address`.\n\n`bad_request`: EVM: an entry of `wallets` is not a valid address. Send `0x` addresses in `wallets[].address`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is a multi-launch group container, which only holds the gas token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch groups are gas-token only"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Solana: an entry of `wallets` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid wallet pubkey: <address>"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: an entry of `wallets` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid wallet address: <address>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one.\n\n`unprocessable`: Solana: an entry of `wallets` is not a wallet of this launch. On EVM chains that wallet is reported as `skipped` instead. Name only the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`unprocessable`: Solana: fees from a recent sell are still settling on the launch's wallets (waited 30 seconds). Retry in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is quoted in the chain's native token, so there is no quote token to swap.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No quote mint for this launch"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Solana: an entry of `wallets` is not a wallet of this launch. On EVM chains that wallet is reported as `skipped` instead.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "wallet <address> not in launch"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "Solana: fees from a recent sell are still settling on the launch's wallets (waited 30 seconds).",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Sale fees are still settling; retry the swap shortly"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Look for the call's `launch.swap` event in [List a launch's activity events](/reference/history/#list-launch-events) before sending it again: it lists each wallet's outcome and is written when the batch finishes. A repeat with explicit amounts swaps them a second time."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#quote-swap"
        }
      }
    },
    "/quote/estimate-out/{launch_id}": {
      "post": {
        "operationId": "launch-funding.estimate-out",
        "summary": "Estimate swap output",
        "description": "Prices an exact-input swap between the native token and the quote token without executing it.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "direction": {
                    "type": "string",
                    "enum": [
                      "quote_to_native",
                      "native_to_quote"
                    ],
                    "description": "`native_to_quote` spends the native token to buy the quote token; `quote_to_native` sells the quote token for the native token."
                  },
                  "amount": {
                    "type": "string",
                    "description": "Input amount, raw units, as an integer string. Must be greater than 0."
                  },
                  "slippage_bps": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points."
                  }
                },
                "required": [
                  "direction",
                  "amount"
                ]
              },
              "example": {
                "direction": "native_to_quote",
                "amount": "1000000000",
                "slippage_bps": 50
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the route's quote. Amounts are raw units, as decimal strings.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when a route was found."
                    },
                    "swap_mode": {
                      "type": "string",
                      "enum": [
                        "ExactIn",
                        "ExactOut"
                      ],
                      "description": "Which end of the swap is fixed."
                    },
                    "input_mint": {
                      "type": "string",
                      "description": "Mint (or token address) spent."
                    },
                    "output_mint": {
                      "type": "string",
                      "description": "Mint (or token address) received."
                    },
                    "in_amount": {
                      "type": "string",
                      "description": "Input amount, raw units."
                    },
                    "out_amount": {
                      "type": "string",
                      "description": "Output amount, raw units."
                    },
                    "other_amount_threshold": {
                      "type": "string",
                      "description": "Slippage-adjusted bound on the non-fixed end: minimum output for `ExactIn`, maximum input for `ExactOut`."
                    },
                    "price_impact_pct": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Price impact of the route, in percent. Always `null` on EVM chains, and `null` on Solana when the route reports none."
                    },
                    "slippage_bps": {
                      "type": "integer",
                      "description": "Slippage applied to the threshold, in basis points."
                    }
                  },
                  "required": [
                    "ok",
                    "swap_mode",
                    "input_mint",
                    "output_mint",
                    "in_amount",
                    "out_amount",
                    "other_amount_threshold",
                    "price_impact_pct",
                    "slippage_bps"
                  ]
                },
                "example": {
                  "ok": true,
                  "swap_mode": "ExactIn",
                  "input_mint": "So11111111111111111111111111111111111111112",
                  "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                  "in_amount": "1000000000",
                  "out_amount": "187420311",
                  "other_amount_threshold": "186483209",
                  "price_impact_pct": "0.0004",
                  "slippage_bps": 50
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `amount` is 0. Send an `amount` greater than 0.\n\n`bad_request`: The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`amount` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "amount must be greater than 0"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch is a multi-launch group container, which only holds the gas token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch groups are gas-token only"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one.\n\n`unprocessable`: EVM: no pool can fill this amount. Try a smaller amount.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is quoted in the chain's native token, so there is no quote token to swap.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No quote mint for this launch"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "EVM: no pool can fill this amount.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "no route for that size on <chain>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the swap router returned no route for this amount. A timeout answers `jupiter quote timed out`. Retry, or try a smaller amount.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the swap router returned no route for this amount. A timeout answers `jupiter quote timed out`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "jupiter quote failed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only: nothing is sent."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#estimate-out"
        }
      }
    },
    "/quote/estimate-in/{launch_id}": {
      "post": {
        "operationId": "launch-funding.estimate-in",
        "summary": "Estimate swap input",
        "description": "Prices an exact-output swap between the native token and the quote token without executing it.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "direction": {
                    "type": "string",
                    "enum": [
                      "quote_to_native",
                      "native_to_quote"
                    ],
                    "description": "`native_to_quote` spends the native token to buy the quote token; `quote_to_native` sells the quote token for the native token."
                  },
                  "amount": {
                    "type": "string",
                    "description": "Output amount wanted, raw units, as an integer string. Must be greater than 0."
                  },
                  "slippage_bps": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points."
                  }
                },
                "required": [
                  "direction",
                  "amount"
                ]
              },
              "example": {
                "direction": "native_to_quote",
                "amount": "50000000",
                "slippage_bps": 50
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the route's quote. Amounts are raw units, as decimal strings.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when a route was found."
                    },
                    "swap_mode": {
                      "type": "string",
                      "enum": [
                        "ExactIn",
                        "ExactOut"
                      ],
                      "description": "Which end of the swap is fixed."
                    },
                    "input_mint": {
                      "type": "string",
                      "description": "Mint (or token address) spent."
                    },
                    "output_mint": {
                      "type": "string",
                      "description": "Mint (or token address) received."
                    },
                    "in_amount": {
                      "type": "string",
                      "description": "Input amount, raw units."
                    },
                    "out_amount": {
                      "type": "string",
                      "description": "Output amount, raw units."
                    },
                    "other_amount_threshold": {
                      "type": "string",
                      "description": "Slippage-adjusted bound on the non-fixed end: minimum output for `ExactIn`, maximum input for `ExactOut`."
                    },
                    "price_impact_pct": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Price impact of the route, in percent. Always `null` on EVM chains, and `null` on Solana when the route reports none."
                    },
                    "slippage_bps": {
                      "type": "integer",
                      "description": "Slippage applied to the threshold, in basis points."
                    }
                  },
                  "required": [
                    "ok",
                    "swap_mode",
                    "input_mint",
                    "output_mint",
                    "in_amount",
                    "out_amount",
                    "other_amount_threshold",
                    "price_impact_pct",
                    "slippage_bps"
                  ]
                },
                "example": {
                  "ok": true,
                  "swap_mode": "ExactOut",
                  "input_mint": "So11111111111111111111111111111111111111112",
                  "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                  "in_amount": "266781504",
                  "out_amount": "50000000",
                  "other_amount_threshold": "268115411",
                  "price_impact_pct": "0.0001",
                  "slippage_bps": 50
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `amount` is 0. Send an `amount` greater than 0.\n\n`bad_request`: The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`amount` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "amount must be greater than 0"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The launch is a multi-launch group container, which only holds the gas token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch groups are gas-token only"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one.\n\n`unprocessable`: EVM: no pool can fill this amount. Try a smaller amount.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is quoted in the chain's native token, so there is no quote token to swap.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No quote mint for this launch"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "EVM: no pool can fill this amount.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "no route for that size on <chain>"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the swap router returned no route for this amount. A timeout answers `jupiter quote timed out`. Retry, or try a smaller amount.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the swap router returned no route for this amount. A timeout answers `jupiter quote timed out`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "jupiter quote failed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only: nothing is sent."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#estimate-in"
        }
      }
    },
    "/quote/max/{launch_id}": {
      "post": {
        "operationId": "launch-funding.quote-max",
        "summary": "Retrieve maximum swap inputs",
        "description": "Returns the largest input each launch wallet can swap in the given direction, and their total.\n\nFor `native_to_quote`, the maximum is the spendable native balance after the fee reserve; for `quote_to_native`, the whole quote balance. The app uses it to cap inputs so a \"max\" swap is not skipped.",
        "tags": [
          "Launch funding"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "direction": {
                    "type": "string",
                    "enum": [
                      "quote_to_native",
                      "native_to_quote"
                    ],
                    "description": "`native_to_quote` spends the native token to buy the quote token; `quote_to_native` sells the quote token for the native token."
                  },
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Wallet addresses to include. Omit or send an empty array for all launch wallets."
                  }
                },
                "required": [
                  "direction"
                ]
              },
              "example": {
                "direction": "quote_to_native",
                "wallets": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "type": "string",
                            "description": "Wallet address."
                          },
                          "max_in": {
                            "type": "string",
                            "description": "Maximum input, raw units."
                          }
                        },
                        "required": [
                          "address",
                          "max_in"
                        ]
                      },
                      "description": "Per-wallet maximum."
                    },
                    "total_max_in": {
                      "type": "string",
                      "description": "Sum of `max_in`, raw units."
                    }
                  },
                  "required": [
                    "ok",
                    "wallets",
                    "total_max_in"
                  ]
                },
                "example": {
                  "ok": true,
                  "wallets": [
                    {
                      "address": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                      "max_in": "24871002"
                    },
                    {
                      "address": "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                      "max_in": "25000000"
                    }
                  ],
                  "total_max_in": "49871002"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: The launch is a multi-launch group container, which only holds the gas token. Call it on a single launch: a multi-launch group has no quote token.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: Solana: an entry of `wallets` is not a valid address. Send base58 Solana addresses in `wallets`.\n\n`bad_request`: EVM: an entry of `wallets` is not a valid address. Send `0x` addresses in `wallets`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The launch is a multi-launch group container, which only holds the gas token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch groups are gas-token only"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "Solana: an entry of `wallets` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid wallet pubkey: <address>"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: an entry of `wallets` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid wallet address: <address>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is quoted in the chain's native token, so there is no quote token to swap. Call it only for launches quoted in a token other than the native one.\n\n`unprocessable`: An entry of `wallets` is not a wallet of this launch. Name only the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is quoted in the chain's native token, so there is no quote token to swap.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No quote mint for this launch"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "An entry of `wallets` is not a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "wallet <address> not in launch"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only: nothing is sent."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-funding/#quote-max"
        }
      }
    },
    "/launch/sniper-guard/plan/{launch_id}": {
      "post": {
        "operationId": "sniper-guard.plan-sniper-guard",
        "summary": "Plan a Sniper Guard",
        "description": "Saves a Sniper Guard configuration for the launch as `Planned`.\n\nCalling it again before the guard runs replaces the saved configuration. The backend rejects an enabled guard with neither a positive `max_external_quote` nor an `auto_nuke_delay_secs`, an `auto_nuke_delay_secs` of 0, and `complete_early` combined with an auto-nuke timer.\n\nWhen it triggers, the guard can sell launch wallets and finalize the launch without further confirmation.",
        "tags": [
          "Sniper Guard"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "enabled": {
                    "type": "boolean",
                    "description": "Whether the guard is active. A disabled guard skips every other check."
                  },
                  "max_external_quote": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Quote amount external wallets may buy before the guard triggers, raw quote units (lamports on SOL-quoted launches). Must be greater than 0 when enabled, unless `auto_nuke_delay_secs` is set."
                  },
                  "max_external_sol": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Legacy name of `max_external_quote`, still accepted."
                  },
                  "trigger_mode": {
                    "type": "string",
                    "enum": [
                      "nuke",
                      "nuke_keep_dev",
                      "nuke_dev_only",
                      "nuke_dev_only_continue",
                      "complete_early"
                    ],
                    "description": "What the guard does when it triggers. `nuke` sells every launch wallet including the dev and finalizes the launch; `nuke_keep_dev` sells all but the dev; `nuke_dev_only` sells the dev only and finalizes; `nuke_dev_only_continue` sells the dev only and keeps the launch running; `complete_early` stops holder buys and finalizes without selling.",
                    "default": "nuke"
                  },
                  "whitelist": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Additional wallets whose buys are not counted as external. The launch's own wallets are always excluded."
                  },
                  "end_condition": {
                    "anyOf": [
                      {
                        "type": "object"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "When monitoring stops: `\"until_complete\"` (until the launch finishes) or `{ \"timed\": { \"duration_secs\": N } }`.",
                    "default": "until_complete"
                  },
                  "auto_nuke_delay_secs": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Triggers after this many seconds instead of watching external buys. Must be greater than 0, and cannot be combined with `complete_early`."
                  }
                },
                "required": [
                  "enabled"
                ]
              },
              "example": {
                "enabled": true,
                "max_external_quote": "2000000000",
                "trigger_mode": "nuke_keep_dev",
                "whitelist": [],
                "end_condition": {
                  "timed": {
                    "duration_secs": 600
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully planned sniper guard"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: EVM launches and launch groups: `enabled` is `true` with no `auto_nuke_delay_secs` and a `max_external_quote` of 0 or missing. Send a positive `max_external_quote`, or set `auto_nuke_delay_secs` instead.\n\n`bad_request`: EVM launches and launch groups: `auto_nuke_delay_secs` is 0. Send a positive `auto_nuke_delay_secs`, or `null` to watch external buys instead.\n\n`bad_request`: EVM launches and launch groups: `trigger_mode` is `complete_early` together with an `auto_nuke_delay_secs`. Pick another `trigger_mode`, or drop `auto_nuke_delay_secs`.\n\n`bad_request`: `launch_id` is a multi-launch group container whose plan is no longer a draft. Plan the guard before the group launches; once it resolves, plan it on the winning member's launch ID.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM launches and launch groups: `enabled` is `true` with no `auto_nuke_delay_secs` and a `max_external_quote` of 0 or missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "max_external_quote must be greater than 0 when enabled"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM launches and launch groups: `auto_nuke_delay_secs` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "auto_nuke_delay_secs must be greater than 0"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM launches and launch groups: `trigger_mode` is `complete_early` together with an `auto_nuke_delay_secs`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "complete_early trigger mode is not allowed with auto-nuke timer"
                    }
                  },
                  "bad_request_6": {
                    "summary": "`launch_id` is a multi-launch group container whose plan is no longer a draft.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch group plan can only be edited while draft"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The launch's guard is already running (EVM: also when its saved session is `Running`). Leave the running guard as it is, or stop it with [Cancel a Sniper Guard](/reference/sniper-guard/#cancel-sniper-guard) before planning a new one.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The launch's guard is already running (EVM: also when its saved session is `Running`).",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Sniper guard task already running"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the same three validation rules fail. Solana answers them with `500` and the same messages: `max_external_quote must be greater than 0 when enabled`, `auto_nuke_delay_secs must be greater than 0`, `complete_early trigger mode is not allowed with auto-nuke timer`. Fix the parameter named in `message`; do not retry the same body.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the same three validation rules fail. Solana answers them with `500` and the same messages: `max_external_quote must be greater than 0 when enabled`, `auto_nuke_delay_secs must be greater than 0`, `complete_early trigger mode is not allowed with auto-nuke timer`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "max_external_quote must be greater than 0 when enabled"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Planning again overwrites the saved configuration of the `Planned` guard. While the guard runs, a repeat answers `409`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/sniper-guard/#plan-sniper-guard"
        }
      }
    },
    "/launch/sniper-guard/status/{launch_id}": {
      "get": {
        "operationId": "sniper-guard.get-sniper-guard-status",
        "summary": "Retrieve Sniper Guard status",
        "description": "Returns the launch's Sniper Guard session and its live counters.",
        "tags": [
          "Sniper Guard"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a Sniper Guard status object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "None",
                        "Planned",
                        "Running",
                        "Completed",
                        "Failed",
                        "Cancelled"
                      ],
                      "description": "Session state."
                    },
                    "is_live": {
                      "type": "boolean",
                      "description": "`true` while the guard task is running on the server."
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "params": {
                          "type": "object",
                          "description": "The configuration saved by the plan call; same fields as its request body."
                        },
                        "started_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp the session started. `0` on Solana and `null` on EVM until it starts."
                        },
                        "ended_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp the session ended. `0` on Solana and `null` on EVM until it ends."
                        },
                        "status_reason": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Why the session ended or failed, when known."
                        }
                      },
                      "required": [
                        "params",
                        "started_at",
                        "ended_at",
                        "status_reason"
                      ],
                      "description": "Session details. Absent when `status` is `None`."
                    },
                    "live_stats": {
                      "type": "object",
                      "properties": {
                        "external_quote_bought": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Quote bought by external wallets so far, raw units."
                        },
                        "max_external_quote": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Configured threshold, raw units."
                        },
                        "remaining_quote": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Quote left before the guard triggers, raw units."
                        },
                        "auto_nuke_remaining_secs": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Seconds left before an auto-nuke timer fires."
                        },
                        "external_sol_bought": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Legacy name of `external_quote_bought`."
                        },
                        "max_external_sol": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Legacy name of `max_external_quote`."
                        },
                        "remaining_sol": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Legacy name of `remaining_quote`."
                        }
                      },
                      "required": [
                        "external_quote_bought",
                        "max_external_quote",
                        "remaining_quote"
                      ],
                      "description": "Live counters, present while the guard runs."
                    }
                  },
                  "required": [
                    "status",
                    "is_live"
                  ]
                },
                "example": {
                  "status": "Running",
                  "is_live": true,
                  "info": {
                    "params": {
                      "enabled": true,
                      "max_external_quote": 2000000000,
                      "whitelist": [],
                      "trigger_mode": "nuke_keep_dev",
                      "end_condition": {
                        "timed": {
                          "duration_secs": 600
                        }
                      },
                      "auto_nuke_delay_secs": null
                    },
                    "started_at": 1793655010,
                    "ended_at": 0,
                    "status_reason": null
                  },
                  "live_stats": {
                    "external_quote_bought": 850000000,
                    "max_external_quote": 2000000000,
                    "remaining_quote": 1150000000,
                    "external_sol_bought": 850000000,
                    "max_external_sol": 2000000000,
                    "remaining_sol": 1150000000
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/sniper-guard/#get-sniper-guard-status"
        }
      }
    },
    "/launch/sniper-guard/cancel/{launch_id}": {
      "post": {
        "operationId": "sniper-guard.cancel-sniper-guard",
        "summary": "Cancel a Sniper Guard",
        "description": "Stops the launch's planned or running Sniper Guard.",
        "tags": [
          "Sniper Guard"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Sniper guard successfully cancelled"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Cancelling again leaves the guard `Cancelled` and stops nothing more."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/sniper-guard/#cancel-sniper-guard"
        }
      }
    },
    "/launch/sniper-guard/discard/{launch_id}": {
      "post": {
        "operationId": "sniper-guard.discard-sniper-guard",
        "summary": "Discard a Sniper Guard session",
        "description": "Clears a finished Sniper Guard session from the launch.",
        "tags": [
          "Sniper Guard"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully discarded sniper guard session status"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: the guard task is still running. Stop the guard with [Cancel a Sniper Guard](/reference/sniper-guard/#cancel-sniper-guard) first, then discard.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: the guard task is still running.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot discard running session"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Discarding again finds nothing to clear and answers `200`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/sniper-guard/#discard-sniper-guard"
        }
      }
    },
    "/launch/allowlist/pause/{launch_id}": {
      "post": {
        "operationId": "allowlist.pause-allowlist",
        "summary": "Pause an allowlist run",
        "description": "Stops the run before its next broadcast.",
        "tags": [
          "Allowlist"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "draft",
                        "planned",
                        "running",
                        "paused",
                        "finished",
                        "failed"
                      ],
                      "description": "Run state after the transition."
                    }
                  },
                  "required": [
                    "ok",
                    "state"
                  ]
                },
                "example": {
                  "ok": true,
                  "state": "paused"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license in your token has no beta access. Checked before the launch ID.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "allowlist curve launches are open to beta licenses only"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with `create_params.allowlist`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch exists but is not an allowlist curve launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch is not an allowlist curve launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: 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.\n\n`conflict`: The run has already finished. Nothing is left to drive; read the outcome with [Retrieve allowlist verification](/reference/allowlist/#get-allowlist-verification).\n\n`conflict`: 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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The run is not `running` (it is `draft`, `planned`, `paused` or `failed`).",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run is not in a state that allows this"
                    }
                  },
                  "conflict_2": {
                    "summary": "The run has already finished.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run is finished"
                    }
                  },
                  "conflict_3": {
                    "summary": "The run changed state between the check and the update, for example because it finished or failed meanwhile.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run moved meanwhile"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Pausing a paused run changes nothing: the repeat answers 409 `the run is not in a state that allows this`."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/allowlist/#pause-allowlist"
        }
      }
    },
    "/launch/allowlist/resume/{launch_id}": {
      "post": {
        "operationId": "allowlist.resume-allowlist",
        "summary": "Resume an allowlist run",
        "description": "Drives a paused or failed run from its first unfinished step.\n\nA backend restart always leaves a run paused.",
        "tags": [
          "Allowlist"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "draft",
                        "planned",
                        "running",
                        "paused",
                        "finished",
                        "failed"
                      ],
                      "description": "Run state after the transition."
                    }
                  },
                  "required": [
                    "ok",
                    "state"
                  ]
                },
                "example": {
                  "ok": true,
                  "state": "running"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license in your token has no beta access. Checked before the launch ID.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "allowlist curve launches are open to beta licenses only"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with `create_params.allowlist`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch exists but is not an allowlist curve launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch is not an allowlist curve launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The run is `draft`, `planned` or already `running`; only a `paused` or `failed` run resumes. Resume only a `paused` or `failed` run; a planned run starts with [Launch a token](/reference/launch-execution/#launch).\n\n`conflict`: 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.\n\n`conflict`: The run has already finished. Nothing is left to drive; read the outcome with [Retrieve allowlist verification](/reference/allowlist/#get-allowlist-verification).\n\n`conflict`: 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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The run is `draft`, `planned` or already `running`; only a `paused` or `failed` run resumes.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run is not in a state that allows this"
                    }
                  },
                  "conflict_2": {
                    "summary": "The backend is still settling the step that was in flight (`driving` is `true` in the status).",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run is still settling its last step; resume once it is idle"
                    }
                  },
                  "conflict_3": {
                    "summary": "The run has already finished.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run is finished"
                    }
                  },
                  "conflict_4": {
                    "summary": "The run changed state between the check and the update, for example because it finished or failed meanwhile.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run moved meanwhile"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "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."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/allowlist/#resume-allowlist"
        }
      }
    },
    "/launch/allowlist/migrate/{launch_id}": {
      "post": {
        "operationId": "allowlist.migrate-allowlist",
        "summary": "Migrate an allowlist run",
        "description": "Drives a run whose trades have all settled through migration and verification.",
        "tags": [
          "Allowlist"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "draft",
                        "planned",
                        "running",
                        "paused",
                        "finished",
                        "failed"
                      ],
                      "description": "Run state after the transition."
                    }
                  },
                  "required": [
                    "ok",
                    "state"
                  ]
                },
                "example": {
                  "ok": true,
                  "state": "running"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license in your token has no beta access. Checked before the launch ID.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "allowlist curve launches are open to beta licenses only"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with `create_params.allowlist`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch exists but is not an allowlist curve launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch is not an allowlist curve launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The run is `draft` or `planned`: the launch has not started. Start the launch first with [Launch a token](/reference/launch-execution/#launch).\n\n`conflict`: 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.\n\n`conflict`: 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.\n\n`conflict`: The run has already finished. Nothing is left to drive; read the outcome with [Retrieve allowlist verification](/reference/allowlist/#get-allowlist-verification).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The run is `draft` or `planned`: the launch has not started.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run has not started"
                    }
                  },
                  "conflict_2": {
                    "summary": "A step before the migration (setup or trade) is not confirmed yet.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the curve's trades have not all settled"
                    }
                  },
                  "conflict_3": {
                    "summary": "The run is `paused` or `failed` and the backend is still settling its last step.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run is still settling its last step; migrate once it is idle"
                    }
                  },
                  "conflict_4": {
                    "summary": "The run has already finished.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run is finished"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "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`."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/allowlist/#migrate-allowlist"
        }
      }
    },
    "/launch/allowlist/lock-lp/{launch_id}": {
      "post": {
        "operationId": "allowlist.lock-allowlist-lp",
        "summary": "Lock allowlist liquidity",
        "description": "Locks the unlocked liquidity of the creator position on the migrated pool.\n\nNever 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.\n\nIrreversible: locked liquidity cannot be withdrawn.",
        "tags": [
          "Allowlist"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "lock": {
                      "type": "object",
                      "properties": {
                        "action_id": {
                          "type": "string",
                          "description": "Step identifier."
                        },
                        "signature": {
                          "type": "string",
                          "description": "Transaction signature."
                        },
                        "settled": {
                          "type": "boolean",
                          "description": "`true` when the call only settled a lock already in flight; no new transaction was sent."
                        },
                        "locked": {
                          "type": "string",
                          "description": "`\"nothing left unlocked\"` when every position is already locked; nothing is sent and no other field is set."
                        },
                        "positions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "position": {
                                "type": "string",
                                "description": "Position account."
                              },
                              "liquidity": {
                                "type": "string",
                                "description": "Liquidity locked in it."
                              }
                            },
                            "required": [
                              "position",
                              "liquidity"
                            ]
                          },
                          "description": "Positions locked."
                        }
                      },
                      "description": "The lock action."
                    }
                  },
                  "required": [
                    "ok",
                    "lock"
                  ]
                },
                "example": {
                  "ok": true,
                  "lock": {
                    "action_id": "cs:101000000004217:213:a0",
                    "signature": "5VfYmGc8sT3kQ2xR9nLwP4hJ7dB6aZ1uE8yNvK3tXqMr2HcW9pLs5FjD7gA4bT6nY1kR8mQzV3xC2wE5uJ9hP7a",
                    "positions": [
                      {
                        "position": "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX",
                        "liquidity": "84512039111"
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license in your token has no beta access. Checked before the launch ID.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "allowlist curve launches are open to beta licenses only"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with `create_params.allowlist`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch exists but is not an allowlist curve launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch is not an allowlist curve launch"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: 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`.\n\n`unprocessable`: A position with unlocked liquidity is held by a wallet other than the run's dev wallet. Lock that position yourself from the wallet that holds its NFT.\n\n`unprocessable`: A keeper migrated the pool before the run did, so the positions the migration opened are unknown. Lock the creator position outside Proxima, from the wallet that holds its NFT.\n\n`unprocessable`: 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.\n\n`unprocessable`: The lock transaction failed simulation; nothing was sent. Fix the cause given in `message`, for example the dev wallet's SOL for fees, then try again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The migration step is not confirmed yet.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the pool has not migrated yet"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "A position with unlocked liquidity is held by a wallet other than the run's dev wallet.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "position <position> is held by <holder>, not by the run's dev wallet"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "A keeper migrated the pool before the run did, so the positions the migration opened are unknown.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the migration's positions are unknown: a keeper migrated this pool"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "The backend is driving the run or settling another lock for this launch.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the run is busy; try again once it settles"
                    }
                  },
                  "unprocessable_5": {
                    "summary": "The lock transaction failed simulation; nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the lock was refused in simulation: <reason>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "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`."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/allowlist/#lock-allowlist-lp"
        }
      }
    },
    "/launch/allowlist/status/{launch_id}": {
      "get": {
        "operationId": "allowlist.get-allowlist-status",
        "summary": "Retrieve allowlist run status",
        "description": "Returns the run's state, progress, step in flight and curve.",
        "tags": [
          "Allowlist"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns an Allowlist status object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "state": {
                      "type": "string",
                      "enum": [
                        "draft",
                        "planned",
                        "running",
                        "paused",
                        "finished",
                        "failed"
                      ],
                      "description": "Run state."
                    },
                    "driving": {
                      "type": "boolean",
                      "description": "`true` while the backend is settling a step it has in flight."
                    },
                    "last_error": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Last error the run hit."
                    },
                    "progress": {
                      "type": "object",
                      "properties": {
                        "steps_done": {
                          "type": "integer",
                          "description": "Steps completed."
                        },
                        "steps_total": {
                          "type": "integer",
                          "description": "Steps in the run."
                        },
                        "trades_done": {
                          "type": "integer",
                          "description": "Trades completed."
                        },
                        "trades_total": {
                          "type": "integer",
                          "description": "Trades in the run."
                        },
                        "migrated": {
                          "type": "boolean",
                          "description": "Whether the pool has migrated."
                        }
                      },
                      "required": [
                        "steps_done",
                        "steps_total",
                        "trades_done",
                        "trades_total",
                        "migrated"
                      ],
                      "description": "Counters."
                    },
                    "current_step": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "ordinal": {
                              "type": "integer",
                              "description": "Position of the step in the run."
                            },
                            "action_id": {
                              "type": "string",
                              "description": "Step identifier."
                            },
                            "attempt": {
                              "type": "integer",
                              "description": "Retry count."
                            },
                            "kind": {
                              "type": "string",
                              "enum": [
                                "hook_init",
                                "add_wallets",
                                "seal",
                                "config",
                                "pool",
                                "trade",
                                "migrate",
                                "verify",
                                "lock_lp"
                              ],
                              "description": "Step kind."
                            },
                            "status": {
                              "type": "string",
                              "enum": [
                                "planned",
                                "signed",
                                "submitted",
                                "unknown",
                                "confirmed",
                                "failed"
                              ],
                              "description": "Step status."
                            },
                            "wallet_index": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Holder index for a trade step."
                            },
                            "side": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "enum": [
                                    "buy",
                                    "sell"
                                  ]
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Trade side."
                            },
                            "tokens": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Token amount, raw units."
                            },
                            "quote": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Quote amount, raw units."
                            },
                            "quote_limit": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Quote limit of the trade, raw units."
                            },
                            "final_fill": {
                              "type": "boolean",
                              "description": "Whether this trade is the final fill."
                            },
                            "signature": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Transaction signature."
                            },
                            "error": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Error of the step."
                            }
                          },
                          "required": [
                            "ordinal",
                            "action_id",
                            "attempt",
                            "kind",
                            "status",
                            "wallet_index",
                            "side",
                            "tokens",
                            "quote",
                            "signature",
                            "error"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The step in flight."
                    },
                    "eta_ms": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Estimated time left, in milliseconds. `null` unless running or planned."
                    },
                    "eta_at_ms": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Estimated finish time, epoch milliseconds."
                    },
                    "verification": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "The latest [verification report](#object-allowlist-verification-report)."
                    },
                    "curve": {
                      "type": "object",
                      "properties": {
                        "inputs": {
                          "type": "object",
                          "description": "The curve inputs the launch was created with (`budget`, `migration_fdv`, `opening_fdv`, `supply`, fee and interval settings). Numbers may come as strings."
                        },
                        "config": {
                          "type": "object",
                          "description": "The curve config, values as decimal strings."
                        },
                        "group": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Holder wallets in the allowlist."
                        },
                        "plan": {
                          "anyOf": [
                            {
                              "type": "object"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "The [plan summary](#object-allowlist-plan-summary)."
                        }
                      },
                      "required": [
                        "inputs",
                        "config",
                        "group",
                        "plan"
                      ],
                      "description": "The curve the run trades."
                    }
                  },
                  "required": [
                    "ok",
                    "state",
                    "driving",
                    "last_error",
                    "progress",
                    "current_step",
                    "eta_ms",
                    "eta_at_ms",
                    "verification",
                    "curve"
                  ]
                },
                "example": {
                  "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
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license in your token has no beta access. Checked before the launch ID.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "allowlist curve launches are open to beta licenses only"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with `create_params.allowlist`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch exists but is not an allowlist curve launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch is not an allowlist curve launch"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/allowlist/#get-allowlist-status"
        }
      }
    },
    "/launch/allowlist/verification/{launch_id}": {
      "get": {
        "operationId": "allowlist.get-allowlist-verification",
        "summary": "Retrieve allowlist verification",
        "description": "Runs the run's acceptance checks against the chain and returns the report.",
        "tags": [
          "Allowlist"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and an Allowlist verification report object under `report`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "report": {
                      "type": "object",
                      "properties": {
                        "ok": {
                          "type": "boolean",
                          "description": "`true` when every check passes."
                        },
                        "checks": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "description": "Check name."
                              },
                              "ok": {
                                "type": "boolean",
                                "description": "Whether the check passes."
                              },
                              "detail": {
                                "type": "string",
                                "description": "What was measured."
                              }
                            },
                            "required": [
                              "name",
                              "ok",
                              "detail"
                            ]
                          },
                          "description": "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`."
                        },
                        "exit_estimate": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "estimate": {
                                  "type": "boolean",
                                  "description": "Always `true`: a theoretical figure, never a promise."
                                },
                                "basis": {
                                  "type": "string",
                                  "enum": [
                                    "migration",
                                    "pool"
                                  ],
                                  "description": "`migration`: the pool the curve opens at its threshold; `pool`: the migrated pool now."
                                },
                                "fee_bps": {
                                  "type": "integer",
                                  "description": "Pool fee used, in basis points."
                                },
                                "tokens": {
                                  "type": "string",
                                  "description": "Tokens sold in the estimate, raw units."
                                },
                                "quote_out": {
                                  "type": "string",
                                  "description": "Quote the sale would bring, raw units."
                                },
                                "fee": {
                                  "type": "string",
                                  "description": "Fee paid on the sale, raw units."
                                }
                              },
                              "required": [
                                "estimate",
                                "basis",
                                "fee_bps",
                                "tokens",
                                "quote_out",
                                "fee"
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Informative exit estimate; never a check."
                        }
                      },
                      "required": [
                        "ok",
                        "checks"
                      ],
                      "description": "The verification report."
                    }
                  },
                  "required": [
                    "ok",
                    "report"
                  ]
                },
                "example": {
                  "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"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The license in your token has no beta access. Checked before the launch ID. Use a token upgraded onto a license with beta access.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The license in your token has no beta access. Checked before the launch ID.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "allowlist curve launches are open to beta licenses only"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: The launch exists but is not an allowlist curve launch. Call it only for a Meteora DBC launch created with `create_params.allowlist`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch exists but is not an allowlist curve launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this launch is not an allowlist curve launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The run is `draft` or `planned`, so there is nothing on chain to verify yet. Call it once the launch has started.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The run is `draft` or `planned`, so there is nothing on chain to verify yet.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the run has not started"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The checks could not be read from the chain, for example an RPC read failed or an account the run created no longer exists. Retry in a few seconds; the last stored report stays available as `verification` in [Retrieve allowlist run status](/reference/allowlist/#get-allowlist-status).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The checks could not be read from the chain, for example an RPC read failed or an account the run created no longer exists.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "<reason>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call reads the chain again and stores the report as the run's latest `verification`; nothing is sent."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/allowlist/#get-allowlist-verification"
        }
      }
    },
    "/launch/lp/info/{launch_id}": {
      "get": {
        "operationId": "liquidity.get-lp-info",
        "summary": "Retrieve LP info",
        "description": "Returns the dev wallet's liquidity in the launch's pool and what it would redeem.\n\nOn Uniswap V4 the response also carries `token_id`, the position NFT ID.\n\nOn Solana (Meteora DAMM launches) the response has another shape: `pool`, `position_nft_mint`, `unlocked_liquidity`, `permanent_locked_liquidity`, `token_reserve`, `native_reserve`, `fees_token` and `fees_native`, all strings except `ok`.",
        "tags": [
          "Liquidity Pool"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "202000000000318"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns an LP info object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "pair": {
                      "type": "string",
                      "description": "V2 pair address. On V3, the pool address, or the zero address when no pool is found. On V4, the Uniswap V4 PositionManager address."
                    },
                    "lp_balance": {
                      "type": "string",
                      "description": "LP held by the dev wallet."
                    },
                    "lp_total_supply": {
                      "type": "string",
                      "description": "Total LP supply of the pair."
                    },
                    "token_reserve": {
                      "type": "string",
                      "description": "Token reserve of the pool."
                    },
                    "native_reserve": {
                      "type": "string",
                      "description": "Native reserve of the pool."
                    },
                    "token_redeemable": {
                      "type": "string",
                      "description": "Tokens the dev's LP would redeem."
                    },
                    "native_redeemable": {
                      "type": "string",
                      "description": "Native the dev's LP would redeem."
                    }
                  },
                  "required": [
                    "ok",
                    "pair",
                    "lp_balance",
                    "lp_total_supply",
                    "token_reserve",
                    "native_reserve",
                    "token_redeemable",
                    "native_redeemable"
                  ]
                },
                "example": {
                  "ok": true,
                  "pair": "0x5e1f7a2b9c4d8e3f6a0b1c7d2e9f4a8b3c6d5e1f",
                  "lp_balance": "14142135623730950488",
                  "lp_total_supply": "14142135623730951488",
                  "token_reserve": "800000000000000000000000000",
                  "native_reserve": "2500000000000000000",
                  "token_redeemable": "799999999999943431000000000",
                  "native_redeemable": "2499999999999823223"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: the launch is still a draft (imported launches pass). Launch the token with [Launch a token](/reference/launch-execution/#launch) first.\n\n`bad_request`: EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself. Use these endpoints only on Uniswap V2, V3 and V4 launches; there is no liquidity to manage on other EVM platforms.\n\n`bad_request`: EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it. Use a launch whose dev wallet Proxima holds the key for.\n\n`bad_request`: Uniswap V2: the token has no pair against the wrapped native token yet. Retry once trading has opened on Uniswap V2.\n\n`bad_request`: Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim. Treat the liquidity as already burned, reclaimed or moved out of the dev wallet; there is nothing left to manage.\n\n`bad_request`: Uniswap V4: the position NFT is no longer in the dev wallet; after [Burn LP](/reference/liquidity/#burn-lp) it is held by `0x…dEaD`. Treat the liquidity as burned if `<owner>` is the dead address; otherwise move the position back to the dev wallet.\n\n`bad_request`: Uniswap V4: the position was closed, for example by [Reclaim LP](/reference/liquidity/#reclaim-lp). Treat the liquidity as reclaimed; there is nothing left to manage.\n\n`bad_request`: Uniswap V4: no position mint to the dev wallet was found after the token's creation block. Check that trading was opened from this launch's dev wallet; there is no position for Proxima to manage.\n\n`bad_request`: Solana: the launch is not a Meteora DAMM launch. On Solana, use these endpoints only for Meteora DAMM launches.\n\n`bad_request`: Solana: the launch is still a draft. Launch the token with [Launch a token](/reference/launch-execution/#launch) first.\n\n`bad_request`: Solana: the launch has no position Proxima opened, as with an imported pool. Manage the pool from the wallet that created it; Proxima only manages positions it opened.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the launch is still a draft (imported launches pass).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "LP reclaim/burn is only available for uniswap v2/v3/v4 launches; <platform> manages liquidity at the platform level"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev wallet is watched, cannot sign"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Uniswap V2: the token has no pair against the wrapped native token yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "uniswap v2 pair not yet created"
                    }
                  },
                  "bad_request_6": {
                    "summary": "Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev holds no uniswap v3 position for this token"
                    }
                  },
                  "bad_request_7": {
                    "summary": "Uniswap V4: the position NFT is no longer in the dev wallet; after [Burn LP](/reference/liquidity/#burn-lp) it is held by `0x…dEaD`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch's liquidity position is held by <owner>, not by the dev wallet"
                    }
                  },
                  "bad_request_8": {
                    "summary": "Uniswap V4: the position was closed, for example by [Reclaim LP](/reference/liquidity/#reclaim-lp).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch's liquidity position no longer exists"
                    }
                  },
                  "bad_request_9": {
                    "summary": "Uniswap V4: no position mint to the dev wallet was found after the token's creation block.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no uniswap v4 liquidity position was minted to this launch's dev wallet"
                    }
                  },
                  "bad_request_10": {
                    "summary": "Solana: the launch is not a Meteora DAMM launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "lp management is only available on meteoradamm launches"
                    }
                  },
                  "bad_request_11": {
                    "summary": "Solana: the launch is still a draft.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch is not deployed yet"
                    }
                  },
                  "bad_request_12": {
                    "summary": "Solana: the launch has no position Proxima opened, as with an imported pool.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch holds no position (imported pools are not ours)"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it. Treat the liquidity as reclaimed; there is nothing left to manage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "position account not found on-chain"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Uniswap V4: an RPC read failed. `message` names the read (`v4 position read`, `v4 position search`, `v4 pool read`, `v4 pool reserves`, `v4 position fees`); the body adds `service: \"evm_rpc\"`. Retry in a few seconds.\n\n`upstream_failure`: Solana: reading the position or the pool from the RPC failed. The body adds `service: \"rpc\"`. Retry in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Uniswap V4: an RPC read failed. `message` names the read (`v4 position read`, `v4 position search`, `v4 pool read`, `v4 pool reserves`, `v4 position fees`); the body adds `service: \"evm_rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_rpc api issue: v4 position read: <error>"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "Solana: reading the position or the pool from the RPC failed. The body adds `service: \"rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: Failed to fetch position account"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/liquidity/#get-lp-info"
        }
      }
    },
    "/launch/lp/burn/{launch_id}": {
      "post": {
        "operationId": "liquidity.burn-lp",
        "summary": "Burn LP",
        "description": "Permanently locks the dev wallet's liquidity by sending it to the dead address.\n\nOn V2 the LP tokens go to `0x…dEaD`; on V3 and V4 the position NFT is locked. Takes no body.\n\nIrreversible: burned liquidity can never be reclaimed.\n\nOn V3 and V4 the backend answers `token_id` and `lp_liquidity_locked` instead of `lp_burned`.\n\nOn Solana (Meteora DAMM launches) the position is permanently locked in place and the response is `ok`, `signature` and `liquidity_locked`.",
        "tags": [
          "Liquidity Pool"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "202000000000318"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "tx_hash": {
                      "type": "string",
                      "description": "Transaction hash."
                    },
                    "lp_burned": {
                      "type": "string",
                      "description": "LP amount burned."
                    }
                  },
                  "required": [
                    "ok",
                    "tx_hash",
                    "lp_burned"
                  ]
                },
                "example": {
                  "ok": true,
                  "tx_hash": "0x4c9e2f7a1b8d3c6e5f0a9b2c7d4e1f8a3b6c5d0e9f2a7b4c1d8e3f6a5b0c9d2e",
                  "lp_burned": "14142135623730950488"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: the launch is still a draft (imported launches pass). Launch the token with [Launch a token](/reference/launch-execution/#launch) first.\n\n`bad_request`: EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself. Use these endpoints only on Uniswap V2, V3 and V4 launches; there is no liquidity to manage on other EVM platforms.\n\n`bad_request`: EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it. Use a launch whose dev wallet Proxima holds the key for.\n\n`bad_request`: Uniswap V2: the token has no pair against the wrapped native token yet. Retry once trading has opened on Uniswap V2.\n\n`bad_request`: Uniswap V2: the dev wallet holds no LP tokens, for example after a burn or a reclaim. Read [Retrieve LP info](/reference/liquidity/#get-lp-info): the LP was already burned, reclaimed or moved, so there is nothing to burn.\n\n`bad_request`: Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim. Treat the liquidity as already burned, reclaimed or moved out of the dev wallet; there is nothing left to manage.\n\n`bad_request`: Uniswap V4: the position NFT is no longer in the dev wallet; after [Burn LP](/reference/liquidity/#burn-lp) it is held by `0x…dEaD`. Treat the liquidity as burned if `<owner>` is the dead address; otherwise move the position back to the dev wallet.\n\n`bad_request`: Uniswap V4: the position was closed, for example by [Reclaim LP](/reference/liquidity/#reclaim-lp). Treat the liquidity as reclaimed; there is nothing left to manage.\n\n`bad_request`: Uniswap V4: no position mint to the dev wallet was found after the token's creation block. Check that trading was opened from this launch's dev wallet; there is no position for Proxima to manage.\n\n`bad_request`: Solana: the launch is not a Meteora DAMM launch. On Solana, use these endpoints only for Meteora DAMM launches.\n\n`bad_request`: Solana: the launch is still a draft. Launch the token with [Launch a token](/reference/launch-execution/#launch) first.\n\n`bad_request`: Solana: the launch has no position Proxima opened, as with an imported pool. Manage the pool from the wallet that created it; Proxima only manages positions it opened.\n\n`bad_request`: Solana: the position's liquidity is already all locked or withdrawn. Stop here: nothing is left to lock.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the launch is still a draft (imported launches pass).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "LP reclaim/burn is only available for uniswap v2/v3/v4 launches; <platform> manages liquidity at the platform level"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev wallet is watched, cannot sign"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Uniswap V2: the token has no pair against the wrapped native token yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "uniswap v2 pair not yet created"
                    }
                  },
                  "bad_request_6": {
                    "summary": "Uniswap V2: the dev wallet holds no LP tokens, for example after a burn or a reclaim.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev holds no LP tokens"
                    }
                  },
                  "bad_request_7": {
                    "summary": "Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev holds no uniswap v3 position for this token"
                    }
                  },
                  "bad_request_8": {
                    "summary": "Uniswap V4: the position NFT is no longer in the dev wallet; after [Burn LP](/reference/liquidity/#burn-lp) it is held by `0x…dEaD`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch's liquidity position is held by <owner>, not by the dev wallet"
                    }
                  },
                  "bad_request_9": {
                    "summary": "Uniswap V4: the position was closed, for example by [Reclaim LP](/reference/liquidity/#reclaim-lp).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch's liquidity position no longer exists"
                    }
                  },
                  "bad_request_10": {
                    "summary": "Uniswap V4: no position mint to the dev wallet was found after the token's creation block.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no uniswap v4 liquidity position was minted to this launch's dev wallet"
                    }
                  },
                  "bad_request_11": {
                    "summary": "Solana: the launch is not a Meteora DAMM launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "lp management is only available on meteoradamm launches"
                    }
                  },
                  "bad_request_12": {
                    "summary": "Solana: the launch is still a draft.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch is not deployed yet"
                    }
                  },
                  "bad_request_13": {
                    "summary": "Solana: the launch has no position Proxima opened, as with an imported pool.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch holds no position (imported pools are not ours)"
                    }
                  },
                  "bad_request_14": {
                    "summary": "Solana: the position's liquidity is already all locked or withdrawn.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "position has no unlocked liquidity to lock"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it. Treat the liquidity as reclaimed; there is nothing left to manage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "position account not found on-chain"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Uniswap V4: an RPC read failed. `message` names the read (`v4 position read`, `v4 position search`, `v4 pool read`, `v4 pool reserves`, `v4 position fees`); the body adds `service: \"evm_rpc\"`. Retry in a few seconds.\n\n`upstream_failure`: EVM: the transaction could not be sent or failed on-chain. The body adds `service: \"evm_tx_engine\"`. Read [Retrieve LP info](/reference/liquidity/#get-lp-info) before calling again: the transaction may have landed.\n\n`upstream_failure`: Solana: reading the position or the pool from the RPC failed. The body adds `service: \"rpc\"`. Retry in a few seconds.\n\n`upstream_failure`: Solana: the transaction could not be sent. The body adds `service: \"tx_engine\"`. Read [Retrieve LP info](/reference/liquidity/#get-lp-info) before calling again.\n\n`upstream_failure`: Solana: the transaction did not land. Read [Retrieve LP info](/reference/liquidity/#get-lp-info) to confirm nothing moved, then call again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Uniswap V4: an RPC read failed. `message` names the read (`v4 position read`, `v4 position search`, `v4 pool read`, `v4 pool reserves`, `v4 position fees`); the body adds `service: \"evm_rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_rpc api issue: v4 position read: <error>"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "EVM: the transaction could not be sent or failed on-chain. The body adds `service: \"evm_tx_engine\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_tx_engine api issue: <error>"
                    }
                  },
                  "upstream_failure_3": {
                    "summary": "Solana: reading the position or the pool from the RPC failed. The body adds `service: \"rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: Failed to fetch position account"
                    }
                  },
                  "upstream_failure_4": {
                    "summary": "Solana: the transaction could not be sent. The body adds `service: \"tx_engine\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: lp transaction failed: <error>"
                    }
                  },
                  "upstream_failure_5": {
                    "summary": "Solana: the transaction did not land.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: lp transaction did not land"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve LP info](/reference/liquidity/#get-lp-info) first: if the dev no longer holds the liquidity (`lp_balance` of `0`, or a `400` saying so), the first call landed. A repeat after it landed is refused with `400`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/liquidity/#burn-lp"
        }
      }
    },
    "/launch/lp/reclaim/{launch_id}": {
      "post": {
        "operationId": "liquidity.reclaim-lp",
        "summary": "Reclaim LP",
        "description": "Removes the dev wallet's liquidity and returns the token and native to the dev wallet.\n\nExpected amounts come from a snapshot read before the transaction and can drift slightly by the time it lands. Takes no body.\n\nRemoves the launch's pool liquidity; the token stays tradable only on whatever liquidity remains.\n\nOn V3 and V4 the backend answers `token_id` and `lp_reclaimed_liquidity` instead of `lp_reclaimed`.\n\nOn Solana (Meteora DAMM launches) the reclaim withdraws the unlocked liquidity, claims the fees and closes the position when nothing stays locked. The response is `ok`, `signatures`, `position_closed`, `liquidity_removed`, `fees_token` and `fees_native`.",
        "tags": [
          "Liquidity Pool"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "202000000000318"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "tx_hash": {
                      "type": "string",
                      "description": "Transaction hash."
                    },
                    "lp_reclaimed": {
                      "type": "string",
                      "description": "LP amount removed."
                    },
                    "expected_token_out": {
                      "type": "string",
                      "description": "Tokens expected back, raw units."
                    },
                    "expected_native_out": {
                      "type": "string",
                      "description": "Native expected back, wei."
                    }
                  },
                  "required": [
                    "ok",
                    "tx_hash",
                    "lp_reclaimed",
                    "expected_token_out",
                    "expected_native_out"
                  ]
                },
                "example": {
                  "ok": true,
                  "tx_hash": "0x4c9e2f7a1b8d3c6e5f0a9b2c7d4e1f8a3b6c5d0e9f2a7b4c1d8e3f6a5b0c9d2e",
                  "lp_reclaimed": "14142135623730950488",
                  "expected_token_out": "799999999999943431000000000",
                  "expected_native_out": "2499999999999823223"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: the launch is still a draft (imported launches pass). Launch the token with [Launch a token](/reference/launch-execution/#launch) first.\n\n`bad_request`: EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself. Use these endpoints only on Uniswap V2, V3 and V4 launches; there is no liquidity to manage on other EVM platforms.\n\n`bad_request`: EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it. Use a launch whose dev wallet Proxima holds the key for.\n\n`bad_request`: Uniswap V2: the token has no pair against the wrapped native token yet. Retry once trading has opened on Uniswap V2.\n\n`bad_request`: Uniswap V2: the dev wallet holds no LP tokens, for example after a burn or a reclaim. Read [Retrieve LP info](/reference/liquidity/#get-lp-info): the LP was already burned, reclaimed or moved, so there is nothing to reclaim.\n\n`bad_request`: Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim. Treat the liquidity as already burned, reclaimed or moved out of the dev wallet; there is nothing left to manage.\n\n`bad_request`: Uniswap V3 and V4: the position holds no liquidity. Stop here: nothing is left to reclaim.\n\n`bad_request`: Uniswap V4: the position NFT is no longer in the dev wallet; after [Burn LP](/reference/liquidity/#burn-lp) it is held by `0x…dEaD`. Treat the liquidity as burned if `<owner>` is the dead address; otherwise move the position back to the dev wallet.\n\n`bad_request`: Uniswap V4: the position was closed, for example by [Reclaim LP](/reference/liquidity/#reclaim-lp). Treat the liquidity as reclaimed; there is nothing left to manage.\n\n`bad_request`: Uniswap V4: no position mint to the dev wallet was found after the token's creation block. Check that trading was opened from this launch's dev wallet; there is no position for Proxima to manage.\n\n`bad_request`: Solana: the launch is not a Meteora DAMM launch. On Solana, use these endpoints only for Meteora DAMM launches.\n\n`bad_request`: Solana: the launch is still a draft. Launch the token with [Launch a token](/reference/launch-execution/#launch) first.\n\n`bad_request`: Solana: the launch has no position Proxima opened, as with an imported pool. Manage the pool from the wallet that created it; Proxima only manages positions it opened.\n\n`bad_request`: Solana: the position has no unlocked liquidity and no fees to claim. Stop here: the liquidity and fees were already reclaimed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: the launch is still a draft (imported launches pass).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_3": {
                    "summary": "EVM: the launch is not on Uniswap V2, V3 or V4; its platform adds and locks the liquidity itself.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "LP reclaim/burn is only available for uniswap v2/v3/v4 launches; <platform> manages liquidity at the platform level"
                    }
                  },
                  "bad_request_4": {
                    "summary": "EVM: the launch's dev wallet is a watch-only wallet, so Proxima cannot sign for it.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev wallet is watched, cannot sign"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Uniswap V2: the token has no pair against the wrapped native token yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "uniswap v2 pair not yet created"
                    }
                  },
                  "bad_request_6": {
                    "summary": "Uniswap V2: the dev wallet holds no LP tokens, for example after a burn or a reclaim.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev holds no LP tokens"
                    }
                  },
                  "bad_request_7": {
                    "summary": "Uniswap V3: the dev wallet holds no position for this token, for example after a burn or a reclaim.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "dev holds no uniswap v3 position for this token"
                    }
                  },
                  "bad_request_8": {
                    "summary": "Uniswap V3 and V4: the position holds no liquidity.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "position has no liquidity to reclaim"
                    }
                  },
                  "bad_request_9": {
                    "summary": "Uniswap V4: the position NFT is no longer in the dev wallet; after [Burn LP](/reference/liquidity/#burn-lp) it is held by `0x…dEaD`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch's liquidity position is held by <owner>, not by the dev wallet"
                    }
                  },
                  "bad_request_10": {
                    "summary": "Uniswap V4: the position was closed, for example by [Reclaim LP](/reference/liquidity/#reclaim-lp).",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch's liquidity position no longer exists"
                    }
                  },
                  "bad_request_11": {
                    "summary": "Uniswap V4: no position mint to the dev wallet was found after the token's creation block.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "no uniswap v4 liquidity position was minted to this launch's dev wallet"
                    }
                  },
                  "bad_request_12": {
                    "summary": "Solana: the launch is not a Meteora DAMM launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "lp management is only available on meteoradamm launches"
                    }
                  },
                  "bad_request_13": {
                    "summary": "Solana: the launch is still a draft.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch is not deployed yet"
                    }
                  },
                  "bad_request_14": {
                    "summary": "Solana: the launch has no position Proxima opened, as with an imported pool.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "this launch holds no position (imported pools are not ours)"
                    }
                  },
                  "bad_request_15": {
                    "summary": "Solana: the position has no unlocked liquidity and no fees to claim.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "position has nothing left to reclaim"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it. Treat the liquidity as reclaimed; there is nothing left to manage.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the position account no longer exists on-chain; a reclaim that withdrew everything closes it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "position account not found on-chain"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Uniswap V4: an RPC read failed. `message` names the read (`v4 position read`, `v4 position search`, `v4 pool read`, `v4 pool reserves`, `v4 position fees`); the body adds `service: \"evm_rpc\"`. Retry in a few seconds.\n\n`upstream_failure`: EVM: the transaction could not be sent or failed on-chain. The body adds `service: \"evm_tx_engine\"`. Read [Retrieve LP info](/reference/liquidity/#get-lp-info) before calling again: the transaction may have landed.\n\n`upstream_failure`: Solana: reading the position or the pool from the RPC failed. The body adds `service: \"rpc\"`. Retry in a few seconds.\n\n`upstream_failure`: Solana: a transaction could not be sent. The reclaim sends up to three transactions in a row (withdraw, claim fees, close), so the ones before it may have landed. The body adds `service: \"tx_engine\"`. Read [Retrieve LP info](/reference/liquidity/#get-lp-info) before calling again.\n\n`upstream_failure`: Solana: a transaction did not land; the ones sent before it may have. Read [Retrieve LP info](/reference/liquidity/#get-lp-info) to see what is left, then call again to reclaim the rest.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Uniswap V4: an RPC read failed. `message` names the read (`v4 position read`, `v4 position search`, `v4 pool read`, `v4 pool reserves`, `v4 position fees`); the body adds `service: \"evm_rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_rpc api issue: v4 position read: <error>"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "EVM: the transaction could not be sent or failed on-chain. The body adds `service: \"evm_tx_engine\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "evm_tx_engine api issue: <error>"
                    }
                  },
                  "upstream_failure_3": {
                    "summary": "Solana: reading the position or the pool from the RPC failed. The body adds `service: \"rpc\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "rpc api issue: Failed to fetch position account"
                    }
                  },
                  "upstream_failure_4": {
                    "summary": "Solana: a transaction could not be sent. The reclaim sends up to three transactions in a row (withdraw, claim fees, close), so the ones before it may have landed. The body adds `service: \"tx_engine\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: lp transaction failed: <error>"
                    }
                  },
                  "upstream_failure_5": {
                    "summary": "Solana: a transaction did not land; the ones sent before it may have.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tx_engine api issue: lp transaction did not land"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve LP info](/reference/liquidity/#get-lp-info) first: if the dev no longer holds the liquidity, the first call landed and a repeat is refused with `400`. On Solana a failed call may have withdrawn part of it; calling again reclaims what is left."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/liquidity/#reclaim-lp"
        }
      }
    },
    "/launch/printr/staking/create-position/{launch_id}": {
      "post": {
        "operationId": "printr-staking.create-staking-position",
        "summary": "Create staking positions",
        "description": "Stakes the same token amount from each selected launch wallet for the chosen lock period.\n\nLocks tokens on-chain until the lock period ends.",
        "tags": [
          "Printr Staking"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lock_period": {
                    "type": "string",
                    "enum": [
                      "STAKING_LOCK_PERIOD_SEVEN_DAYS",
                      "STAKING_LOCK_PERIOD_FOURTEEN_DAYS",
                      "STAKING_LOCK_PERIOD_THIRTY_DAYS",
                      "STAKING_LOCK_PERIOD_SIXTY_DAYS",
                      "STAKING_LOCK_PERIOD_NINETY_DAYS",
                      "STAKING_LOCK_PERIOD_ONE_HUNDRED_EIGHTY_DAYS"
                    ],
                    "description": "How long the tokens stay locked."
                  },
                  "amount": {
                    "type": "integer",
                    "description": "Tokens to stake per wallet, atomic units. Must be greater than 0."
                  },
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Launch wallets to stake from. Omit for all launch wallets."
                  }
                },
                "required": [
                  "lock_period",
                  "amount"
                ]
              },
              "example": {
                "lock_period": "STAKING_LOCK_PERIOD_THIRTY_DAYS",
                "amount": 25000000000,
                "wallets": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "description": "`true` when at least one position was created."
                    },
                    "created": {
                      "type": "integer",
                      "description": "Number of wallets whose position was created."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Number of wallets attempted."
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pubkey": {
                            "type": "string",
                            "description": "Wallet."
                          },
                          "success": {
                            "type": "boolean",
                            "description": "Whether this wallet staked."
                          },
                          "signature": {
                            "type": "string",
                            "description": "Transaction signature."
                          },
                          "error": {
                            "type": "string",
                            "description": "Why this wallet failed."
                          }
                        },
                        "required": [
                          "pubkey",
                          "success"
                        ]
                      },
                      "description": "One entry per wallet."
                    }
                  },
                  "required": [
                    "success",
                    "created",
                    "total",
                    "results"
                  ]
                },
                "example": {
                  "success": true,
                  "created": 2,
                  "total": 2,
                  "results": [
                    {
                      "pubkey": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                      "success": true,
                      "signature": "5VfYmGc8sT3kQ2xR9nLwP4hJ7dB6aZ1uE8yNvK3tXqMr2HcW9pLs5FjD7gA4bT6nY1kR8mQzV3xC2wE5uJ9hP7a"
                    },
                    {
                      "pubkey": "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                      "success": true,
                      "signature": "3kTq9WmZ2vXc7RbN5pLh8YdG4sJ6fA1uE3rK7tVnQwMx9HcP2yLs5FjD8gB4aT6nZ1kR7mQzV3xC2wE5uJ4hR8b"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `amount` is 0. Send an `amount` greater than 0, in atomic units.\n\n`bad_request`: More than 50 wallets are selected, including when `wallets` is omitted and the launch has more than 50 wallets. Pass `wallets` with at most 50 addresses per request.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).\n\nThe body is missing, is not valid JSON, lacks `lock_period` or `amount`, has an unknown `lock_period`, or is sent without `Content-Type: application/json`. The HTTP framework answers before the handler runs (before `launch_id` is checked) with a plain-text body, not the JSON error object. Send a JSON body with `Content-Type: application/json` that matches the documented fields.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`amount` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Amount must be > 0"
                    }
                  },
                  "bad_request_3": {
                    "summary": "More than 50 wallets are selected, including when `wallets` is omitted and the launch has more than 50 wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Maximum 50 wallets per request"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: None of `wallets` belongs to the launch. Addresses outside the launch are dropped silently as long as one matches. Pass addresses of the launch's own wallets, or omit `wallets` to use all of them.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "None of `wallets` belongs to the launch. Addresses outside the launch are dropped silently as long as one matches.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No matching wallets found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The launch is still a draft: the token does not exist on chain yet. Launch the token first with [Launch a token](/reference/launch-execution/#launch).\n\n`internal_error`: Printr's token API failed or does not know the launch's mint, for example because the launch is not a Printr launch. Check that the launch is a Printr launch, then retry in a few seconds.\n\n`internal_error`: Printr's staking API refused or failed for every selected wallet, so nothing was sent. The per-wallet reasons are not returned. Retry later; nothing was sent, so a retry cannot stake twice.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The launch is still a draft: the token does not exist on chain yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Printr's token API failed or does not know the launch's mint, for example because the launch is not a Printr launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Printr api error"
                    }
                  },
                  "internal_error_3": {
                    "summary": "Printr's staking API refused or failed for every selected wallet, so nothing was sent. The per-wallet reasons are not returned.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Failed to build any staking transactions"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call opens new positions from every selected wallet. Before retrying, call [List staking positions](/reference/printr-staking/#list-staking-positions) for the same wallets and retry only the wallets that have no new position."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/printr-staking/#create-staking-position"
        }
      }
    },
    "/launch/printr/staking/list-positions/{launch_id}": {
      "post": {
        "operationId": "printr-staking.list-staking-positions",
        "summary": "List staking positions",
        "description": "Returns the staking positions held by the launch's wallets.\n\nA `POST` so the wallet filter can travel in the body; the client sends `{}` when there is no filter.",
        "tags": [
          "Printr Staking"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "wallets": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Launch wallets to list. Omit for all launch wallets."
                  },
                  "with_rewards": {
                    "type": "boolean",
                    "description": "Include claimable and claimed rewards."
                  }
                }
              },
              "example": {
                "with_rewards": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns a list of Staking position objects under `positions`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "positions": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Staking positions."
                    }
                  },
                  "required": [
                    "positions"
                  ]
                },
                "example": {
                  "positions": [
                    {
                      "info": {
                        "owner": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                        "position": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:8kPz3VnQ7wR2tYx5mLc9HbJ4dE6sFgA1uK3rT7vNqXwe",
                        "lock_period": "STAKING_LOCK_PERIOD_THIRTY_DAYS",
                        "staked": {
                          "decimals": 6,
                          "atomic": "25000000000",
                          "display": "25000"
                        },
                        "created_at": "2026-10-12T09:14:03Z",
                        "unlocks_at": "2026-11-11T09:14:03Z",
                        "was_closed": false
                      },
                      "claimable_quote_rewards": {
                        "decimals": 9,
                        "atomic": "18250000",
                        "display": "0.01825"
                      },
                      "claimable_telecoin_rewards": {
                        "decimals": 6,
                        "atomic": "412000000",
                        "display": "412"
                      },
                      "claimed_quote_rewards": null,
                      "claimed_telecoin_rewards": null
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).\n\nThe body is missing, is not valid JSON, or is sent without `Content-Type: application/json`. The HTTP framework answers before the handler runs (before `launch_id` is checked) with a plain-text body, not the JSON error object. Send a JSON body with `Content-Type: application/json` that matches the documented fields.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: An entry of `wallets` is not one of the launch's wallets; a malformed address also lands here. Pass only addresses of the launch's own wallets, or omit `wallets` to list them all.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "An entry of `wallets` is not one of the launch's wallets; a malformed address also lands here.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet <address> not found in launch"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Printr's token API failed or does not know the launch's mint, for example because the launch is not a Printr launch. Check that the launch is a Printr launch, then retry in a few seconds.\n\n`internal_error`: Printr's staking API failed or returned an answer the backend could not read. Retry in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Printr's token API failed or does not know the launch's mint, for example because the launch is not a Printr launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Printr api error"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Printr's staking API failed or returned an answer the backend could not read.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Printr staking api error"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A read: `POST` only carries the filter."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/printr-staking/#list-staking-positions"
        }
      }
    },
    "/launch/printr/staking/claim-rewards/{launch_id}": {
      "post": {
        "operationId": "printr-staking.claim-staking-rewards",
        "summary": "Claim staking rewards",
        "description": "Claims the rewards of the given positions, one transaction per wallet and position.",
        "tags": [
          "Printr Staking"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "claims": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "pubkey": {
                          "type": "string",
                          "description": "Launch wallet that owns the position and pays the fee."
                        },
                        "position": {
                          "type": "string",
                          "description": "Position account, as a CAIP-10 identifier."
                        }
                      },
                      "required": [
                        "pubkey",
                        "position"
                      ]
                    },
                    "description": "Positions to claim, at most 50."
                  }
                },
                "required": [
                  "claims"
                ]
              },
              "example": {
                "claims": [
                  {
                    "pubkey": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                    "position": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:8kPz3VnQ7wR2tYx5mLc9HbJ4dE6sFgA1uK3rT7vNqXwe"
                  },
                  {
                    "pubkey": "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                    "position": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:4tHw9CnR2xV6mQb8LpZ3yKd7GsE5fJ1aU9rT2vNkXqMc"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "success": {
                      "type": "boolean",
                      "description": "`true` when at least one claim landed."
                    },
                    "claimed": {
                      "type": "integer",
                      "description": "Number of claims that landed."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Number of claims attempted."
                    },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "pubkey": {
                            "type": "string",
                            "description": "Wallet."
                          },
                          "position": {
                            "type": "string",
                            "description": "Position claimed."
                          },
                          "success": {
                            "type": "boolean",
                            "description": "Whether the claim landed."
                          },
                          "signature": {
                            "type": "string",
                            "description": "Transaction signature."
                          },
                          "error": {
                            "type": "string",
                            "description": "Why the claim failed."
                          }
                        },
                        "required": [
                          "pubkey",
                          "position",
                          "success"
                        ]
                      },
                      "description": "One entry per claim."
                    }
                  },
                  "required": [
                    "success",
                    "claimed",
                    "total",
                    "results"
                  ]
                },
                "example": {
                  "success": true,
                  "claimed": 2,
                  "total": 2,
                  "results": [
                    {
                      "pubkey": "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                      "position": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:8kPz3VnQ7wR2tYx5mLc9HbJ4dE6sFgA1uK3rT7vNqXwe",
                      "success": true,
                      "signature": "5VfYmGc8sT3kQ2xR9nLwP4hJ7dB6aZ1uE8yNvK3tXqMr2HcW9pLs5FjD7gA4bT6nY1kR8mQzV3xC2wE5uJ9hP7a"
                    },
                    {
                      "pubkey": "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                      "position": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:4tHw9CnR2xV6mQb8LpZ3yKd7GsE5fJ1aU9rT2vNkXqMc",
                      "success": true,
                      "signature": "3kTq9WmZ2vXc7RbN5pLh8YdG4sJ6fA1uE3rK7tVnQwMx9HcP2yLs5FjD8gB4aT6nZ1kR7mQzV3xC2wE5uJ4hR8b"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `claims` is empty. Send at least one claim.\n\n`bad_request`: `claims` has more than 50 entries. Split the claims into batches of at most 50.\n\n`unsupported_chain`: The launch is not on Solana. The body adds `chain`. Call it only for Solana launches (IDs starting with `101`).\n\nThe body is missing, is not valid JSON, or `claims` is missing or malformed, or is sent without `Content-Type: application/json`. The HTTP framework answers before the handler runs (before `launch_id` is checked) with a plain-text body, not the JSON error object. Send a JSON body with `Content-Type: application/json` that matches the documented fields.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`claims` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No claims provided"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`claims` has more than 50 entries.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Maximum 50 claims per request"
                    }
                  },
                  "unsupported_chain": {
                    "summary": "The launch is not on Solana. The body adds `chain`.",
                    "value": {
                      "ok": false,
                      "code": "unsupported_chain",
                      "message": "this endpoint is not supported for this chain"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The launch is still a draft: the token does not exist on chain yet. Launch the token first with [Launch a token](/reference/launch-execution/#launch).\n\n`internal_error`: Printr's staking API failed while the backend looked up the positions' creation transactions. Retry in a few seconds.\n\n`internal_error`: No claim could be built: every `pubkey` is outside the launch, every `position` is unknown for its wallet, or Printr refused each one. Nothing was sent and the per-claim reasons are not returned. Take the `pubkey` and `position` pairs from [List staking positions](/reference/printr-staking/#list-staking-positions) and retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The launch is still a draft: the token does not exist on chain yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Printr's staking API failed while the backend looked up the positions' creation transactions.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Printr staking api error"
                    }
                  },
                  "internal_error_3": {
                    "summary": "No claim could be built: every `pubkey` is outside the launch, every `position` is unknown for its wallet, or Printr refused each one. Nothing was sent and the per-claim reasons are not returned.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Failed to build any claim transactions"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Before retrying, call [List staking positions](/reference/printr-staking/#list-staking-positions) with `with_rewards: true`: claimable rewards back at zero mean the first claim landed. A repeat sends a new claim transaction per position and pays its fee again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/printr-staking/#claim-staking-rewards"
        }
      }
    },
    "/launch/shares/catalog": {
      "get": {
        "operationId": "launch-sharing.retrieve-catalog",
        "summary": "Retrieve the permission catalog",
        "description": "Returns every permission identifier a grant can carry, with the routes each one opens.\n\nThe web app builds its access presets and the custom-permissions picker from this list instead of a list of its own. Identifiers are append-only, so the app caches the catalog for the whole session.",
        "tags": [
          "Launch Sharing"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "catalog_version": {
                      "type": "integer",
                      "description": "Current catalog version."
                    },
                    "operations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Permission identifier, e.g. `trade.buy`."
                          },
                          "high_risk": {
                            "type": "boolean",
                            "description": "Whether the operation moves assets out, exports a key or widens access."
                          },
                          "touches_wallets": {
                            "type": "boolean",
                            "description": "Whether the operation signs with or changes the launch's wallets."
                          },
                          "in_all": {
                            "type": "boolean",
                            "description": "Whether `operations: \"all\"` expands to it. `access.manage`, `wallet.shared_spend` and `launch.reveal_key` never do."
                          }
                        },
                        "required": [
                          "id",
                          "high_risk",
                          "touches_wallets",
                          "in_all"
                        ]
                      },
                      "description": "Every permission identifier."
                    },
                    "routes": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "method": {
                            "type": "string",
                            "description": "HTTP method."
                          },
                          "pattern": {
                            "type": "string",
                            "description": "Route pattern."
                          },
                          "operation": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Permission that opens the route."
                          },
                          "risk": {
                            "type": "string",
                            "enum": [
                              "read",
                              "mutation",
                              "high_risk"
                            ],
                            "description": "Risk class of the route."
                          }
                        },
                        "required": [
                          "method",
                          "pattern",
                          "operation",
                          "risk"
                        ]
                      },
                      "description": "Routes a grant can open."
                    }
                  },
                  "required": [
                    "ok",
                    "catalog_version",
                    "operations",
                    "routes"
                  ]
                },
                "example": {
                  "ok": true,
                  "catalog_version": 2,
                  "operations": [
                    {
                      "id": "launch.read",
                      "high_risk": false,
                      "touches_wallets": false,
                      "in_all": true
                    },
                    {
                      "id": "trade.buy",
                      "high_risk": false,
                      "touches_wallets": true,
                      "in_all": true
                    },
                    {
                      "id": "launch.reveal_key",
                      "high_risk": true,
                      "touches_wallets": false,
                      "in_all": false
                    },
                    {
                      "id": "access.manage",
                      "high_risk": true,
                      "touches_wallets": false,
                      "in_all": false
                    }
                  ],
                  "routes": [
                    {
                      "method": "GET",
                      "pattern": "/history/launch/{ext_id}",
                      "operation": "history.read",
                      "risk": "read"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#retrieve-catalog"
        }
      }
    },
    "/launch/shares/{launch_id}/resources": {
      "get": {
        "operationId": "launch-sharing.list-resources",
        "summary": "List shareable wallets",
        "description": "Lists the launch's wallets so a grantor can pick which ones a grant may use or export.\n\nUsed by the invite form to fill the wallet pickers. The response never contains a secret.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id` (15 digits, chain-encoded).",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "enum": [
                              "svm_wallet",
                              "evm_wallet"
                            ],
                            "description": "Wallet family."
                          },
                          "wallet_id": {
                            "type": "integer",
                            "description": "Row ID to use in a [wallet reference](#object-wallet-reference)."
                          },
                          "pubkey": {
                            "type": "string",
                            "description": "Public address."
                          },
                          "role": {
                            "type": "string",
                            "enum": [
                              "dev",
                              "funder",
                              "launch"
                            ],
                            "description": "Role of the wallet in the launch."
                          },
                          "shared": {
                            "type": "boolean",
                            "description": "Whether the wallet also serves outside this launch. Spending it needs `wallet.shared_spend`."
                          },
                          "exportable": {
                            "type": "boolean",
                            "description": "Whether its secret can be exported on the owner's tier."
                          },
                          "in_my_grant": {
                            "type": "boolean",
                            "description": "For a delegate: whether the caller's own grant covers the wallet."
                          },
                          "i_may_share_export": {
                            "type": "boolean",
                            "description": "Whether the caller may pass on export of this wallet's key."
                          }
                        },
                        "required": [
                          "kind",
                          "wallet_id",
                          "pubkey",
                          "role",
                          "shared",
                          "exportable",
                          "in_my_grant",
                          "i_may_share_export"
                        ]
                      },
                      "description": "Wallets the launch holds."
                    },
                    "sub_keys_exportable": {
                      "type": "boolean",
                      "description": "Whether launch sub-keys can be exported on the owner's tier."
                    }
                  },
                  "required": [
                    "ok",
                    "wallets",
                    "sub_keys_exportable"
                  ]
                },
                "example": {
                  "ok": true,
                  "wallets": [
                    {
                      "kind": "svm_wallet",
                      "wallet_id": 48213,
                      "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E",
                      "role": "dev",
                      "shared": false,
                      "exportable": true,
                      "in_my_grant": false,
                      "i_may_share_export": true
                    },
                    {
                      "kind": "svm_wallet",
                      "wallet_id": 48190,
                      "pubkey": "P3LTQ8mab78Ao4EKHt7QTEncNchS5HWLNf78hLVp8Hj",
                      "role": "funder",
                      "shared": true,
                      "exportable": false,
                      "in_my_grant": false,
                      "i_may_share_export": false
                    }
                  ],
                  "sub_keys_exportable": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is a multi-launch container, which cannot be shared. Share each member launch instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is a multi-launch container, which cannot be shared.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a multi-launch container cannot be shared; share its member launches"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#list-resources"
        }
      }
    },
    "/launch/shares/{launch_id}": {
      "get": {
        "operationId": "launch-sharing.list-grants",
        "summary": "List grants on a launch",
        "description": "Lists the grants on a launch: the whole tree for the owner, the caller's own branch for a delegate.\n\nFeeds the member list of the Collaborate modal and the team avatars on the launch page.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Grant](#object-grant) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "grants": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Grant](#object-grant) objects."
                    }
                  },
                  "required": [
                    "ok",
                    "grants"
                  ]
                },
                "example": {
                  "ok": true,
                  "grants": [
                    {
                      "id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
                      "parent_grant_id": null,
                      "version": 3,
                      "catalog_version": 2,
                      "launch_ext_id": 101920010239643,
                      "chain": "sol",
                      "depth": 0,
                      "operations": [
                        "launch.read",
                        "history.read",
                        "trade.buy",
                        "trade.sell",
                        "automation.autosell"
                      ],
                      "export_keys": [],
                      "use_wallets": [
                        {
                          "kind": "svm_wallet",
                          "wallet_id": 48213,
                          "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
                        }
                      ],
                      "allow_future_wallets": false,
                      "shared_spend_wallets": [],
                      "constraints": {
                        "withdraw_destinations": [],
                        "max_new_wallets": null
                      },
                      "expires_at": "2026-12-01T00:00:00Z",
                      "revoked_at": null,
                      "created_at": "2026-11-02T10:15:00Z",
                      "grantee": "demo-trader",
                      "grantee_display_name": "Demo Trader",
                      "grantee_avatar_url": null
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is a multi-launch container, which cannot be shared. Share each member launch instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is a multi-launch container, which cannot be shared.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a multi-launch container cannot be shared; share its member launches"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#list-grants"
        }
      }
    },
    "/launch/shares/{launch_id}/{grant_id}": {
      "get": {
        "operationId": "launch-sharing.retrieve-grant",
        "summary": "Retrieve a grant",
        "description": "Retrieves one grant with the effective rights of its whole chain.\n\nThe response carries the `version` an update must send as `If-Match`, also returned in the `ETag` header, and the `effective_*` fields.\n\nNot called by the current web app.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          },
          {
            "name": "grant_id",
            "in": "path",
            "required": true,
            "description": "Grant ID (UUID).",
            "schema": {
              "type": "string"
            },
            "example": "a037996a-b1ed-4133-b495-3ba07c7249ad"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a [Grant](#object-grant) object, including its `effective_*` fields.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "grant": {
                      "type": "object",
                      "description": "The [Grant](#object-grant)."
                    }
                  },
                  "required": [
                    "ok",
                    "grant"
                  ]
                },
                "example": {
                  "ok": true,
                  "grant": {
                    "id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
                    "parent_grant_id": null,
                    "version": 3,
                    "catalog_version": 2,
                    "launch_ext_id": 101920010239643,
                    "chain": "sol",
                    "depth": 0,
                    "operations": [
                      "launch.read",
                      "trade.buy"
                    ],
                    "export_keys": [],
                    "use_wallets": [
                      {
                        "kind": "svm_wallet",
                        "wallet_id": 48213,
                        "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
                      }
                    ],
                    "allow_future_wallets": false,
                    "shared_spend_wallets": [],
                    "constraints": {
                      "withdraw_destinations": [],
                      "max_new_wallets": null
                    },
                    "expires_at": null,
                    "revoked_at": null,
                    "created_at": "2026-11-02T10:15:00Z",
                    "grantee": "demo-trader",
                    "grantee_display_name": "Demo Trader",
                    "grantee_avatar_url": null,
                    "effective_operations": [
                      "launch.read",
                      "trade.buy"
                    ],
                    "effective_export_keys": [],
                    "effective_use_wallets": [
                      {
                        "kind": "svm_wallet",
                        "wallet_id": 48213,
                        "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
                      }
                    ],
                    "effective_allow_future_wallets": false,
                    "effective_shared_spend_wallets": [],
                    "effective_withdraw_destinations": []
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No such grant on this launch, or it is outside the caller's branch. Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants).\n\n`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No such grant on this launch, or it is outside the caller's branch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "grant not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#retrieve-grant"
        }
      },
      "patch": {
        "operationId": "launch-sharing.update-grant",
        "summary": "Update a grant",
        "description": "Replaces a grant's rights as a whole, guarded by the grant version.\n\nThe body replaces every right of the grant; omitted lists become empty. Every descendant grant is clamped onto what is left in the same transaction.\n\nThe SDK sends the `version` it read as `If-Match`, so an edit based on a stale read is refused instead of overwriting a change made since.\n\nWhen the owner widens the grant (new operations, new exportable keys, new shared spend wallets, or `allow_future_wallets` turned on), 2FA is always asked, whatever the `launch.share` setting, and the call is refused with 403 when the owner has no second factor. A delegate always answers a step-up.\n\nReducing rights stops new actions only. A strategy or withdrawal already armed under the grant keeps running until it is stopped on its own route.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          },
          {
            "name": "grant_id",
            "in": "path",
            "required": true,
            "description": "Grant ID (UUID).",
            "schema": {
              "type": "string"
            },
            "example": "a037996a-b1ed-4133-b495-3ba07c7249ad"
          },
          {
            "name": "If-Match",
            "in": "header",
            "required": true,
            "description": "The grant `version` the edit is based on.",
            "schema": {
              "type": "integer"
            },
            "example": 3
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "operations": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Permission identifiers, or the string `all`."
                  },
                  "export_keys": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "[Wallet references](#object-wallet-reference) whose key may be exported."
                  },
                  "use_wallets": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "[Wallet references](#object-wallet-reference) the grantee may act on."
                  },
                  "allow_future_wallets": {
                    "type": "boolean",
                    "description": "Also cover wallets added later."
                  },
                  "shared_spend_wallets": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "[Wallet references](#object-wallet-reference) that serve outside this launch and may be spent from."
                  },
                  "constraints": {
                    "type": "object",
                    "properties": {
                      "withdraw_destinations": {
                        "type": "array",
                        "items": {
                          "type": "object"
                        },
                        "description": "Allowed withdraw destinations, each `{ chain, address }`."
                      },
                      "max_new_wallets": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Cap on wallets the grantee may add."
                      }
                    },
                    "description": "Limits on the grant."
                  },
                  "expires_at": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "ISO 8601 expiry, or `null` for none. A past date is refused."
                  }
                },
                "required": [
                  "operations"
                ]
              },
              "example": {
                "operations": [
                  "launch.read",
                  "history.read",
                  "trade.sell"
                ],
                "export_keys": [],
                "use_wallets": [
                  {
                    "kind": "svm_wallet",
                    "wallet_id": 48213,
                    "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
                  }
                ],
                "allow_future_wallets": false,
                "shared_spend_wallets": [],
                "constraints": {
                  "withdraw_destinations": []
                },
                "expires_at": "2026-12-01T00:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the updated [Grant](#object-grant) object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "grant": {
                      "type": "object",
                      "description": "The updated [Grant](#object-grant), with its new `version`."
                    },
                    "descendants_clamped": {
                      "type": "integer",
                      "description": "Number of descendant grants reduced to fit."
                    },
                    "note": {
                      "type": "string",
                      "description": "Reminder that jobs already running keep the wallets they captured."
                    }
                  },
                  "required": [
                    "ok",
                    "grant"
                  ]
                },
                "example": {
                  "ok": true,
                  "grant": {
                    "id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
                    "parent_grant_id": null,
                    "version": 4,
                    "catalog_version": 2,
                    "launch_ext_id": 101920010239643,
                    "chain": "sol",
                    "depth": 0,
                    "operations": [
                      "launch.read",
                      "history.read",
                      "trade.sell"
                    ],
                    "export_keys": [],
                    "use_wallets": [
                      {
                        "kind": "svm_wallet",
                        "wallet_id": 48213,
                        "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
                      }
                    ],
                    "allow_future_wallets": false,
                    "shared_spend_wallets": [],
                    "constraints": {
                      "withdraw_destinations": [],
                      "max_new_wallets": null
                    },
                    "expires_at": "2026-12-01T00:00:00Z",
                    "revoked_at": null,
                    "created_at": "2026-11-02T10:15:00Z"
                  },
                  "descendants_clamped": 0,
                  "note": "a job already armed keeps the wallets it captured; stop it to reduce what it can still spend"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.\n\n`bad_request`: `If-Match` is missing or is not an integer. Send the `version` from [Retrieve a grant](/reference/launch-sharing/#retrieve-grant) as `If-Match`.\n\n`bad_request`: `operations` names an identifier that is not in the catalog. Use identifiers from [Retrieve the permission catalog](/reference/launch-sharing/#retrieve-catalog), or the string `all`.\n\n`bad_request`: `expires_at` is not in the future. Send a future `expires_at`, or `null` for no expiry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`If-Match` is missing or is not an integer.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "If-Match must carry the grant version you read"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`operations` names an identifier that is not in the catalog.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown operation '<op>'"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`expires_at` is not in the future.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "that expiry is already past"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.\n\n`forbidden`: A delegate names an operation its own share does not carry. Remove the operation, or ask the owner to add it to your own grant.\n\n`forbidden`: A delegate names a wallet its own share does not cover. Remove the wallet, or ask the owner to add it to your own grant.\n\n`forbidden`: The owner widens the grant, or the caller is a delegate, and the caller has no second factor. Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  },
                  "forbidden_3": {
                    "summary": "A delegate names an operation its own share does not carry.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "you cannot pass on '<op>': your own share does not carry it"
                    }
                  },
                  "forbidden_4": {
                    "summary": "A delegate names a wallet its own share does not cover.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "you cannot pass on wallet <wallet_id> : your own share does not carry it"
                    }
                  },
                  "forbidden_5": {
                    "summary": "The owner widens the grant, or the caller is a delegate, and the caller has no second factor.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "acting on a shared launch needs two-factor authentication on your own account"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No such grant on this launch, or it is outside the caller's branch. Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants).\n\n`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No such grant on this launch, or it is outside the caller's branch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "grant not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The grant changed since the version sent in `If-Match` was read. Read the grant again with [Retrieve a grant](/reference/launch-sharing/#retrieve-grant) and reapply the change.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The grant changed since the version sent in `If-Match` was read.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "grant version is stale"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: A wallet reference names a wallet the launch does not hold. Pick wallets from [List shareable wallets](/reference/launch-sharing/#list-resources).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "A wallet reference names a wallet the launch does not hold.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "wallet reference <wallet_id> is not attached to this launch"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "`If-Match` makes a repeat answer 409 once the first call applied; read the grant again with [Retrieve a grant](/reference/launch-sharing/#retrieve-grant)."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#update-grant"
        }
      },
      "delete": {
        "operationId": "launch-sharing.revoke-grant",
        "summary": "Revoke a grant",
        "description": "Revokes a grant and every grant re-shared under it.\n\nIdempotent. Strategies and withdrawals already accepted under the grant keep running; stop them on their own routes.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          },
          {
            "name": "grant_id",
            "in": "path",
            "required": true,
            "description": "Grant ID (UUID).",
            "schema": {
              "type": "string"
            },
            "example": "a037996a-b1ed-4133-b495-3ba07c7249ad"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "revoked": {
                      "type": "integer",
                      "description": "Number of grants revoked, including descendants."
                    },
                    "note": {
                      "type": "string",
                      "description": "Reminder that running jobs are not stopped."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true,
                  "revoked": 2,
                  "note": "strategies and withdrawals already accepted keep running; stop them on their own routes"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.\n\n`forbidden`: The caller is a delegate and has no second factor on their own account. Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  },
                  "forbidden_3": {
                    "summary": "The caller is a delegate and has no second factor on their own account.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "acting on a shared launch needs two-factor authentication on your own account"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No such grant on this launch, or it is outside the caller's branch. Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants).\n\n`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No such grant on this launch, or it is outside the caller's branch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "grant not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers `revoked: 0`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#revoke-grant"
        }
      }
    },
    "/launch/shares/{launch_id}/invites": {
      "post": {
        "operationId": "launch-sharing.create-invite",
        "summary": "Create an invite",
        "description": "Opens a link or direct invite that carries the full configuration of the grant it will create.\n\nThe configuration is checked against the caller's own rights before the invite is stored, so an invite can never name a right the grantor lacks. A `link` stays open for 24 hours and takes any number of clicks; each click files a request. A `direct` invite lands in the named account's incoming queue and waits up to 7 days.\n\n`operations: \"all\"` is expanded at write time to every operation marked `in_all` in the catalog. Operations added to the catalog later need a new grant.\n\nA `direct` invite to a username that matches no account still answers `{ \"ok\": true }`, without `invite`, so the response never reveals whether a username exists.\n\nFor the owner, a high-risk configuration (a high-risk operation, an exportable key, a shared spend wallet or `allow_future_wallets`) always asks for 2FA, whatever their settings, and is refused with 403 when they have no second factor. Any other configuration asks for 2FA when `launch.share` is protected, which it is by default once 2FA is on. The challenge is bound to the launch, the invite kind, the invitee and the exact rights. A delegate re-sharing the launch always answers a step-up.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "kind": {
                    "type": "string",
                    "enum": [
                      "link",
                      "direct"
                    ],
                    "description": "Invite channel. A `request` is only ever filed by a link click."
                  },
                  "username": {
                    "type": "string",
                    "description": "Required for `direct`. The invitee's username, with or without a leading `@`."
                  },
                  "operations": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Permission identifiers from the catalog, or the string `all`."
                  },
                  "export_keys": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "[Wallet references](#object-wallet-reference) whose key the grantee may export."
                  },
                  "use_wallets": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "[Wallet references](#object-wallet-reference) the grantee may act on."
                  },
                  "allow_future_wallets": {
                    "type": "boolean",
                    "description": "Also cover wallets added to the launch later."
                  },
                  "shared_spend_wallets": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "[Wallet references](#object-wallet-reference) that serve outside this launch and may be spent from."
                  },
                  "constraints": {
                    "type": "object",
                    "properties": {
                      "withdraw_destinations": {
                        "type": "array",
                        "items": {
                          "type": "object"
                        },
                        "description": "Allowed withdraw destinations, each `{ chain, address }`."
                      },
                      "max_new_wallets": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Cap on wallets the grantee may add."
                      }
                    },
                    "description": "Limits on the grant."
                  },
                  "expires_at": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "ISO 8601 expiry of the resulting grant. Omit or send `null` for no expiry. A past date is refused."
                  }
                },
                "required": [
                  "kind",
                  "operations"
                ]
              },
              "example": {
                "kind": "direct",
                "username": "@demo-trader",
                "operations": [
                  "launch.read",
                  "history.read",
                  "trade.buy",
                  "trade.sell",
                  "automation.autosell"
                ],
                "use_wallets": [
                  {
                    "kind": "svm_wallet",
                    "wallet_id": 48213,
                    "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
                  }
                ],
                "export_keys": [],
                "allow_future_wallets": false,
                "shared_spend_wallets": [],
                "constraints": {
                  "withdraw_destinations": []
                },
                "expires_at": "2026-12-01T00:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the created [Invite](#object-invite) object. A link invite includes its `token`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "invite": {
                      "type": "object",
                      "description": "The [Invite](#object-invite). Absent when a direct invite names no existing account."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true,
                  "invite": {
                    "id": "d71fa141-da50-4ffd-819e-a228f21db19c",
                    "kind": "direct",
                    "launch_ext_id": 101920010239643,
                    "chain": "sol",
                    "inviter": "launchlab",
                    "inviter_display_name": "Launch Lab",
                    "inviter_avatar_url": null,
                    "invitee": "demo-trader",
                    "invitee_display_name": "Demo Trader",
                    "invitee_avatar_url": null,
                    "name": "Moon Otter",
                    "symbol": "OTTER",
                    "image_url": "https://cdn.example.com/tokens/otter.png",
                    "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
                    "launch_platform": "pumpfun",
                    "launch_status": "Finalized",
                    "operations": [
                      "launch.read",
                      "history.read",
                      "trade.buy",
                      "trade.sell",
                      "automation.autosell"
                    ],
                    "export_keys": [],
                    "allow_future_wallets": false,
                    "grant_expires_at": "2026-12-01T00:00:00Z",
                    "max_uses": null,
                    "uses_count": 0,
                    "expires_at": "2026-11-09T10:15:00Z",
                    "created_at": "2026-11-02T10:15:00Z"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.\n\n`bad_request`: `kind` is neither `link` nor `direct`. Send `kind` as `link` or `direct`.\n\n`bad_request`: A `direct` invite has no `username`. Add the invitee's `username`, or send `kind: \"link\"`.\n\n`bad_request`: `username` is not a valid username: 3 to 50 letters, digits or hyphens, starting and ending with a letter or digit. Send the invitee's username as shown on their profile, with or without the leading `@`.\n\n`bad_request`: `operations` names an identifier that is not in the catalog. Use identifiers from [Retrieve the permission catalog](/reference/launch-sharing/#retrieve-catalog), or the string `all`.\n\n`bad_request`: `operations` is empty. Name at least one operation.\n\n`bad_request`: `expires_at` is not in the future. Send a future `expires_at`, or `null` for no expiry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`kind` is neither `link` nor `direct`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown invite kind '<kind>'"
                    }
                  },
                  "bad_request_3": {
                    "summary": "A `direct` invite has no `username`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a direct invite needs a username"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`username` is not a valid username: 3 to 50 letters, digits or hyphens, starting and ending with a letter or digit.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "username must be 3-50 chars"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`operations` names an identifier that is not in the catalog.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "unknown operation '<op>'"
                    }
                  },
                  "bad_request_6": {
                    "summary": "`operations` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "a grant with no operation grants nothing"
                    }
                  },
                  "bad_request_7": {
                    "summary": "`expires_at` is not in the future.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "that expiry is already past"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.\n\n`forbidden`: A delegate names an operation its own share does not carry. Remove the operation, or ask the owner to add it to your own grant.\n\n`forbidden`: The configuration is high risk (a high-risk operation, an exportable key, a shared spend wallet or `allow_future_wallets`), or the caller is a delegate, and the caller has no second factor. Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  },
                  "forbidden_3": {
                    "summary": "A delegate names an operation its own share does not carry.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "you cannot pass on '<op>': your own share does not carry it"
                    }
                  },
                  "forbidden_4": {
                    "summary": "The configuration is high risk (a high-risk operation, an exportable key, a shared spend wallet or `allow_future_wallets`), or the caller is a delegate, and the caller has no second factor.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "acting on a shared launch needs two-factor authentication on your own account"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The launch does not exist or the caller cannot manage it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The launch does not exist or the caller cannot manage it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The invitee already has a pending invite or request on this launch. Wait for the invitee to answer, or cancel the pending invite with [Revoke an invite](/reference/launch-sharing/#revoke-invite).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The invitee already has a pending invite or request on this launch.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "that license already has a pending invite on this launch"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is a multi-launch container, which cannot be shared. Share each member launch instead.\n\n`unprocessable`: The launch already has 100 live invites. Cancel unused invites with [Revoke an invite](/reference/launch-sharing/#revoke-invite) first.\n\n`unprocessable`: The `direct` invite names the caller. Invite another account.\n\n`unprocessable`: The `direct` invite names the launch owner. Invite an account other than the owner.\n\n`unprocessable`: A wallet reference names a wallet the launch does not hold. Pick wallets from [List shareable wallets](/reference/launch-sharing/#list-resources).\n\n`unprocessable`: `export_keys` names a wallet whose key cannot be exported on the owner's tier. Only list wallets that [List shareable wallets](/reference/launch-sharing/#list-resources) marks `exportable`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is a multi-launch container, which cannot be shared.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a multi-launch container cannot be shared; share its member launches"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The launch already has 100 live invites.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch already carries its maximum of invites"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "The `direct` invite names the caller.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "you cannot invite yourself"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "The `direct` invite names the launch owner.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the owner already holds this launch"
                    }
                  },
                  "unprocessable_5": {
                    "summary": "A wallet reference names a wallet the launch does not hold.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "wallet reference <wallet_id> is not attached to this launch"
                    }
                  },
                  "unprocessable_6": {
                    "summary": "`export_keys` names a wallet whose key cannot be exported on the owner's tier.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "the key of wallet <wallet_id> cannot be exported on the owner's tier"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "launch.share",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeated `link` invite opens a second link, and a repeated `direct` invite answers 409. Look for the invite in [List managed invites](/reference/launch-sharing/#list-managed-invites) first."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#create-invite"
        }
      }
    },
    "/launch/invites/managed": {
      "get": {
        "operationId": "launch-sharing.list-managed-invites",
        "summary": "List managed invites",
        "description": "Lists every live invite and request the caller can manage, across all of its launches.\n\nThe web app polls this every 30 seconds for the bottom-bar invites menu, and filters it by `launch_ext_id` to show one launch's open invites and pending requests in the Collaborate modal.",
        "tags": [
          "Launch Sharing"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Invite](#object-invite) objects. `token` is included only for launches the caller owns.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "invites": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Invite](#object-invite) objects of kind `link`, `direct` or `request`."
                    }
                  },
                  "required": [
                    "ok",
                    "invites"
                  ]
                },
                "example": {
                  "ok": true,
                  "invites": [
                    {
                      "id": "77ee5498-77c9-404b-8932-c95331fd86ce",
                      "kind": "request",
                      "launch_ext_id": 101920010239643,
                      "chain": "sol",
                      "inviter": "launchlab",
                      "inviter_display_name": "Launch Lab",
                      "inviter_avatar_url": null,
                      "invitee": "otter-fan",
                      "invitee_display_name": null,
                      "invitee_avatar_url": null,
                      "name": "Moon Otter",
                      "symbol": "OTTER",
                      "image_url": "https://cdn.example.com/tokens/otter.png",
                      "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
                      "launch_platform": "pumpfun",
                      "launch_status": "Finalized",
                      "operations": [
                        "launch.read",
                        "history.read"
                      ],
                      "export_keys": [],
                      "allow_future_wallets": false,
                      "grant_expires_at": null,
                      "max_uses": null,
                      "uses_count": 0,
                      "expires_at": "2026-11-09T10:15:00Z",
                      "created_at": "2026-11-02T10:15:00Z"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can answer its invites"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#list-managed-invites"
        }
      }
    },
    "/launch/shares/{launch_id}/invites/{invite_id}": {
      "delete": {
        "operationId": "launch-sharing.revoke-invite",
        "summary": "Revoke an invite",
        "description": "Cancels a link, revokes a pending direct invite, or declines a request.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          },
          {
            "name": "invite_id",
            "in": "path",
            "required": true,
            "description": "Invite ID (UUID).",
            "schema": {
              "type": "string"
            },
            "example": "d71fa141-da50-4ffd-819e-a228f21db19c"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "revoked": {
                      "type": "boolean",
                      "description": "Whether the invite changed state."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true,
                  "revoked": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.\n\n`forbidden`: The caller is a delegate and has no second factor on their own account. Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  },
                  "forbidden_3": {
                    "summary": "The caller is a delegate and has no second factor on their own account.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "acting on a shared launch needs two-factor authentication on your own account"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No such invite on this launch, or a delegate tried to revoke an invite it did not open. Pick an invite ID from [List managed invites](/reference/launch-sharing/#list-managed-invites).\n\n`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No such invite on this launch, or a delegate tried to revoke an invite it did not open.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "invite not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers `revoked: false`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#revoke-invite"
        }
      }
    },
    "/launch/shares/{launch_id}/invites/{invite_id}/approve": {
      "post": {
        "operationId": "launch-sharing.approve-request",
        "summary": "Approve a join request",
        "description": "Approves a request filed through a link and creates its grant.\n\nThe stored configuration is re-validated against the grantor's rights at this moment, so a right the grantor lost since the link was opened cannot be passed on. Because the link named no one, the owner confirms again here, bound to this request and the account it names.\n\nFor the owner, 2FA follows the same rule as [Create an invite](/reference/launch-sharing/#create-invite): always for a high-risk configuration, otherwise as `launch.share` is set. The challenge is bound to this request and the account it names.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          },
          {
            "name": "invite_id",
            "in": "path",
            "required": true,
            "description": "ID of the `request` invite.",
            "schema": {
              "type": "string"
            },
            "example": "77ee5498-77c9-404b-8932-c95331fd86ce"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "grant_id": {
                      "type": "string",
                      "description": "ID of the grant created."
                    },
                    "launch_ext_id": {
                      "type": "integer",
                      "description": "The launch `ext_id`."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Chain ID of the launch."
                    }
                  },
                  "required": [
                    "ok",
                    "grant_id",
                    "launch_ext_id",
                    "chain"
                  ]
                },
                "example": {
                  "ok": true,
                  "grant_id": "c70deb57-52d2-445c-adbc-4b6052a08edb",
                  "launch_ext_id": 101920010239643,
                  "chain": "sol"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.\n\n`forbidden`: The request carries a high-risk configuration, or the caller is a delegate, and the caller has no second factor. Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment).\n\n`forbidden`: The delegate who opened the link no longer holds a share on the launch. Ask the owner to open a new link.\n\n`forbidden`: The delegate who opened the link lost `access.manage` since. Ask the owner to open a new link.\n\n`forbidden`: The grantor lost an operation the request carries since the link was opened. Remove the operation, or ask the owner to add it to your own grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  },
                  "forbidden_3": {
                    "summary": "The request carries a high-risk configuration, or the caller is a delegate, and the caller has no second factor.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "acting on a shared launch needs two-factor authentication on your own account"
                    }
                  },
                  "forbidden_4": {
                    "summary": "The delegate who opened the link no longer holds a share on the launch.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "the inviter no longer shares this launch"
                    }
                  },
                  "forbidden_5": {
                    "summary": "The delegate who opened the link lost `access.manage` since.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "the inviter can no longer re-share this launch"
                    }
                  },
                  "forbidden_6": {
                    "summary": "The grantor lost an operation the request carries since the link was opened.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "you cannot pass on '<op>': your own share does not carry it"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No such request on this launch. Pick a pending request from [List managed invites](/reference/launch-sharing/#list-managed-invites).\n\n`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No such request on this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "request not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The request was already approved, or was settled while the grant was being created. Check [List grants on a launch](/reference/launch-sharing/#list-grants): the grant may already exist.\n\n`conflict`: The requester already holds a grant on this launch. Change the existing grant with [Update a grant](/reference/launch-sharing/#update-grant) instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The request was already approved, or was settled while the grant was being created.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "this invite is no longer open"
                    }
                  },
                  "conflict_2": {
                    "summary": "The requester already holds a grant on this launch.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "this license already holds a grant on this launch"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The request has expired. Ask the account to request access again through a live link.\n\n`unprocessable`: The launch changed owner since the link was opened. Open a new link from the current owner's account.\n\n`unprocessable`: The launch already has 50 live grants. Free a slot with [Revoke a grant](/reference/launch-sharing/#revoke-grant) first.\n\n`unprocessable`: The requester already holds 200 shares. Ask the requester to leave a shared launch first.\n\n`unprocessable`: The new grant would sit deeper in the chain of re-shares than allowed. Have someone higher in the chain share the launch directly.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The request has expired.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this request is no longer open"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The launch changed owner since the link was opened.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch has changed hands, so the invite is stale"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "The launch already has 50 live grants.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch already carries its maximum of shares"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "The requester already holds 200 shares.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "that license already holds its maximum of shares"
                    }
                  },
                  "unprocessable_5": {
                    "summary": "The new grant would sit deeper in the chain of re-shares than allowed.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this chain of shares is already as deep as it goes"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "launch.share",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers 409 once the grant exists; [List grants on a launch](/reference/launch-sharing/#list-grants) shows it."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#approve-request"
        }
      }
    },
    "/launch/invites/link/{token}": {
      "get": {
        "operationId": "launch-sharing.preview-invite-link",
        "summary": "Preview an invite link",
        "description": "Returns the launch, inviter, rights and expiry behind an invite link.\n\nBacks the join page opened from `/invite/{token}`. When `already_member` is `true` the web app skips the request step and navigates straight to the launch. Requires a signed-in account.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "token",
            "in": "path",
            "required": true,
            "description": "Link token from the invite URL.",
            "schema": {
              "type": "string"
            },
            "example": "4p3xl8eq9ao5swi5wb"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "already_member": {
                      "type": "boolean",
                      "description": "The caller already owns the launch or holds a grant on it."
                    },
                    "invite": {
                      "type": "object",
                      "description": "The [Invite](#object-invite), without its `token`."
                    }
                  },
                  "required": [
                    "ok",
                    "already_member",
                    "invite"
                  ]
                },
                "example": {
                  "ok": true,
                  "already_member": false,
                  "invite": {
                    "id": "d71fa141-da50-4ffd-819e-a228f21db19c",
                    "kind": "link",
                    "launch_ext_id": 101920010239643,
                    "chain": "sol",
                    "inviter": "launchlab",
                    "inviter_display_name": "Launch Lab",
                    "inviter_avatar_url": null,
                    "invitee": null,
                    "invitee_display_name": null,
                    "invitee_avatar_url": null,
                    "name": "Moon Otter",
                    "symbol": "OTTER",
                    "image_url": "https://cdn.example.com/tokens/otter.png",
                    "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
                    "launch_platform": "pumpfun",
                    "launch_status": "Finalized",
                    "operations": [
                      "launch.read",
                      "history.read",
                      "trade.buy",
                      "trade.sell"
                    ],
                    "export_keys": [],
                    "allow_future_wallets": false,
                    "grant_expires_at": null,
                    "max_uses": null,
                    "uses_count": 2,
                    "expires_at": "2026-11-03T10:15:00Z",
                    "created_at": "2026-11-02T10:15:00Z"
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The link is not valid. The web app shows the link as invalid. Ask the inviter for a new link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The link is not valid. The web app shows the link as invalid.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this invite link is not valid"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The link has expired or was cancelled. Ask the inviter for a new link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The link has expired or was cancelled.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this invite link has expired"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 20 link previews or link requests in a minute for this account. Wait a minute before opening another link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 20 link previews or link requests in a minute for this account.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for invite_link, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#preview-invite-link"
        }
      }
    },
    "/launch/invites/link/{token}/request": {
      "post": {
        "operationId": "launch-sharing.request-link-access",
        "summary": "Request to join through a link",
        "description": "Files a join request through an invite link, or reports that the caller is already a member.\n\nNo grant is created here: the request waits for the grantor to approve it. A repeat click while a request is still open is a no-op and is reported as sent. On `already_member` the web app navigates to the launch.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "token",
            "in": "path",
            "required": true,
            "description": "Link token from the invite URL.",
            "schema": {
              "type": "string"
            },
            "example": "4p3xl8eq9ao5swi5wb"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "request_sent",
                        "already_member"
                      ],
                      "description": "Outcome of the click."
                    },
                    "launch_ext_id": {
                      "type": "integer",
                      "description": "Only for `already_member`: the launch to open."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Only for `already_member`: chain ID of the launch."
                    }
                  },
                  "required": [
                    "ok",
                    "status"
                  ]
                },
                "example": {
                  "ok": true,
                  "status": "request_sent"
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can answer its invites"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The link is not valid. Ask the inviter for a new link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The link is not valid.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "this invite link is not valid"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The link has expired or was cancelled. Ask the inviter for a new link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The link has expired or was cancelled.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this invite link has expired"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 20 link previews or link requests in a minute for this account. Wait a minute before opening another link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 20 link previews or link requests in a minute for this account.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for invite_link, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat while the request is open files nothing new and answers `request_sent` again."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#request-link-access"
        }
      }
    },
    "/launch/invites/incoming": {
      "get": {
        "operationId": "launch-sharing.list-incoming-invites",
        "summary": "List incoming invites",
        "description": "Lists the direct invites addressed to the caller that are still pending.\n\nPolled every 60 seconds for the bottom-bar invites menu. Requests the caller filed through links are not included.",
        "tags": [
          "Launch Sharing"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Invite](#object-invite) objects of kind `direct`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "invites": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Invite](#object-invite) objects."
                    }
                  },
                  "required": [
                    "ok",
                    "invites"
                  ]
                },
                "example": {
                  "ok": true,
                  "invites": [
                    {
                      "id": "d71fa141-da50-4ffd-819e-a228f21db19c",
                      "kind": "direct",
                      "launch_ext_id": 202752211705544,
                      "chain": "base",
                      "inviter": "launchlab",
                      "inviter_display_name": "Launch Lab",
                      "inviter_avatar_url": null,
                      "invitee": "demo-trader",
                      "invitee_display_name": "Demo Trader",
                      "invitee_avatar_url": null,
                      "name": "Base Heron",
                      "symbol": "HERON",
                      "image_url": null,
                      "mint_pubkey": "0xb9767cbebeaa4406e61ea880017479efc18c0a76",
                      "launch_platform": "clanker",
                      "launch_status": "Finalized",
                      "operations": [
                        "launch.read",
                        "history.read"
                      ],
                      "export_keys": [],
                      "allow_future_wallets": false,
                      "grant_expires_at": null,
                      "max_uses": null,
                      "uses_count": 0,
                      "expires_at": "2026-11-09T10:15:00Z",
                      "created_at": "2026-11-02T10:15:00Z"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can answer its invites"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#list-incoming-invites"
        }
      }
    },
    "/launch/invites/{invite_id}/accept": {
      "post": {
        "operationId": "launch-sharing.accept-invite",
        "summary": "Accept an invite",
        "description": "Accepts a direct invite addressed to the caller and creates its grant.\n\nThe stored configuration is re-validated against the grantor's rights at this moment before the grant is inserted.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "invite_id",
            "in": "path",
            "required": true,
            "description": "ID of the direct invite.",
            "schema": {
              "type": "string"
            },
            "example": "d71fa141-da50-4ffd-819e-a228f21db19c"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "grant_id": {
                      "type": "string",
                      "description": "ID of the grant created."
                    },
                    "launch_ext_id": {
                      "type": "integer",
                      "description": "The launch `ext_id`."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Chain ID of the launch."
                    }
                  },
                  "required": [
                    "ok",
                    "grant_id",
                    "launch_ext_id",
                    "chain"
                  ]
                },
                "example": {
                  "ok": true,
                  "grant_id": "1db9300d-7675-4ea9-b059-f55926850b1c",
                  "launch_ext_id": 202752211705544,
                  "chain": "base"
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The delegate who sent the invite no longer holds a share on the launch. Ask the owner for a new invite.\n\n`forbidden`: The delegate who sent the invite lost `access.manage` since. Ask the owner for a new invite.\n\n`forbidden`: The inviter lost an operation the invite carries since it was sent. Remove the operation, or ask the owner to add it to your own grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can answer its invites"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The delegate who sent the invite no longer holds a share on the launch.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "the inviter no longer shares this launch"
                    }
                  },
                  "forbidden_3": {
                    "summary": "The delegate who sent the invite lost `access.manage` since.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "the inviter can no longer re-share this launch"
                    }
                  },
                  "forbidden_4": {
                    "summary": "The inviter lost an operation the invite carries since it was sent.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "you cannot pass on '<op>': your own share does not carry it"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No direct invite with this ID is addressed to the caller. Pick an invite ID from [List incoming invites](/reference/launch-sharing/#list-incoming-invites).\n\n`not_found`: The launch no longer exists. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No direct invite with this ID is addressed to the caller.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "invite not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch no longer exists.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The invite was settled while the grant was being created. Check [List launches shared with you](/reference/launch-sharing/#list-shared-launches): the grant may already exist.\n\n`conflict`: The caller already holds a grant on this launch. Open the launch from [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The invite was settled while the grant was being created.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "this invite is no longer open"
                    }
                  },
                  "conflict_2": {
                    "summary": "The caller already holds a grant on this launch.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "this license already holds a grant on this launch"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The invite was already answered or revoked, or has expired. Ask the inviter for a new invite.\n\n`unprocessable`: The launch changed owner since the invite was created. Ask the current owner for a new invite.\n\n`unprocessable`: The launch already has 50 live grants. Free a slot with [Revoke a grant](/reference/launch-sharing/#revoke-grant) first.\n\n`unprocessable`: The caller already holds 200 shares. Free a slot with [Leave a shared launch](/reference/launch-sharing/#leave-shared-launch) first.\n\n`unprocessable`: The new grant would sit deeper in the chain of re-shares than allowed. Have someone higher in the chain share the launch directly.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The invite was already answered or revoked, or has expired.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this invite is no longer open"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The launch changed owner since the invite was created.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch has changed hands, so the invite is stale"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "The launch already has 50 live grants.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this launch already carries its maximum of shares"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "The caller already holds 200 shares.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "that license already holds its maximum of shares"
                    }
                  },
                  "unprocessable_5": {
                    "summary": "The new grant would sit deeper in the chain of re-shares than allowed.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this chain of shares is already as deep as it goes"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers 422 once the grant exists; [List launches shared with you](/reference/launch-sharing/#list-shared-launches) shows it."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#accept-invite"
        }
      }
    },
    "/launch/invites/{invite_id}/decline": {
      "post": {
        "operationId": "launch-sharing.decline-invite",
        "summary": "Decline an invite",
        "description": "Refuses a direct invite addressed to the caller.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "invite_id",
            "in": "path",
            "required": true,
            "description": "ID of the direct invite.",
            "schema": {
              "type": "string"
            },
            "example": "d71fa141-da50-4ffd-819e-a228f21db19c"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "declined": {
                      "type": "boolean",
                      "description": "Whether the invite changed state."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true,
                  "declined": true
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can answer its invites"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No direct invite with this ID is addressed to the caller. Pick an invite ID from [List incoming invites](/reference/launch-sharing/#list-incoming-invites).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No direct invite with this ID is addressed to the caller.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "invite not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The invite was already answered or revoked, or has expired. Nothing to do: the invite can no longer be accepted.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The invite was already answered or revoked, or has expired.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "this invite is no longer open"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers 422 once the invite is declined."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#decline-invite"
        }
      }
    },
    "/launch/shares/{launch_id}/{grant_id}/jobs": {
      "get": {
        "operationId": "launch-sharing.list-grant-jobs",
        "summary": "List a grant's jobs",
        "description": "Lists what a grant left running on the launch and the trace of what it did.\n\nOwner only. Shown as **Running jobs** in the Collaborate modal, so the owner can see and stop automations a grantee started.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          },
          {
            "name": "grant_id",
            "in": "path",
            "required": true,
            "description": "Grant ID (UUID).",
            "schema": {
              "type": "string"
            },
            "example": "a037996a-b1ed-4133-b495-3ba07c7249ad"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "jobs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "kind": {
                            "type": "string",
                            "description": "Job kind: `autosell`, `autobuy`, `volume`, `cleanup` or `withdraw`; `market_maker` on Solana, `sniper_guard` on EVM chains."
                          },
                          "id": {
                            "type": "string",
                            "description": "Job ID (UUID). Use it on the job's own route to read or stop it."
                          },
                          "status": {
                            "type": "string",
                            "description": "Job status, as stored for its kind, e.g. `running`."
                          },
                          "created_at": {
                            "type": "string",
                            "description": "Creation time. ISO 8601: without a time zone (UTC) for sessions, with one for withdrawals."
                          }
                        },
                        "required": [
                          "kind",
                          "id",
                          "status",
                          "created_at"
                        ]
                      },
                      "description": "Jobs started under the grant, newest first within each kind."
                    },
                    "trace": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Recorded actions taken under the grant."
                    },
                    "note": {
                      "type": "string",
                      "description": "Reminder that revoking the grant does not stop a job."
                    }
                  },
                  "required": [
                    "ok",
                    "jobs",
                    "trace",
                    "note"
                  ]
                },
                "example": {
                  "ok": true,
                  "jobs": [
                    {
                      "kind": "autosell",
                      "id": "0f4e1ab4-5ba8-41eb-80ff-53eb97f08f2a",
                      "status": "running",
                      "created_at": "2026-11-02T09:58:12"
                    }
                  ],
                  "trace": [],
                  "note": "stop a job on its own strategy route; revoking the grant does not stop it"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No such grant on this launch. Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants).\n\n`not_found`: The launch does not exist or the caller is not its owner. Delegates get this answer too. Call this endpoint from the owner's account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No such grant on this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "grant not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch does not exist or the caller is not its owner. Delegates get this answer too.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#list-grant-jobs"
        }
      }
    },
    "/launch/shares/{launch_id}/transfer-check": {
      "get": {
        "operationId": "launch-sharing.check-transfer",
        "summary": "Check ownership transfer",
        "description": "Reports whether the launch can change owner right now.\n\nOwner only. A transfer is blocked while a job started under a grant is still signing on the launch.\n\nNot called by the current web app.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "may_transfer": {
                      "type": "boolean",
                      "description": "Whether ownership can change now."
                    },
                    "reason": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Why a transfer is blocked, or `null`."
                    }
                  },
                  "required": [
                    "ok",
                    "may_transfer",
                    "reason"
                  ]
                },
                "example": {
                  "ok": true,
                  "may_transfer": false,
                  "reason": "a delegated job is still signing on this launch"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The session's user is not the user the license is associated with. Sign in as the user the license is associated with.\n\n`forbidden`: The caller reaches the launch through a share that does not carry `access.manage`. Ask the owner to add `access.manage` to your grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The session's user is not the user the license is associated with.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "only the user this license is associated with can manage its shares"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller reaches the launch through a share that does not carry `access.manage`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'access.manage'"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The launch does not exist or the caller is not its owner. Delegates get this answer too. Call this endpoint from the owner's account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The launch does not exist or the caller is not its owner. Delegates get this answer too.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch is a multi-launch container, which cannot be shared. Share each member launch instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch is a multi-launch container, which cannot be shared.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a multi-launch container cannot be shared; share its member launches"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#check-transfer"
        }
      }
    },
    "/launch/shared": {
      "get": {
        "operationId": "launch-sharing.list-shared-launches",
        "summary": "List launches shared with you",
        "description": "Lists the launches other accounts have shared with the caller.\n\nThe web app merges these into the launch list and search, and uses them to decide access on a launch page.\n\nThe web app sends no paging parameters; the backend then returns at most 50 entries.",
        "tags": [
          "Launch Sharing"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Shared launch](#object-shared-launch) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "shared": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Shared launch](#object-shared-launch) objects."
                    }
                  },
                  "required": [
                    "ok",
                    "shared"
                  ]
                },
                "example": {
                  "ok": true,
                  "shared": [
                    {
                      "grant_id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
                      "launch_ext_id": 101920010239643,
                      "chain": "sol",
                      "owner": "launchlab",
                      "owner_display_name": "Launch Lab",
                      "effective_operations": [
                        "launch.read",
                        "history.read",
                        "trade.buy",
                        "trade.sell"
                      ],
                      "effective_export_keys": [],
                      "allow_future_wallets": false,
                      "withdraw_destinations": [],
                      "expires_at": null,
                      "catalog_version": 2,
                      "version": 3,
                      "name": "Moon Otter",
                      "symbol": "OTTER",
                      "image_url": "https://cdn.example.com/tokens/otter.png",
                      "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
                      "launch_platform": "pumpfun",
                      "launch_status": "Finalized",
                      "created_at": 1793491200,
                      "mint": null
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#list-shared-launches"
        }
      }
    },
    "/launch/shared/{grant_id}": {
      "delete": {
        "operationId": "launch-sharing.leave-shared-launch",
        "summary": "Leave a shared launch",
        "description": "Refuses the caller's own grant on a shared launch, revoking everything re-shared under it.\n\nCalled from the shared-launch banner on a launch page.",
        "tags": [
          "Launch Sharing"
        ],
        "parameters": [
          {
            "name": "grant_id",
            "in": "path",
            "required": true,
            "description": "ID of the caller's grant, from the shared-launch list.",
            "schema": {
              "type": "string"
            },
            "example": "a037996a-b1ed-4133-b495-3ba07c7249ad"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "revoked": {
                      "type": "integer",
                      "description": "Number of grants revoked, including descendants."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true,
                  "revoked": 1
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No such grant held by the caller. Pick a grant ID from [List launches shared with you](/reference/launch-sharing/#list-shared-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No such grant held by the caller.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "grant not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers `revoked: 0`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/launch-sharing/#leave-shared-launch"
        }
      }
    },
    "/launch/autobuy/plan/{launch_id}": {
      "post": {
        "operationId": "auto-buy.plan-auto-buy",
        "summary": "Plan an Auto Buy session",
        "description": "Saves an Auto Buy session as `Planned` so that it starts with the launch.\n\nReplaces a previously planned session. Refused while a session is running or paused. Buy ladder targets must be strictly decreasing, and layer market-cap ranges must not overlap.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "object",
                    "description": "A single strategy, shaped like the [Auto buy mode](#object-auto-buy-mode) object. Send `mode` or `modes`."
                  },
                  "modes": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Several strategies run together, each shaped like the [Auto buy mode](#object-auto-buy-mode) object. The web app sends this form."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "time": {
                        "type": "integer",
                        "description": "Session duration in seconds; `0` uses the maximum of 30 days."
                      },
                      "amount": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "string"
                          }
                        ],
                        "description": "Quote the session may spend, raw units. `0` means no limit."
                      }
                    },
                    "required": [
                      "time",
                      "amount"
                    ],
                    "description": "Session-wide limits."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points, at most 10000. Defaults to 500 on Solana."
                  },
                  "min_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored: neither chain applies a session-wide lower bound, although the web app sends it when set. Set `min_mcap` on each layer instead."
                  },
                  "max_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored, like `min_mcap`. Set `max_mcap` on each layer instead."
                  },
                  "start_delay": {
                    "type": "integer",
                    "description": "Seconds to wait before the first trade, at most 30 days."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade. Omit or send `null` for all of them; an empty array is rejected."
                  }
                },
                "required": [
                  "end_condition"
                ]
              },
              "example": {
                "modes": [
                  {
                    "SwapBack": {
                      "whitelist": [],
                      "layers": [
                        {
                          "replication_factor": 5000,
                          "trigger_condition": {
                            "type": "MinSol",
                            "value": 100000000
                          },
                          "min_sol_per_swap": "10000000",
                          "min_mcap": 0,
                          "max_mcap": 250000000000
                        }
                      ]
                    }
                  },
                  {
                    "McapLadder": [
                      {
                        "target_mcap": 80000000000,
                        "buy_amount": "500000000"
                      },
                      {
                        "target_mcap": 60000000000,
                        "buy_amount": "1000000000"
                      }
                    ]
                  }
                ],
                "end_condition": {
                  "time": 86400,
                  "amount": "5000000000"
                },
                "slippage": 500,
                "wallet_pubkeys": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully planned auto buying task"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `wallet_pubkeys` is an empty array. Omit `wallet_pubkeys` to trade from every launch wallet.\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a valid address. Send the base58 addresses of the launch's wallets.\n\n`bad_request`: `launch_id` is a multi-launch group container whose plan is no longer a draft. Plan the session on the winning member launch instead.\n\n`bad_request`: EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys cannot be empty"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container whose plan is no longer a draft.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch group plan can only be edited while draft"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No funder wallet configured"
                    }
                  },
                  "bad_request_6": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: an entry of `wallet_pubkeys` is not a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet not found in launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: A session for this launch is `Running` or `Paused`. Change the live session with [Update an Auto Buy session](/reference/auto-buy/#update-auto-buy), or cancel it with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) before planning again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "A session for this launch is `Running` or `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Task already running"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: No wallet is left to trade: the launch has no wallets, or (EVM) `wallet_pubkeys` is empty or names none of them. Omit `wallet_pubkeys` to use every launch wallet, or add wallets with [Add wallets to a launch](/reference/launches/#add-launch-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "No wallet is left to trade: the launch has no wallets, or (EVM) `wallet_pubkeys` is empty or names none of them.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No wallets available"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be decreasing mcap)` or `Slippage must be <= 10000 bps`. On a multi-launch container the same messages come back as `400 bad_request`. Fix the parameter named in `message` within the limits listed on [Auto buy mode](/reference/auto-buy/#object-auto-buy-mode).\n\n`internal_error`: Solana: the launch has no funder, holder or MEV wallets saved yet. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be decreasing mcap)` or `Slippage must be <= 10000 bps`. On a multi-launch container the same messages come back as `400 bad_request`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No buying mode provided"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: the launch has no funder, holder or MEV wallets saved yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch data saved"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Planning again overwrites the parameters of the `Planned` session. Once the session runs, a repeat answers `409`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#plan-auto-buy"
        }
      }
    },
    "/launch/autobuy/run/{launch_id}": {
      "post": {
        "operationId": "auto-buy.run-auto-buy",
        "summary": "Start an Auto Buy session",
        "description": "Starts an Auto Buy session right away on a launched token.\n\nRefused while a session is running or paused. If a session is `Planned` for the launch, it starts with the planned parameters and the body is ignored.\n\nTrades from the launch wallets until the session ends, is paused or is cancelled.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "object",
                    "description": "A single strategy, shaped like the [Auto buy mode](#object-auto-buy-mode) object. Send `mode` or `modes`."
                  },
                  "modes": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Several strategies run together, each shaped like the [Auto buy mode](#object-auto-buy-mode) object. The web app sends this form."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "time": {
                        "type": "integer",
                        "description": "Session duration in seconds; `0` uses the maximum of 30 days."
                      },
                      "amount": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "string"
                          }
                        ],
                        "description": "Quote the session may spend, raw units. `0` means no limit."
                      }
                    },
                    "required": [
                      "time",
                      "amount"
                    ],
                    "description": "Session-wide limits."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points, at most 10000. Defaults to 500 on Solana."
                  },
                  "min_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored: neither chain applies a session-wide lower bound, although the web app sends it when set. Set `min_mcap` on each layer instead."
                  },
                  "max_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored, like `min_mcap`. Set `max_mcap` on each layer instead."
                  },
                  "start_delay": {
                    "type": "integer",
                    "description": "Seconds to wait before the first trade, at most 30 days."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade. Omit or send `null` for all of them; an empty array is rejected."
                  }
                },
                "required": [
                  "end_condition"
                ]
              },
              "example": {
                "modes": [
                  {
                    "SwapBack": {
                      "whitelist": [],
                      "layers": [
                        {
                          "replication_factor": 5000,
                          "trigger_condition": {
                            "type": "MinSol",
                            "value": 100000000
                          },
                          "min_sol_per_swap": "10000000",
                          "min_mcap": 0,
                          "max_mcap": 250000000000
                        }
                      ]
                    }
                  },
                  {
                    "McapLadder": [
                      {
                        "target_mcap": 80000000000,
                        "buy_amount": "500000000"
                      },
                      {
                        "target_mcap": 60000000000,
                        "buy_amount": "1000000000"
                      }
                    ]
                  }
                ],
                "end_condition": {
                  "time": 86400,
                  "amount": "5000000000"
                },
                "slippage": 500,
                "wallet_pubkeys": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully started auto buying task"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `wallet_pubkeys` is an empty array. Omit `wallet_pubkeys` to trade from every launch wallet.\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a valid address. Send the base58 addresses of the launch's wallets.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: EVM: the launch is still a draft. Imported tokens are accepted. Launch the token with [Launch a token](/reference/launch-execution/#launch) first, or save the session with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy) so it starts with the launch.\n\n`bad_request`: EVM: no wallet can trade, because `wallet_pubkeys` is an empty array or the launch holds no wallets. Omit `wallet_pubkeys` to trade from every launch wallet.\n\n`bad_request`: EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys cannot be empty"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: not available here; use the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the launch is still a draft. Imported tokens are accepted.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: no wallet can trade, because `wallet_pubkeys` is an empty array or the launch holds no wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No wallets available for autobuy"
                    }
                  },
                  "bad_request_7": {
                    "summary": "EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No funder wallet configured"
                    }
                  },
                  "bad_request_8": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: an entry of `wallet_pubkeys` is not a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet not found in launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: A session for this launch is already `Running` or `Paused`. Change the running session with [Update an Auto Buy session](/reference/auto-buy/#update-auto-buy) instead of starting another.\n\n`conflict`: The launch trades on the pace engine, which already runs an Auto Buy session for it. Change that session with [Update an Auto Buy session](/reference/auto-buy/#update-auto-buy) or cancel it with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "A session for this launch is already `Running` or `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Task already running"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch trades on the pace engine, which already runs an Auto Buy session for it.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already trades this launch in this direction"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`venue_ungated`: EVM: replication layers or market-cap bounds need a known pool for the token and none is recorded; `message` names what is missing. Use timed layers without market-cap bounds, or retry once the pool is recorded.\n\n`unprocessable`: The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at. Change the rule named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "venue_ungated": {
                    "summary": "EVM: replication layers or market-cap bounds need a known pool for the token and none is recorded; `message` names what is missing.",
                    "value": {
                      "ok": false,
                      "code": "venue_ungated",
                      "message": "the launchpad holds no record of this token"
                    }
                  },
                  "unprocessable": {
                    "summary": "The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a MinSol trigger is only valid when the launch's quote is native"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch is still a draft. Launch the token with [Launch a token](/reference/launch-execution/#launch) first, or save the session with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy) so it starts with the launch.\n\n`internal_error`: EVM: none of `wallet_pubkeys` is a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`internal_error`: The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be decreasing mcap)` or `Slippage must be <= 10000 bps`. When a session is `Planned`, its saved parameters are checked instead of the body. Fix the parameter named in `message` within the limits listed on [Auto buy mode](/reference/auto-buy/#object-auto-buy-mode).\n\n`internal_error`: Solana: the launch has no funder, holder or MEV wallets saved yet. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.\n\n`internal_error`: Solana: the price of the launch's quote token is not known yet, so the engine cannot start. Send the request again in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch is still a draft.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "EVM: none of `wallet_pubkeys` is a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "wallet_pubkeys provided but none matched launch wallets"
                    }
                  },
                  "internal_error_3": {
                    "summary": "The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be decreasing mcap)` or `Slippage must be <= 10000 bps`. When a session is `Planned`, its saved parameters are checked instead of the body.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No buying mode provided"
                    }
                  },
                  "internal_error_4": {
                    "summary": "Solana: the launch has no funder, holder or MEV wallets saved yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch data saved"
                    }
                  },
                  "internal_error_5": {
                    "summary": "Solana: the price of the launch's quote token is not known yet, so the engine cannot start.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "the launch quote carries no price"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status) first: `Running` or `Paused` means the first call went through, and a repeat answers `409` while the session lasts."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#run-auto-buy"
        }
      }
    },
    "/launch/autobuy/update/{launch_id}": {
      "post": {
        "operationId": "auto-buy.update-auto-buy",
        "summary": "Update an Auto Buy session",
        "description": "Replaces the parameters of a planned, running or paused Auto Buy session.\n\nOn a live session, layers whose IDs survive the update keep their progress.\n\nOn Solana the response also carries `wallet_set_unchanged` and `wallets_added`, which the web app does not read. EVM answers with `ok` and `message` only.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "object",
                    "description": "A single strategy, shaped like the [Auto buy mode](#object-auto-buy-mode) object. Send `mode` or `modes`."
                  },
                  "modes": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Several strategies run together, each shaped like the [Auto buy mode](#object-auto-buy-mode) object. The web app sends this form."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "time": {
                        "type": "integer",
                        "description": "Session duration in seconds; `0` uses the maximum of 30 days."
                      },
                      "amount": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "string"
                          }
                        ],
                        "description": "Quote the session may spend, raw units. `0` means no limit."
                      }
                    },
                    "required": [
                      "time",
                      "amount"
                    ],
                    "description": "Session-wide limits."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points, at most 10000. Defaults to 500 on Solana."
                  },
                  "min_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored: neither chain applies a session-wide lower bound, although the web app sends it when set. Set `min_mcap` on each layer instead."
                  },
                  "max_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored, like `min_mcap`. Set `max_mcap` on each layer instead."
                  },
                  "start_delay": {
                    "type": "integer",
                    "description": "Seconds to wait before the first trade, at most 30 days."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade. Omit or send `null` for all of them; an empty array is rejected."
                  }
                },
                "required": [
                  "end_condition"
                ]
              },
              "example": {
                "modes": [
                  {
                    "SwapBack": {
                      "whitelist": [],
                      "layers": [
                        {
                          "replication_factor": 5000,
                          "trigger_condition": {
                            "type": "MinSol",
                            "value": 100000000
                          },
                          "min_sol_per_swap": "10000000",
                          "min_mcap": 0,
                          "max_mcap": 250000000000
                        }
                      ]
                    }
                  },
                  {
                    "McapLadder": [
                      {
                        "target_mcap": 80000000000,
                        "buy_amount": "500000000"
                      },
                      {
                        "target_mcap": 60000000000,
                        "buy_amount": "1000000000"
                      }
                    ]
                  }
                ],
                "end_condition": {
                  "time": 86400,
                  "amount": "5000000000"
                },
                "slippage": 500,
                "wallet_pubkeys": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto buy params updated"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a valid address. Send the base58 addresses of the launch's wallets.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be decreasing mcap)` or `Slippage must be <= 10000 bps`. Fix the parameter named in `message` within the limits listed on [Auto buy mode](/reference/auto-buy/#object-auto-buy-mode).\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a wallet that can trade this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: EVM: none of `wallet_pubkeys` is a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: EVM: `wallet_pubkeys` is an empty array. Omit `wallet_pubkeys` to keep the current wallets.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey in wallet_pubkeys"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be decreasing mcap)` or `Slippage must be <= 10000 bps`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No buying mode provided"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a wallet that can trade this launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys contains wallets that cannot trade this launch"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: none of `wallet_pubkeys` is a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys provided but none matched launch wallets"
                    }
                  },
                  "bad_request_7": {
                    "summary": "EVM: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No wallets available for autobuy"
                    }
                  },
                  "bad_request_8": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) and start a new one with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`not_found`: EVM: the launch has no session to update. Start a session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy) or plan one with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy).\n\n`not_found`: EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) and start a new one with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`not_found`: The launch trades on the pace engine and pace no longer runs a session for it. Start a new session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`not_found`: The launch trades on the pace engine and pace no longer holds the session. Start a new session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No MM engine running for this launch"
                    }
                  },
                  "not_found_3": {
                    "summary": "EVM: the launch has no session to update.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autobuy session found"
                    }
                  },
                  "not_found_4": {
                    "summary": "EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No engine running for this launch"
                    }
                  },
                  "not_found_5": {
                    "summary": "The launch trades on the pace engine and pace no longer runs a session for it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer trades this launch"
                    }
                  },
                  "not_found_6": {
                    "summary": "The launch trades on the pace engine and pace no longer holds the session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer holds this session"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The session is not `Planned`, `Running` or `Paused`. Start a session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy) or plan one with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy).\n\n`conflict`: The launch trades on the pace engine and pace already moved the session to another state. Read [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status) for the current state before acting again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The session is not `Planned`, `Running` or `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autobuy session is not running or planned"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch trades on the pace engine and pace already moved the session to another state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already moved this session"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at. Change the rule named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a MinSol trigger is only valid when the launch's quote is native"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch has no session to update. Start a session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy) or plan one with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch has no session to update.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autobuy session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Layers are matched by ID and keep their progress, so sending the same parameters again changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#update-auto-buy"
        }
      }
    },
    "/launch/autobuy/status/{launch_id}": {
      "get": {
        "operationId": "auto-buy.get-auto-buy-status",
        "summary": "Retrieve Auto Buy status",
        "description": "Returns the launch's Auto Buy session, its totals and per-layer progress.\n\nThe web client normalizes this payload (`normalizeAutoBuyStatus`): lowercase statuses become PascalCase, EVM totals are mapped onto the `auto_buy_*` names, `engine` layers become `modes`, and amounts are parsed to numbers.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns an Auto buy status object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "None",
                        "Planned",
                        "Running",
                        "Paused",
                        "Completed",
                        "Cancelled",
                        "Failed"
                      ],
                      "description": "Session state."
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "params": {
                          "type": "object",
                          "description": "The session parameters as stored: the body of the last plan, run or update call."
                        },
                        "started_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session started."
                        },
                        "ended_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session ended."
                        },
                        "status_reason": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Why the session ended or failed, when known."
                        },
                        "auto_buy_native_spent": {
                          "type": "integer",
                          "description": "Solana: amount spent by the session, raw units."
                        },
                        "auto_buy_usd_spent": {
                          "type": "integer",
                          "description": "Solana: USD spent, micro-USD."
                        },
                        "auto_buy_token_bought": {
                          "type": "integer",
                          "description": "Solana: tokens bought, raw units."
                        },
                        "modes": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "enum": [
                                  "replication",
                                  "timed",
                                  "mcap_ladder"
                                ],
                                "description": "Mode."
                              },
                              "accumulated": {
                                "type": "integer",
                                "description": "Replication only: amount accumulated toward the next trade, summed over layers."
                              },
                              "layers": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "description": "Layer ID: `ab_4217_l0` for timed and replication layers, `ab_4217_0` for market-cap ladder steps. Pass it as `layer_id` to cancel, pause or resume one layer."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "Active",
                                        "Paused",
                                        "Exhausted"
                                      ],
                                      "description": "Layer state. The client also accepts lowercase values."
                                    },
                                    "token_sold": {
                                      "type": "integer",
                                      "description": "Tokens this layer has bought, raw units. The field keeps this name on both sides."
                                    },
                                    "sol_spent": {
                                      "type": "integer",
                                      "description": "Native or quote amount this layer has traded, raw units."
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "state",
                                    "token_sold",
                                    "sol_spent"
                                  ]
                                },
                                "description": "Progress per layer."
                              }
                            },
                            "required": [
                              "id",
                              "layers"
                            ]
                          },
                          "description": "Solana: progress per mode."
                        },
                        "token_bought": {
                          "type": "string",
                          "description": "EVM: tokens bought, raw units, as a decimal string."
                        },
                        "native_spent": {
                          "type": "string",
                          "description": "EVM: native spent, wei, as a decimal string."
                        },
                        "usd_spent": {
                          "type": "integer",
                          "description": "EVM: USD spent, micro-USD."
                        },
                        "engine": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "cached_mcap_usd": {
                                  "type": "number",
                                  "description": "Market cap the engine last read, USD."
                                },
                                "swapback_layers": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "Layer ID."
                                      },
                                      "state": {
                                        "type": "string",
                                        "description": "Layer state."
                                      },
                                      "accumulated": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Amount accumulated toward the next trade."
                                      },
                                      "native_spent": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Native spent by the layer, wei."
                                      },
                                      "token_bought": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Tokens bought by the layer, raw units."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "state"
                                    ]
                                  },
                                  "description": "Replication layers."
                                },
                                "timed_layers": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "Layer ID."
                                      },
                                      "state": {
                                        "type": "string",
                                        "description": "Layer state."
                                      },
                                      "accumulated": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Amount accumulated toward the next trade."
                                      },
                                      "native_spent": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Native spent by the layer, wei."
                                      },
                                      "token_bought": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Tokens bought by the layer, raw units."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "state"
                                    ]
                                  },
                                  "description": "Timed layers."
                                },
                                "mcap_levels": {
                                  "type": "array",
                                  "items": {
                                    "type": "object"
                                  },
                                  "description": "Ladder steps: the layer fields plus `target_mcap_usd` and `buy_amount`."
                                }
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "EVM: live engine snapshot."
                        }
                      },
                      "required": [
                        "params",
                        "started_at",
                        "ended_at",
                        "status_reason"
                      ],
                      "description": "Session details. Absent when `status` is `None`."
                    }
                  },
                  "required": [
                    "status"
                  ]
                },
                "example": {
                  "status": "Running",
                  "info": {
                    "params": {
                      "modes": [
                        {
                          "SwapBack": {
                            "whitelist": [],
                            "layers": [
                              {
                                "replication_factor": 5000,
                                "trigger_condition": {
                                  "type": "MinSol",
                                  "value": 100000000
                                },
                                "min_sol_per_swap": "10000000",
                                "min_mcap": 0,
                                "max_mcap": 250000000000
                              }
                            ]
                          }
                        },
                        {
                          "McapLadder": [
                            {
                              "target_mcap": 80000000000,
                              "buy_amount": "500000000"
                            },
                            {
                              "target_mcap": 60000000000,
                              "buy_amount": "1000000000"
                            }
                          ]
                        }
                      ],
                      "end_condition": {
                        "time": 86400,
                        "amount": "5000000000"
                      },
                      "slippage": 500,
                      "wallet_pubkeys": [
                        "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                        "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                      ]
                    },
                    "started_at": 1793655010,
                    "ended_at": null,
                    "status_reason": null,
                    "auto_buy_native_spent": 1240000000,
                    "auto_buy_usd_spent": 232480000,
                    "auto_buy_token_bought": 6150000000000,
                    "modes": [
                      {
                        "id": "replication",
                        "accumulated": 4200000,
                        "layers": [
                          {
                            "id": "ab_4217_l0",
                            "state": "Active",
                            "token_sold": 3900000000000,
                            "sol_spent": 740000000
                          }
                        ]
                      },
                      {
                        "id": "mcap_ladder",
                        "layers": [
                          {
                            "id": "ab_4217_0",
                            "state": "Exhausted",
                            "token_sold": 2250000000000,
                            "sol_spent": 500000000
                          },
                          {
                            "id": "ab_4217_1",
                            "state": "Active",
                            "token_sold": 0,
                            "sol_spent": 0
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#get-auto-buy-status"
        }
      }
    },
    "/launch/autobuy/cancel/{launch_id}": {
      "post": {
        "operationId": "auto-buy.cancel-auto-buy",
        "summary": "Cancel an Auto Buy session",
        "description": "Cancels the whole Auto Buy session, one mode, or one layer.\n\nSend `layer_id` or `mode` to cancel part of the session; send no body to cancel all of it.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "layer_id": {
                    "type": "string",
                    "description": "Target one layer, e.g. `ab_4217_l0` (from `modes[].layers[].id` in the status)."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "replication",
                      "timed",
                      "mcap_ladder"
                    ],
                    "description": "Target every layer of one mode."
                  }
                }
              },
              "example": {
                "mode": "timed"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message` (`Layer cancelled` when one layer was targeted).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto buy task successfully cancelled"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `layer_id` lacks the prefix of this launch's Auto Buy layer IDs. EVM accepts any value and changes nothing. Pass a layer `id` from `modes[].layers[]` in [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status).\n\n`bad_request`: Solana: `mode` is not `replication`, `timed` or `mcap_ladder`, checked only while the engine runs. EVM accepts any value and changes nothing. Send `replication`, `timed` or `mcap_ladder`.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `layer_id` lacks the prefix of this launch's Auto Buy layer IDs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid layer_id for this launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: `mode` is not `replication`, `timed` or `mcap_ladder`, checked only while the engine runs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mode: must be replication, timed, or mcap_ladder"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: EVM: `layer_id` or `mode` was sent and the launch has no Auto Buy session. Send no body to clear the session state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "EVM: `layer_id` or `mode` was sent and the launch has no Auto Buy session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autobuy session found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: `layer_id` or `mode` was sent and the session is not `Running`. A cancel with no body works in any state. Send no body to cancel the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "`layer_id` or `mode` was sent and the session is not `Running`. A cancel with no body works in any state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autobuy session is not running"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch trades on the pace engine, which cancels whole sessions only, and `layer_id` or `mode` was sent. Send no `layer_id` or `mode` to cancel the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch trades on the pace engine, which cancels whole sessions only, and `layer_id` or `mode` was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a launch on pace cancels whole sessions, not layers"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: `layer_id` or `mode` was sent and the launch has no Auto Buy session. Send no body to clear the session state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: `layer_id` or `mode` was sent and the launch has no Auto Buy session.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autobuy session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A cancel with no body answers `200` in any state, so repeating it changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#cancel-auto-buy"
        }
      }
    },
    "/launch/autobuy/pause/{launch_id}": {
      "post": {
        "operationId": "auto-buy.pause-auto-buy",
        "summary": "Pause an Auto Buy session",
        "description": "Pauses the whole Auto Buy session, one mode, or one layer.\n\nSend `layer_id` or `mode` to pause part of the session; the client sends `{}` to pause all of it.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "layer_id": {
                    "type": "string",
                    "description": "Target one layer, e.g. `ab_4217_l0` (from `modes[].layers[].id` in the status)."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "replication",
                      "timed",
                      "mcap_ladder"
                    ],
                    "description": "Target every layer of one mode."
                  }
                }
              },
              "example": {
                "mode": "timed"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message` (`Layer paused` when one layer was targeted).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto buy paused"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `layer_id` lacks the prefix of this launch's Auto Buy layer IDs. EVM accepts any value and changes nothing. Pass a layer `id` from `modes[].layers[]` in [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status).\n\n`bad_request`: Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing. Send `replication`, `timed` or `mcap_ladder`.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `layer_id` lacks the prefix of this launch's Auto Buy layer IDs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid layer_id for this launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mode: must be replication, timed, or mcap_ladder"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) and start a new one with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`not_found`: EVM: the launch has no session to pause. Start a session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy) or plan one with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy).\n\n`not_found`: EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) and start a new one with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`not_found`: The launch trades on the pace engine and pace no longer holds the session. Start a new session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No MM engine running for this launch"
                    }
                  },
                  "not_found_3": {
                    "summary": "EVM: the launch has no session to pause.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autobuy session found"
                    }
                  },
                  "not_found_4": {
                    "summary": "EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No engine running for this launch"
                    }
                  },
                  "not_found_5": {
                    "summary": "The launch trades on the pace engine and pace no longer holds the session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer holds this session"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The session is not `Running`, for example because it is already `Paused`. Read [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status), and resume a paused session with [Resume an Auto Buy session](/reference/auto-buy/#resume-auto-buy).\n\n`conflict`: The launch trades on the pace engine and pace already moved the session to another state. Read [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status) for the current state before acting again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The session is not `Running`, for example because it is already `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autobuy session is not running"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch trades on the pace engine and pace already moved the session to another state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already moved this session"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch trades on the pace engine, which pauses whole sessions only, and `layer_id` or `mode` was sent. Send no `layer_id` or `mode` to pause the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch trades on the pace engine, which pauses whole sessions only, and `layer_id` or `mode` was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a launch on pace pauses whole sessions, not layers"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch has no session to pause. Start a session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy) or plan one with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch has no session to pause.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autobuy session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Once the session is `Paused`, a repeat answers `409` and changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#pause-auto-buy"
        }
      }
    },
    "/launch/autobuy/resume/{launch_id}": {
      "post": {
        "operationId": "auto-buy.resume-auto-buy",
        "summary": "Resume an Auto Buy session",
        "description": "Resumes a paused Auto Buy session, mode, or layer.\n\nSend `layer_id` or `mode` to resume part of the session; the client sends `{}` to resume all of it.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "layer_id": {
                    "type": "string",
                    "description": "Target one layer, e.g. `ab_4217_l0` (from `modes[].layers[].id` in the status)."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "replication",
                      "timed",
                      "mcap_ladder"
                    ],
                    "description": "Target every layer of one mode."
                  }
                }
              },
              "example": {
                "layer_id": "ab_4217_l0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message` (`Layer resumed` when one layer was targeted).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto buy resumed"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `layer_id` lacks the prefix of this launch's Auto Buy layer IDs. EVM accepts any value and changes nothing. Pass a layer `id` from `modes[].layers[]` in [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status).\n\n`bad_request`: Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing. Send `replication`, `timed` or `mcap_ladder`.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `layer_id` lacks the prefix of this launch's Auto Buy layer IDs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid layer_id for this launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mode: must be replication, timed, or mcap_ladder"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) and start a new one with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`not_found`: EVM: the launch has no session to resume. Start a session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy) or plan one with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy).\n\n`not_found`: EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) and start a new one with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`not_found`: The launch trades on the pace engine and pace no longer holds the session. Start a new session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No MM engine running for this launch"
                    }
                  },
                  "not_found_3": {
                    "summary": "EVM: the launch has no session to resume.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autobuy session found"
                    }
                  },
                  "not_found_4": {
                    "summary": "EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No engine running for this launch"
                    }
                  },
                  "not_found_5": {
                    "summary": "The launch trades on the pace engine and pace no longer holds the session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer holds this session"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: the session is neither `Paused` nor `Running`. Start a new session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`conflict`: EVM: the session is neither `Paused` nor `Running`. Start a new session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy).\n\n`conflict`: The launch trades on the pace engine and pace already moved the session to another state. Read [Retrieve Auto Buy status](/reference/auto-buy/#get-auto-buy-status) for the current state before acting again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: the session is neither `Paused` nor `Running`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autobuy session is not paused"
                    }
                  },
                  "conflict_2": {
                    "summary": "EVM: the session is neither `Paused` nor `Running`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autobuy session is not running or paused"
                    }
                  },
                  "conflict_3": {
                    "summary": "The launch trades on the pace engine and pace already moved the session to another state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already moved this session"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch trades on the pace engine, which resumes whole sessions only, and `layer_id` or `mode` was sent. Send no `layer_id` or `mode` to resume the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch trades on the pace engine, which resumes whole sessions only, and `layer_id` or `mode` was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a launch on pace resumes whole sessions, not layers"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch has no session to resume. Start a session with [Start an Auto Buy session](/reference/auto-buy/#run-auto-buy) or plan one with [Plan an Auto Buy session](/reference/auto-buy/#plan-auto-buy).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch has no session to resume.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autobuy session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Resuming a session that already runs answers `200` and changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#resume-auto-buy"
        }
      }
    },
    "/launch/autobuy/discard/{launch_id}": {
      "post": {
        "operationId": "auto-buy.discard-auto-buy",
        "summary": "Discard an Auto Buy session",
        "description": "Clears a planned or finished Auto Buy session from the launch.",
        "tags": [
          "Auto Buy"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully discarded auto buy session status"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: the session is `Running` or `Paused`. EVM answers `200` and keeps the live session. Stop the session with [Cancel an Auto Buy session](/reference/auto-buy/#cancel-auto-buy) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: the session is `Running` or `Paused`. EVM answers `200` and keeps the live session.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot discard running session"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Once the session state is cleared, a repeat answers `200` and changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-buy/#discard-auto-buy"
        }
      }
    },
    "/launch/autosell/plan/{launch_id}": {
      "post": {
        "operationId": "auto-sell.plan-auto-sell",
        "summary": "Plan an Auto Sell session",
        "description": "Saves an Auto Sell session as `Planned` so that it starts with the launch.\n\nReplaces a previously planned session. Refused while a session is running or paused. Sell ladder targets must be strictly increasing, and layer market-cap ranges must not overlap.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "object",
                    "description": "A single strategy, shaped like the [Auto sell mode](#object-auto-sell-mode) object. Send `mode` or `modes`."
                  },
                  "modes": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Several strategies run together, each shaped like the [Auto sell mode](#object-auto-sell-mode) object. The web app sends this form."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "time": {
                        "type": "integer",
                        "description": "Session duration in seconds; `0` uses the maximum of 30 days."
                      },
                      "amount": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "string"
                          }
                        ],
                        "description": "Tokens the session may sell, raw units. `0` means no limit."
                      }
                    },
                    "required": [
                      "time",
                      "amount"
                    ],
                    "description": "Session-wide limits."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points, at most 10000. Defaults to 10000 on Solana."
                  },
                  "min_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored: neither chain applies a session-wide lower bound, although the web app sends it when set. Set `min_mcap` on each layer instead."
                  },
                  "max_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored, like `min_mcap`. Set `max_mcap` on each layer instead."
                  },
                  "start_delay": {
                    "type": "integer",
                    "description": "Seconds to wait before the first trade, at most 30 days."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade. Omit or send `null` for all of them; an empty array is rejected."
                  }
                },
                "required": [
                  "end_condition"
                ]
              },
              "example": {
                "modes": [
                  {
                    "TimedExactIn": {
                      "layers": [
                        {
                          "min_amount": "1500000000000",
                          "max_amount": "4000000000000",
                          "delay": 45000,
                          "min_mcap": 120000000000,
                          "end_condition": {
                            "amount": "60000000000000",
                            "time": 21600
                          }
                        }
                      ]
                    }
                  },
                  {
                    "McapLadder": [
                      {
                        "target_mcap": 150000000000,
                        "sell_amount": "20000000000000"
                      },
                      {
                        "target_mcap": 300000000000,
                        "sell_amount": "40000000000000"
                      }
                    ]
                  }
                ],
                "end_condition": {
                  "time": 0,
                  "amount": "0"
                },
                "slippage": 1500,
                "start_delay": 300,
                "wallet_pubkeys": null
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully planned auto selling task"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `wallet_pubkeys` is an empty array. Omit `wallet_pubkeys` to trade from every launch wallet.\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a valid address. Send the base58 addresses of the launch's wallets.\n\n`bad_request`: `launch_id` is a multi-launch group container whose plan is no longer a draft. Plan the session on the winning member launch instead.\n\n`bad_request`: EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys cannot be empty"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container whose plan is no longer a draft.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "launch group plan can only be edited while draft"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No funder wallet configured"
                    }
                  },
                  "bad_request_6": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: an entry of `wallet_pubkeys` is not a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet not found in launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: A session for this launch is `Running` or `Paused`. Change the live session with [Update an Auto Sell session](/reference/auto-sell/#update-auto-sell), or cancel it with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) before planning again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "A session for this launch is `Running` or `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Task already running"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: No wallet is left to trade: the launch has no wallets, or (EVM) `wallet_pubkeys` is empty or names none of them. Omit `wallet_pubkeys` to use every launch wallet, or add wallets with [Add wallets to a launch](/reference/launches/#add-launch-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "No wallet is left to trade: the launch has no wallets, or (EVM) `wallet_pubkeys` is empty or names none of them.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No wallets available"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be ascending mcap)` or `Slippage must be <= 10000 bps`. On a multi-launch container the same messages come back as `400 bad_request`. Fix the parameter named in `message` within the limits listed on [Auto sell mode](/reference/auto-sell/#object-auto-sell-mode).\n\n`internal_error`: Solana: the launch has no funder, holder or MEV wallets saved yet. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be ascending mcap)` or `Slippage must be <= 10000 bps`. On a multi-launch container the same messages come back as `400 bad_request`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No selling mode provided"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: the launch has no funder, holder or MEV wallets saved yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch data saved"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Planning again overwrites the parameters of the `Planned` session. Once the session runs, a repeat answers `409`."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#plan-auto-sell"
        }
      }
    },
    "/launch/autosell/run/{launch_id}": {
      "post": {
        "operationId": "auto-sell.run-auto-sell",
        "summary": "Start an Auto Sell session",
        "description": "Starts an Auto Sell session right away on a launched token.\n\nRefused while a session is running or paused. If a session is `Planned` for the launch, it starts with the planned parameters and the body is ignored.\n\nTrades from the launch wallets until the session ends, is paused or is cancelled.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "object",
                    "description": "A single strategy, shaped like the [Auto sell mode](#object-auto-sell-mode) object. Send `mode` or `modes`."
                  },
                  "modes": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Several strategies run together, each shaped like the [Auto sell mode](#object-auto-sell-mode) object. The web app sends this form."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "time": {
                        "type": "integer",
                        "description": "Session duration in seconds; `0` uses the maximum of 30 days."
                      },
                      "amount": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "string"
                          }
                        ],
                        "description": "Tokens the session may sell, raw units. `0` means no limit."
                      }
                    },
                    "required": [
                      "time",
                      "amount"
                    ],
                    "description": "Session-wide limits."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points, at most 10000. Defaults to 10000 on Solana."
                  },
                  "min_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored: neither chain applies a session-wide lower bound, although the web app sends it when set. Set `min_mcap` on each layer instead."
                  },
                  "max_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored, like `min_mcap`. Set `max_mcap` on each layer instead."
                  },
                  "start_delay": {
                    "type": "integer",
                    "description": "Seconds to wait before the first trade, at most 30 days."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade. Omit or send `null` for all of them; an empty array is rejected."
                  }
                },
                "required": [
                  "end_condition"
                ]
              },
              "example": {
                "modes": [
                  {
                    "TimedExactIn": {
                      "layers": [
                        {
                          "min_amount": "1500000000000",
                          "max_amount": "4000000000000",
                          "delay": 45000,
                          "min_mcap": 120000000000,
                          "end_condition": {
                            "amount": "60000000000000",
                            "time": 21600
                          }
                        }
                      ]
                    }
                  },
                  {
                    "McapLadder": [
                      {
                        "target_mcap": 150000000000,
                        "sell_amount": "20000000000000"
                      },
                      {
                        "target_mcap": 300000000000,
                        "sell_amount": "40000000000000"
                      }
                    ]
                  }
                ],
                "end_condition": {
                  "time": 0,
                  "amount": "0"
                },
                "slippage": 1500,
                "start_delay": 300,
                "wallet_pubkeys": null
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully started auto selling task"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `wallet_pubkeys` is an empty array. Omit `wallet_pubkeys` to trade from every launch wallet.\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a valid address. Send the base58 addresses of the launch's wallets.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: EVM: the launch is still a draft. Imported tokens are accepted. Launch the token with [Launch a token](/reference/launch-execution/#launch) first, or save the session with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell) so it starts with the launch.\n\n`bad_request`: EVM: no wallet can trade, because `wallet_pubkeys` is an empty array or the launch holds no wallets. Omit `wallet_pubkeys` to trade from every launch wallet.\n\n`bad_request`: EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys cannot be empty"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: not available here; use the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the launch is still a draft. Imported tokens are accepted.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: no wallet can trade, because `wallet_pubkeys` is an empty array or the launch holds no wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No wallets available for autosell"
                    }
                  },
                  "bad_request_7": {
                    "summary": "EVM: the launch plan is incomplete; `message` names the missing part, e.g. `No launch method saved`, `No mev wallets saved`, `No holder wallets saved` or `No holder amounts saved`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No funder wallet configured"
                    }
                  },
                  "bad_request_8": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: an entry of `wallet_pubkeys` is not a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet not found in launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: A session for this launch is already `Running` or `Paused`. Change the running session with [Update an Auto Sell session](/reference/auto-sell/#update-auto-sell) instead of starting another.\n\n`conflict`: The launch trades on the pace engine, which already runs an Auto Sell session for it. Change that session with [Update an Auto Sell session](/reference/auto-sell/#update-auto-sell) or cancel it with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "A session for this launch is already `Running` or `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Task already running"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch trades on the pace engine, which already runs an Auto Sell session for it.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already trades this launch in this direction"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`venue_ungated`: EVM: replication layers or market-cap bounds need a known pool for the token and none is recorded; `message` names what is missing. Use timed layers without market-cap bounds, or retry once the pool is recorded.\n\n`unprocessable`: The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at. Change the rule named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "venue_ungated": {
                    "summary": "EVM: replication layers or market-cap bounds need a known pool for the token and none is recorded; `message` names what is missing.",
                    "value": {
                      "ok": false,
                      "code": "venue_ungated",
                      "message": "the launchpad holds no record of this token"
                    }
                  },
                  "unprocessable": {
                    "summary": "The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a MinSol trigger is only valid when the launch's quote is native"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch is still a draft. Launch the token with [Launch a token](/reference/launch-execution/#launch) first, or save the session with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell) so it starts with the launch.\n\n`internal_error`: EVM: none of `wallet_pubkeys` is a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`internal_error`: The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be ascending mcap)` or `Slippage must be <= 10000 bps`. When a session is `Planned`, its saved parameters are checked instead of the body. Fix the parameter named in `message` within the limits listed on [Auto sell mode](/reference/auto-sell/#object-auto-sell-mode).\n\n`internal_error`: Solana: the launch has no funder, holder or MEV wallets saved yet. Finish the plan with [Update the launch plan](/reference/launches/#update-launch-plan) and [Set the launch funder](/reference/launches/#set-launch-funder), then retry.\n\n`internal_error`: Solana: the price of the launch's quote token is not known yet, so the engine cannot start. Send the request again in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch is still a draft.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "EVM: none of `wallet_pubkeys` is a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "wallet_pubkeys provided but none matched launch wallets"
                    }
                  },
                  "internal_error_3": {
                    "summary": "The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be ascending mcap)` or `Slippage must be <= 10000 bps`. When a session is `Planned`, its saved parameters are checked instead of the body.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No selling mode provided"
                    }
                  },
                  "internal_error_4": {
                    "summary": "Solana: the launch has no funder, holder or MEV wallets saved yet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No launch data saved"
                    }
                  },
                  "internal_error_5": {
                    "summary": "Solana: the price of the launch's quote token is not known yet, so the engine cannot start.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "the launch quote carries no price"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status) first: `Running` or `Paused` means the first call went through, and a repeat answers `409` while the session lasts."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#run-auto-sell"
        }
      }
    },
    "/launch/autosell/update/{launch_id}": {
      "post": {
        "operationId": "auto-sell.update-auto-sell",
        "summary": "Update an Auto Sell session",
        "description": "Replaces the parameters of a planned, running or paused Auto Sell session.\n\nOn a live session, layers whose IDs survive the update keep their progress.\n\nOn Solana the response also carries `wallet_set_unchanged` and `wallets_added`, which the web app does not read. EVM answers with `ok` and `message` only.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "object",
                    "description": "A single strategy, shaped like the [Auto sell mode](#object-auto-sell-mode) object. Send `mode` or `modes`."
                  },
                  "modes": {
                    "type": "array",
                    "items": {
                      "type": "object"
                    },
                    "description": "Several strategies run together, each shaped like the [Auto sell mode](#object-auto-sell-mode) object. The web app sends this form."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "time": {
                        "type": "integer",
                        "description": "Session duration in seconds; `0` uses the maximum of 30 days."
                      },
                      "amount": {
                        "anyOf": [
                          {
                            "type": "integer"
                          },
                          {
                            "type": "string"
                          }
                        ],
                        "description": "Tokens the session may sell, raw units. `0` means no limit."
                      }
                    },
                    "required": [
                      "time",
                      "amount"
                    ],
                    "description": "Session-wide limits."
                  },
                  "slippage": {
                    "type": "integer",
                    "description": "Slippage tolerance in basis points, at most 10000. Defaults to 10000 on Solana."
                  },
                  "min_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored: neither chain applies a session-wide lower bound, although the web app sends it when set. Set `min_mcap` on each layer instead."
                  },
                  "max_mcap": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Ignored, like `min_mcap`. Set `max_mcap` on each layer instead."
                  },
                  "start_delay": {
                    "type": "integer",
                    "description": "Seconds to wait before the first trade, at most 30 days."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade. Omit or send `null` for all of them; an empty array is rejected."
                  }
                },
                "required": [
                  "end_condition"
                ]
              },
              "example": {
                "modes": [
                  {
                    "TimedExactIn": {
                      "layers": [
                        {
                          "min_amount": "1500000000000",
                          "max_amount": "4000000000000",
                          "delay": 45000,
                          "min_mcap": 120000000000,
                          "end_condition": {
                            "amount": "60000000000000",
                            "time": 21600
                          }
                        }
                      ]
                    }
                  },
                  {
                    "McapLadder": [
                      {
                        "target_mcap": 150000000000,
                        "sell_amount": "20000000000000"
                      },
                      {
                        "target_mcap": 300000000000,
                        "sell_amount": "40000000000000"
                      }
                    ]
                  }
                ],
                "end_condition": {
                  "time": 0,
                  "amount": "0"
                },
                "slippage": 1500,
                "start_delay": 300,
                "wallet_pubkeys": null
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto sell params updated"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a valid address. Send the base58 addresses of the launch's wallets.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be ascending mcap)` or `Slippage must be <= 10000 bps`. Fix the parameter named in `message` within the limits listed on [Auto sell mode](/reference/auto-sell/#object-auto-sell-mode).\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a wallet that can trade this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: EVM: none of `wallet_pubkeys` is a wallet of this launch. Send only addresses of the launch's own wallets, as listed by [Retrieve a launch](/reference/launches/#retrieve-launch).\n\n`bad_request`: EVM: `wallet_pubkeys` is an empty array. Omit `wallet_pubkeys` to keep the current wallets.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey in wallet_pubkeys"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_4": {
                    "summary": "The parameters fail validation; `message` names the rule, e.g. `Invalid delay`, `Too many timed layers`, `Swapback layer mcap ranges must not overlap`, `Invalid levels array (must be ascending mcap)` or `Slippage must be <= 10000 bps`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No selling mode provided"
                    }
                  },
                  "bad_request_5": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a wallet that can trade this launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys contains wallets that cannot trade this launch"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: none of `wallet_pubkeys` is a wallet of this launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys provided but none matched launch wallets"
                    }
                  },
                  "bad_request_7": {
                    "summary": "EVM: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No wallets available for autosell"
                    }
                  },
                  "bad_request_8": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) and start a new one with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`not_found`: EVM: the launch has no session to update. Start a session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell) or plan one with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell).\n\n`not_found`: EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) and start a new one with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`not_found`: The launch trades on the pace engine and pace no longer runs a session for it. Start a new session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`not_found`: The launch trades on the pace engine and pace no longer holds the session. Start a new session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No MM engine running for this launch"
                    }
                  },
                  "not_found_3": {
                    "summary": "EVM: the launch has no session to update.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autosell session found"
                    }
                  },
                  "not_found_4": {
                    "summary": "EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No engine running for this launch"
                    }
                  },
                  "not_found_5": {
                    "summary": "The launch trades on the pace engine and pace no longer runs a session for it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer trades this launch"
                    }
                  },
                  "not_found_6": {
                    "summary": "The launch trades on the pace engine and pace no longer holds the session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer holds this session"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The session is not `Planned`, `Running` or `Paused`. Start a session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell) or plan one with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell).\n\n`conflict`: The launch trades on the pace engine and pace already moved the session to another state. Read [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status) for the current state before acting again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The session is not `Planned`, `Running` or `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autosell session is not running or planned"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch trades on the pace engine and pace already moved the session to another state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already moved this session"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at. Change the rule named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch's platform trades on the pace engine and a rule has no pace equivalent; `message` names it, e.g. a `Rate` trigger, a `MinSol` trigger on a non-native quote, or a replication layer with no amount to stop at.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a MinSol trigger is only valid when the launch's quote is native"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch has no session to update. Start a session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell) or plan one with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch has no session to update.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autosell session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Layers are matched by ID and keep their progress, so sending the same parameters again changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#update-auto-sell"
        }
      }
    },
    "/launch/autosell/status/{launch_id}": {
      "get": {
        "operationId": "auto-sell.get-auto-sell-status",
        "summary": "Retrieve Auto Sell status",
        "description": "Returns the launch's Auto Sell session, its totals and per-layer progress.\n\nThe web client normalizes this payload (`normalizeAutoSellStatus`): lowercase statuses become PascalCase, EVM totals are mapped onto the `auto_sell_*` names, `engine` layers become `modes`, and amounts are parsed to numbers.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns an Auto sell status object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "None",
                        "Planned",
                        "Running",
                        "Paused",
                        "Completed",
                        "Cancelled",
                        "Failed"
                      ],
                      "description": "Session state."
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "params": {
                          "type": "object",
                          "description": "The session parameters as stored: the body of the last plan, run or update call."
                        },
                        "started_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session started."
                        },
                        "ended_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session ended."
                        },
                        "status_reason": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Why the session ended or failed, when known."
                        },
                        "auto_sell_native_profit": {
                          "type": "integer",
                          "description": "Solana: native received by the session, raw units. Can be negative."
                        },
                        "auto_sell_usd_profit": {
                          "type": "integer",
                          "description": "Solana: USD received, micro-USD. Can be negative."
                        },
                        "auto_sell_token_sold": {
                          "type": "integer",
                          "description": "Solana: tokens sold, raw units."
                        },
                        "modes": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "enum": [
                                  "replication",
                                  "timed",
                                  "mcap_ladder"
                                ],
                                "description": "Mode."
                              },
                              "accumulated": {
                                "type": "integer",
                                "description": "Replication only: amount accumulated toward the next trade, summed over layers."
                              },
                              "layers": {
                                "type": "array",
                                "items": {
                                  "type": "object",
                                  "properties": {
                                    "id": {
                                      "type": "string",
                                      "description": "Layer ID: `as_4217_l0` for timed and replication layers, `as_4217_0` for market-cap ladder steps. Pass it as `layer_id` to cancel, pause or resume one layer."
                                    },
                                    "state": {
                                      "type": "string",
                                      "enum": [
                                        "Active",
                                        "Paused",
                                        "Exhausted"
                                      ],
                                      "description": "Layer state. The client also accepts lowercase values."
                                    },
                                    "token_sold": {
                                      "type": "integer",
                                      "description": "Tokens this layer has sold, raw units. The field keeps this name on both sides."
                                    },
                                    "sol_spent": {
                                      "type": "integer",
                                      "description": "Native or quote amount this layer has traded, raw units."
                                    }
                                  },
                                  "required": [
                                    "id",
                                    "state",
                                    "token_sold",
                                    "sol_spent"
                                  ]
                                },
                                "description": "Progress per layer."
                              }
                            },
                            "required": [
                              "id",
                              "layers"
                            ]
                          },
                          "description": "Solana: progress per mode."
                        },
                        "token_sold": {
                          "type": "string",
                          "description": "EVM: tokens sold, raw units, as a decimal string."
                        },
                        "native_profit": {
                          "type": "string",
                          "description": "EVM: native received, wei, as a decimal string."
                        },
                        "usd_profit": {
                          "type": "integer",
                          "description": "EVM: USD received, micro-USD."
                        },
                        "engine": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "cached_mcap_usd": {
                                  "type": "number",
                                  "description": "Market cap the engine last read, USD."
                                },
                                "swapback_layers": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "Layer ID."
                                      },
                                      "state": {
                                        "type": "string",
                                        "description": "Layer state."
                                      },
                                      "accumulated": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Amount accumulated toward the next trade."
                                      },
                                      "token_sold": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Tokens sold by the layer, raw units."
                                      },
                                      "native_profit": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Native received by the layer, wei."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "state"
                                    ]
                                  },
                                  "description": "Replication layers."
                                },
                                "timed_layers": {
                                  "type": "array",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "description": "Layer ID."
                                      },
                                      "state": {
                                        "type": "string",
                                        "description": "Layer state."
                                      },
                                      "accumulated": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Amount accumulated toward the next trade."
                                      },
                                      "token_sold": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Tokens sold by the layer, raw units."
                                      },
                                      "native_profit": {
                                        "anyOf": [
                                          {
                                            "type": "integer"
                                          },
                                          {
                                            "type": "string"
                                          }
                                        ],
                                        "description": "Native received by the layer, wei."
                                      }
                                    },
                                    "required": [
                                      "id",
                                      "state"
                                    ]
                                  },
                                  "description": "Timed layers."
                                },
                                "mcap_levels": {
                                  "type": "array",
                                  "items": {
                                    "type": "object"
                                  },
                                  "description": "Ladder steps: the layer fields plus `target_mcap_usd` and `sell_amount`."
                                }
                              }
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "EVM: live engine snapshot."
                        }
                      },
                      "required": [
                        "params",
                        "started_at",
                        "ended_at",
                        "status_reason"
                      ],
                      "description": "Session details. Absent when `status` is `None`."
                    }
                  },
                  "required": [
                    "status"
                  ]
                },
                "example": {
                  "status": "Running",
                  "info": {
                    "params": {
                      "modes": [
                        {
                          "TimedExactIn": {
                            "layers": [
                              {
                                "min_amount": "1500000000000",
                                "max_amount": "4000000000000",
                                "delay": 45000,
                                "min_mcap": 120000000000,
                                "end_condition": {
                                  "amount": "60000000000000",
                                  "time": 21600
                                }
                              }
                            ]
                          }
                        },
                        {
                          "McapLadder": [
                            {
                              "target_mcap": 150000000000,
                              "sell_amount": "20000000000000"
                            },
                            {
                              "target_mcap": 300000000000,
                              "sell_amount": "40000000000000"
                            }
                          ]
                        }
                      ],
                      "end_condition": {
                        "time": 0,
                        "amount": "0"
                      },
                      "slippage": 1500,
                      "start_delay": 300,
                      "wallet_pubkeys": null
                    },
                    "started_at": 1793655010,
                    "ended_at": null,
                    "status_reason": null,
                    "auto_sell_native_profit": 2875000000,
                    "auto_sell_usd_profit": 539060000,
                    "auto_sell_token_sold": 26500000000000,
                    "modes": [
                      {
                        "id": "timed",
                        "layers": [
                          {
                            "id": "as_4217_l0",
                            "state": "Active",
                            "token_sold": 6500000000000,
                            "sol_spent": 655000000
                          }
                        ]
                      },
                      {
                        "id": "mcap_ladder",
                        "layers": [
                          {
                            "id": "as_4217_0",
                            "state": "Exhausted",
                            "token_sold": 20000000000000,
                            "sol_spent": 2220000000
                          },
                          {
                            "id": "as_4217_1",
                            "state": "Active",
                            "token_sold": 0,
                            "sol_spent": 0
                          }
                        ]
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#get-auto-sell-status"
        }
      }
    },
    "/launch/autosell/cancel/{launch_id}": {
      "post": {
        "operationId": "auto-sell.cancel-auto-sell",
        "summary": "Cancel an Auto Sell session",
        "description": "Cancels the whole Auto Sell session, one mode, or one layer.\n\nSend `layer_id` or `mode` to cancel part of the session; send no body to cancel all of it.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "layer_id": {
                    "type": "string",
                    "description": "Target one layer, e.g. `as_4217_l0` (from `modes[].layers[].id` in the status)."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "replication",
                      "timed",
                      "mcap_ladder"
                    ],
                    "description": "Target every layer of one mode."
                  }
                }
              },
              "example": {
                "mode": "timed"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message` (`Layer cancelled` when one layer was targeted).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto sell task successfully cancelled"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `layer_id` lacks the prefix of this launch's Auto Sell layer IDs. EVM accepts any value and changes nothing. Pass a layer `id` from `modes[].layers[]` in [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status).\n\n`bad_request`: Solana: `mode` is not `replication`, `timed` or `mcap_ladder`, checked only while the engine runs. EVM accepts any value and changes nothing. Send `replication`, `timed` or `mcap_ladder`.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `layer_id` lacks the prefix of this launch's Auto Sell layer IDs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid layer_id for this launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: `mode` is not `replication`, `timed` or `mcap_ladder`, checked only while the engine runs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mode: must be replication, timed, or mcap_ladder"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: EVM: `layer_id` or `mode` was sent and the launch has no Auto Sell session. Send no body to clear the session state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "EVM: `layer_id` or `mode` was sent and the launch has no Auto Sell session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autosell session found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: `layer_id` or `mode` was sent and the session is not `Running`. A cancel with no body works in any state. Send no body to cancel the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "`layer_id` or `mode` was sent and the session is not `Running`. A cancel with no body works in any state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autosell session is not running"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch trades on the pace engine, which cancels whole sessions only, and `layer_id` or `mode` was sent. Send no `layer_id` or `mode` to cancel the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch trades on the pace engine, which cancels whole sessions only, and `layer_id` or `mode` was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a launch on pace cancels whole sessions, not layers"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: `layer_id` or `mode` was sent and the launch has no Auto Sell session. Send no body to clear the session state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: `layer_id` or `mode` was sent and the launch has no Auto Sell session.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autosell session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A cancel with no body answers `200` in any state, so repeating it changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#cancel-auto-sell"
        }
      }
    },
    "/launch/autosell/pause/{launch_id}": {
      "post": {
        "operationId": "auto-sell.pause-auto-sell",
        "summary": "Pause an Auto Sell session",
        "description": "Pauses the whole Auto Sell session, one mode, or one layer.\n\nSend `layer_id` or `mode` to pause part of the session; the client sends `{}` to pause all of it.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "layer_id": {
                    "type": "string",
                    "description": "Target one layer, e.g. `as_4217_l0` (from `modes[].layers[].id` in the status)."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "replication",
                      "timed",
                      "mcap_ladder"
                    ],
                    "description": "Target every layer of one mode."
                  }
                }
              },
              "example": {
                "mode": "timed"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message` (`Layer paused` when one layer was targeted).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto sell paused"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `layer_id` lacks the prefix of this launch's Auto Sell layer IDs. EVM accepts any value and changes nothing. Pass a layer `id` from `modes[].layers[]` in [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status).\n\n`bad_request`: Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing. Send `replication`, `timed` or `mcap_ladder`.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `layer_id` lacks the prefix of this launch's Auto Sell layer IDs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid layer_id for this launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mode: must be replication, timed, or mcap_ladder"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) and start a new one with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`not_found`: EVM: the launch has no session to pause. Start a session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell) or plan one with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell).\n\n`not_found`: EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) and start a new one with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`not_found`: The launch trades on the pace engine and pace no longer holds the session. Start a new session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No MM engine running for this launch"
                    }
                  },
                  "not_found_3": {
                    "summary": "EVM: the launch has no session to pause.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autosell session found"
                    }
                  },
                  "not_found_4": {
                    "summary": "EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No engine running for this launch"
                    }
                  },
                  "not_found_5": {
                    "summary": "The launch trades on the pace engine and pace no longer holds the session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer holds this session"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The session is not `Running`, for example because it is already `Paused`. Read [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status), and resume a paused session with [Resume an Auto Sell session](/reference/auto-sell/#resume-auto-sell).\n\n`conflict`: The launch trades on the pace engine and pace already moved the session to another state. Read [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status) for the current state before acting again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The session is not `Running`, for example because it is already `Paused`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autosell session is not running"
                    }
                  },
                  "conflict_2": {
                    "summary": "The launch trades on the pace engine and pace already moved the session to another state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already moved this session"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch trades on the pace engine, which pauses whole sessions only, and `layer_id` or `mode` was sent. Send no `layer_id` or `mode` to pause the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch trades on the pace engine, which pauses whole sessions only, and `layer_id` or `mode` was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a launch on pace pauses whole sessions, not layers"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch has no session to pause. Start a session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell) or plan one with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch has no session to pause.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autosell session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Once the session is `Paused`, a repeat answers `409` and changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#pause-auto-sell"
        }
      }
    },
    "/launch/autosell/resume/{launch_id}": {
      "post": {
        "operationId": "auto-sell.resume-auto-sell",
        "summary": "Resume an Auto Sell session",
        "description": "Resumes a paused Auto Sell session, mode, or layer.\n\nSend `layer_id` or `mode` to resume part of the session; the client sends `{}` to resume all of it.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "layer_id": {
                    "type": "string",
                    "description": "Target one layer, e.g. `as_4217_l0` (from `modes[].layers[].id` in the status)."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "replication",
                      "timed",
                      "mcap_ladder"
                    ],
                    "description": "Target every layer of one mode."
                  }
                }
              },
              "example": {
                "layer_id": "as_4217_l0"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a `message` (`Layer resumed` when one layer was targeted).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Auto sell resumed"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: Solana: `layer_id` lacks the prefix of this launch's Auto Sell layer IDs. EVM accepts any value and changes nothing. Pass a layer `id` from `modes[].layers[]` in [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status).\n\n`bad_request`: Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing. Send `replication`, `timed` or `mcap_ladder`.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Solana: `layer_id` lacks the prefix of this launch's Auto Sell layer IDs. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid layer_id for this launch"
                    }
                  },
                  "bad_request_3": {
                    "summary": "Solana: `mode` is not `replication`, `timed` or `mcap_ladder`. EVM accepts any value and changes nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid mode: must be replication, timed, or mcap_ladder"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  },
                  "bad_request_5": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) and start a new one with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`not_found`: EVM: the launch has no session to resume. Start a session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell) or plan one with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell).\n\n`not_found`: EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart. Cancel the session with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) and start a new one with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`not_found`: The launch trades on the pace engine and pace no longer holds the session. Start a new session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No MM engine running for this launch"
                    }
                  },
                  "not_found_3": {
                    "summary": "EVM: the launch has no session to resume.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No autosell session found"
                    }
                  },
                  "not_found_4": {
                    "summary": "EVM: the session is `Running` or `Paused` but its engine is gone, for example after a restart.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "No engine running for this launch"
                    }
                  },
                  "not_found_5": {
                    "summary": "The launch trades on the pace engine and pace no longer holds the session.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "pace no longer holds this session"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: the session is neither `Paused` nor `Running`. Start a new session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`conflict`: EVM: the session is neither `Paused` nor `Running`. Start a new session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell).\n\n`conflict`: The launch trades on the pace engine and pace already moved the session to another state. Read [Retrieve Auto Sell status](/reference/auto-sell/#get-auto-sell-status) for the current state before acting again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: the session is neither `Paused` nor `Running`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autosell session is not paused"
                    }
                  },
                  "conflict_2": {
                    "summary": "EVM: the session is neither `Paused` nor `Running`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Autosell session is not running or paused"
                    }
                  },
                  "conflict_3": {
                    "summary": "The launch trades on the pace engine and pace already moved the session to another state.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "pace already moved this session"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The launch trades on the pace engine, which resumes whole sessions only, and `layer_id` or `mode` was sent. Send no `layer_id` or `mode` to resume the whole session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The launch trades on the pace engine, which resumes whole sessions only, and `layer_id` or `mode` was sent.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "a launch on pace resumes whole sessions, not layers"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the launch has no session to resume. Start a session with [Start an Auto Sell session](/reference/auto-sell/#run-auto-sell) or plan one with [Plan an Auto Sell session](/reference/auto-sell/#plan-auto-sell).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the launch has no session to resume.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No autosell session found"
                    }
                  }
                }
              }
            }
          },
          "503": {
            "description": "`pace_unavailable`: The launch's platform trades on the pace engine and pace could not be reached. Send the request again after a short wait.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "pace_unavailable": {
                    "summary": "The launch's platform trades on the pace engine and pace could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "pace_unavailable",
                      "message": "the execution engine is unavailable, nothing was armed"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Resuming a session that already runs answers `200` and changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#resume-auto-sell"
        }
      }
    },
    "/launch/autosell/discard/{launch_id}": {
      "post": {
        "operationId": "auto-sell.discard-auto-sell",
        "summary": "Discard an Auto Sell session",
        "description": "Clears a planned or finished Auto Sell session from the launch.",
        "tags": [
          "Auto Sell"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully discarded auto sell session status"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: the session is `Running` or `Paused`. EVM answers `200` and keeps the live session. Stop the session with [Cancel an Auto Sell session](/reference/auto-sell/#cancel-auto-sell) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: the session is `Running` or `Paused`. EVM answers `200` and keeps the live session.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot discard running session"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Once the session state is cleared, a repeat answers `200` and changes nothing."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/auto-sell/#discard-auto-sell"
        }
      }
    },
    "/launch/volume/plan/{launch_id}": {
      "post": {
        "operationId": "volume-bot.plan-volume-bot",
        "summary": "Plan a Volume Bot session",
        "description": "Saves a Volume Bot session as `Planned`; on Solana it starts with the launch.\n\nOn Solana the token does not need to be launched yet, and the planned session starts when the launch runs. On EVM the token must already be launched, nothing starts the session automatically, and the next [Start a Volume Bot session](/reference/volume-bot/#run-volume-bot) call runs the planned parameters instead of the ones in its body.",
        "tags": [
          "Volume Bot"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "Bundle",
                      "Organic"
                    ],
                    "description": "Trading pattern of the bot."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "TimeBased": {
                        "type": "object",
                        "properties": {
                          "target_volume": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate: raw quote units on Solana, native wei on EVM. Send this or `target_volume_usd`."
                          },
                          "target_volume_usd": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate, micro-USD. Send this or `target_volume`."
                          },
                          "duration": {
                            "type": "integer",
                            "description": "Duration in seconds, at most 86400."
                          }
                        },
                        "required": [
                          "duration"
                        ],
                        "description": "Generate the target volume over a fixed duration."
                      },
                      "DelayBased": {
                        "type": "object",
                        "properties": {
                          "target_volume": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate: raw quote units on Solana, native wei on EVM. Send this or `target_volume_usd`."
                          },
                          "target_volume_usd": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate, micro-USD. Send this or `target_volume`."
                          },
                          "min_delay": {
                            "type": "integer",
                            "description": "Minimum delay in milliseconds (1000–300000)."
                          },
                          "max_delay": {
                            "type": "integer",
                            "description": "Maximum delay in milliseconds (1000–300000), at least `min_delay`."
                          }
                        },
                        "required": [
                          "min_delay",
                          "max_delay"
                        ],
                        "description": "Generate the target volume with a random delay between round trips."
                      }
                    },
                    "description": "When the bot stops. Exactly one key is set."
                  },
                  "min_amount": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Smallest trade, raw quote units. Send with `max_amount` to override the computed sizes."
                  },
                  "max_amount": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Largest trade, raw quote units."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade, or `null` for all of them. An empty array is rejected."
                  },
                  "fee_target": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Solana only: fee target, raw native units."
                  },
                  "wave_intensity": {
                    "type": "number",
                    "description": "`Organic` mode only: intensity of the volume waves, from `0.0` (tight buy/sell alternation) to `1.0` (long waves)."
                  }
                },
                "required": [
                  "mode",
                  "end_condition",
                  "wallet_pubkeys"
                ]
              },
              "example": {
                "mode": "Organic",
                "end_condition": {
                  "TimeBased": {
                    "target_volume_usd": "25000000000",
                    "duration": 7200
                  }
                },
                "wallet_pubkeys": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                  "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX"
                ],
                "wave_intensity": 0.6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully planned volume bot session"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: `end_condition` sets neither `target_volume` nor `target_volume_usd`, or sets it to 0. EVM answers 500 `internal_error` with `Provide target_volume or target_volume_usd`, `target_volume must be > 0` or `target_volume_usd must be > 0`. Set exactly one of `target_volume` or `target_volume_usd` to a positive value.\n\n`bad_request`: `end_condition` sets both `target_volume` and `target_volume_usd`. EVM sends the same message with 500 `internal_error`. Send only one of the two targets.\n\n`bad_request`: Solana: `TimeBased.duration` is 0 or above 86400 seconds. EVM refuses only 0, with 500 `internal_error` and `duration must be > 0`. Set `duration` between 1 and 86400 seconds.\n\n`bad_request`: Solana: at the largest trade size, the target needs more trades than fit in `duration`, counting at least 8 seconds per trade. Increase `duration`, lower the target or raise `max_amount`.\n\n`bad_request`: Solana: with explicit amounts, the target needs more than 60 round trips per minute. Raise `min_amount` and `max_amount`, lower the target or increase `duration`.\n\n`bad_request`: Solana: `DelayBased.min_delay` is under 1000 ms or `max_delay` is over 300000 ms. Keep both delays between 1000 and 300000 ms.\n\n`bad_request`: `DelayBased.min_delay` is greater than `max_delay`. EVM sends the same message with 500 `internal_error`. Set `min_delay` at or below `max_delay`.\n\n`bad_request`: Solana: a `DelayBased` session omits `min_amount` or `max_amount`. Send both `min_amount` and `max_amount` with a `DelayBased` end condition.\n\n`bad_request`: Only one of `min_amount` and `max_amount` is set. EVM answers 500 `internal_error` with `provide both min_amount and max_amount, or neither`. Send both amounts, or neither to let the bot size the trades.\n\n`bad_request`: Solana: `min_amount` or `max_amount` is worth less than 0.0001 SOL (100000 lamports) in the launch quote. Raise both amounts to at least the equivalent of 0.0001 SOL.\n\n`bad_request`: Solana: `min_amount` is greater than `max_amount`. EVM answers 500 `internal_error` with `require 0 < min_amount <= max_amount`, also when `min_amount` is 0. Set `min_amount` at or below `max_amount`.\n\n`bad_request`: `wave_intensity` is outside 0.0–1.0. EVM sends the same message with 500 `internal_error`. Send a `wave_intensity` between 0 and 1.\n\n`bad_request`: Solana: `wallet_pubkeys` is an empty array. Send `null` to use every holder wallet, or list at least one wallet.\n\n`bad_request`: Solana: an entry of `wallet_pubkeys` is not a valid Solana address. Correct or remove the malformed address.\n\n`bad_request`: EVM: the token is still a draft. Unlike Solana, EVM only plans a session on a launched token. Launch the token first with [Launch a token](/reference/launch-execution/#launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: not available here; use the winner launch once it resolves"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`end_condition` sets neither `target_volume` nor `target_volume_usd`, or sets it to 0. EVM answers 500 `internal_error` with `Provide target_volume or target_volume_usd`, `target_volume must be > 0` or `target_volume_usd must be > 0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Must provide target_volume or target_volume_usd > 0"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`end_condition` sets both `target_volume` and `target_volume_usd`. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Provide either target_volume or target_volume_usd, not both"
                    }
                  },
                  "bad_request_6": {
                    "summary": "Solana: `TimeBased.duration` is 0 or above 86400 seconds. EVM refuses only 0, with 500 `internal_error` and `duration must be > 0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid duration"
                    }
                  },
                  "bad_request_7": {
                    "summary": "Solana: at the largest trade size, the target needs more trades than fit in `duration`, counting at least 8 seconds per trade.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Duration too short for this volume target. Increase duration or reduce target volume"
                    }
                  },
                  "bad_request_8": {
                    "summary": "Solana: with explicit amounts, the target needs more than 60 round trips per minute.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Too many transactions for this duration. Increase trade amount, reduce target volume, or increase duration"
                    }
                  },
                  "bad_request_9": {
                    "summary": "Solana: `DelayBased.min_delay` is under 1000 ms or `max_delay` is over 300000 ms.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid delay range"
                    }
                  },
                  "bad_request_10": {
                    "summary": "`DelayBased.min_delay` is greater than `max_delay`. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "min_delay must be <= max_delay"
                    }
                  },
                  "bad_request_11": {
                    "summary": "Solana: a `DelayBased` session omits `min_amount` or `max_amount`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "DelayBased mode requires min_amount and max_amount"
                    }
                  },
                  "bad_request_12": {
                    "summary": "Only one of `min_amount` and `max_amount` is set. EVM answers 500 `internal_error` with `provide both min_amount and max_amount, or neither`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Provide both min_amount and max_amount, or neither"
                    }
                  },
                  "bad_request_13": {
                    "summary": "Solana: `min_amount` or `max_amount` is worth less than 0.0001 SOL (100000 lamports) in the launch quote.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Trade amount too small"
                    }
                  },
                  "bad_request_14": {
                    "summary": "Solana: `min_amount` is greater than `max_amount`. EVM answers 500 `internal_error` with `require 0 < min_amount <= max_amount`, also when `min_amount` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "min_amount must be <= max_amount"
                    }
                  },
                  "bad_request_15": {
                    "summary": "`wave_intensity` is outside 0.0–1.0. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wave_intensity must be between 0.0 and 1.0"
                    }
                  },
                  "bad_request_16": {
                    "summary": "Solana: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet_pubkeys cannot be empty"
                    }
                  },
                  "bad_request_17": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid pubkey"
                    }
                  },
                  "bad_request_18": {
                    "summary": "EVM: the token is still a draft. Unlike Solana, EVM only plans a session on a launched token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: Solana: an entry of `wallet_pubkeys` is not one of the launch's wallets. Add the wallet with [Add wallets to a launch](/reference/launches/#add-launch-wallets), or remove it from the list.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not one of the launch's wallets.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Wallet not found in launch"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: a Volume Bot session is running for this launch. Wait for it to end or stop it with [Cancel a Volume Bot session](/reference/volume-bot/#cancel-volume-bot) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: a Volume Bot session is running for this launch.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Task already running"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana: `wallet_pubkeys` is `null` and the launch has no holder wallets. Add holder wallets with [Add wallets to a launch](/reference/launches/#add-launch-wallets), or list wallets in `wallet_pubkeys`.\n\n`upstream_failure`: Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds `service: \"price_feed\"`. Retry in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana: `wallet_pubkeys` is `null` and the launch has no holder wallets.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No wallets available"
                    }
                  },
                  "upstream_failure": {
                    "summary": "Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds `service: \"price_feed\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "price_feed api issue: The launch quote has no price right now"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: EVM: a Volume Bot session is already running for this launch. Wait for it to end or stop it with [Cancel a Volume Bot session](/reference/volume-bot/#cancel-volume-bot) first.\n\n`internal_error`: EVM: no entry of `wallet_pubkeys` is a wallet of the launch. List addresses of the launch's own wallets, or send `null` to use all of them.\n\n`internal_error`: EVM: `wallet_pubkeys` is an empty array, or the launch holds no usable wallet. Send `null` to use every launch wallet, or list at least one launch wallet.\n\n`internal_error`: EVM: `mode` is `Bundle` on a chain that has no bundle relay. Use `Organic` mode on this chain.\n\n`internal_error`: EVM: the target is smaller than one trade of `max_amount`, typically a target sent in whole units instead of wei. Send `target_volume` in wei, or `target_volume_usd` in micro-USD.\n\n`internal_error`: EVM: the launch names a quote token that cannot be resolved right now. Retry in a few seconds.\n\n`internal_error`: EVM: `target_volume_usd` is set and the chain's native price is unavailable. Retry in a few seconds, or send `target_volume` in wei instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "EVM: a Volume Bot session is already running for this launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Volume bot already running for this launch"
                    }
                  },
                  "internal_error_2": {
                    "summary": "EVM: no entry of `wallet_pubkeys` is a wallet of the launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "wallet_pubkeys provided but none matched launch wallets"
                    }
                  },
                  "internal_error_3": {
                    "summary": "EVM: `wallet_pubkeys` is an empty array, or the launch holds no usable wallet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallets available for volume bot"
                    }
                  },
                  "internal_error_4": {
                    "summary": "EVM: `mode` is `Bundle` on a chain that has no bundle relay.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Bundle mode needs a bundle relay, which this chain has none of"
                    }
                  },
                  "internal_error_5": {
                    "summary": "EVM: the target is smaller than one trade of `max_amount`, typically a target sent in whole units instead of wei.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "target_volume too small (below one trade); send it in wei or use target_volume_usd (micro-USD)"
                    }
                  },
                  "internal_error_6": {
                    "summary": "EVM: the launch names a quote token that cannot be resolved right now.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "the launch quote cannot be resolved right now, retry in a moment"
                    }
                  },
                  "internal_error_7": {
                    "summary": "EVM: `target_volume_usd` is set and the chain's native price is unavailable.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "native price unavailable for USD target"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Planning again replaces the planned configuration. Nothing trades until the session starts."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/volume-bot/#plan-volume-bot"
        }
      }
    },
    "/launch/volume/run/{launch_id}": {
      "post": {
        "operationId": "volume-bot.run-volume-bot",
        "summary": "Start a Volume Bot session",
        "description": "Starts a Volume Bot session right away on a launched token.\n\nThe token must be launched. On Solana, listed wallets that are not launch wallets are looked up among the license's wallets. On EVM, when the launch has a `Planned` session, the planned parameters run and the parameters in this body are ignored.\n\nTrades from the launch wallets and spends their balances on fees and slippage until the target is reached or the session is cancelled.",
        "tags": [
          "Volume Bot"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "Bundle",
                      "Organic"
                    ],
                    "description": "Trading pattern of the bot."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "TimeBased": {
                        "type": "object",
                        "properties": {
                          "target_volume": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate: raw quote units on Solana, native wei on EVM. Send this or `target_volume_usd`."
                          },
                          "target_volume_usd": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate, micro-USD. Send this or `target_volume`."
                          },
                          "duration": {
                            "type": "integer",
                            "description": "Duration in seconds, at most 86400."
                          }
                        },
                        "required": [
                          "duration"
                        ],
                        "description": "Generate the target volume over a fixed duration."
                      },
                      "DelayBased": {
                        "type": "object",
                        "properties": {
                          "target_volume": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate: raw quote units on Solana, native wei on EVM. Send this or `target_volume_usd`."
                          },
                          "target_volume_usd": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate, micro-USD. Send this or `target_volume`."
                          },
                          "min_delay": {
                            "type": "integer",
                            "description": "Minimum delay in milliseconds (1000–300000)."
                          },
                          "max_delay": {
                            "type": "integer",
                            "description": "Maximum delay in milliseconds (1000–300000), at least `min_delay`."
                          }
                        },
                        "required": [
                          "min_delay",
                          "max_delay"
                        ],
                        "description": "Generate the target volume with a random delay between round trips."
                      }
                    },
                    "description": "When the bot stops. Exactly one key is set."
                  },
                  "min_amount": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Smallest trade, raw quote units. Send with `max_amount` to override the computed sizes."
                  },
                  "max_amount": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Largest trade, raw quote units."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade, or `null` for all of them. An empty array is rejected."
                  },
                  "fee_target": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Solana only: fee target, raw native units."
                  },
                  "wave_intensity": {
                    "type": "number",
                    "description": "`Organic` mode only: intensity of the volume waves, from `0.0` (tight buy/sell alternation) to `1.0` (long waves)."
                  }
                },
                "required": [
                  "mode",
                  "end_condition",
                  "wallet_pubkeys"
                ]
              },
              "example": {
                "mode": "Organic",
                "end_condition": {
                  "TimeBased": {
                    "target_volume_usd": "25000000000",
                    "duration": 7200
                  }
                },
                "wallet_pubkeys": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                  "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX"
                ],
                "wave_intensity": 0.6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    },
                    "session_id": {
                      "type": "string",
                      "description": "EVM only: ID of the session that started."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully started volume bot"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: `end_condition` sets neither `target_volume` nor `target_volume_usd`, or sets it to 0. EVM answers 500 `internal_error` with `Provide target_volume or target_volume_usd`, `target_volume must be > 0` or `target_volume_usd must be > 0`. Set exactly one of `target_volume` or `target_volume_usd` to a positive value.\n\n`bad_request`: `end_condition` sets both `target_volume` and `target_volume_usd`. EVM sends the same message with 500 `internal_error`. Send only one of the two targets.\n\n`bad_request`: Solana: `TimeBased.duration` is 0 or above 86400 seconds. EVM refuses only 0, with 500 `internal_error` and `duration must be > 0`. Set `duration` between 1 and 86400 seconds.\n\n`bad_request`: Solana: at the largest trade size, the target needs more trades than fit in `duration`, counting at least 8 seconds per trade. Increase `duration`, lower the target or raise `max_amount`.\n\n`bad_request`: Solana: with explicit amounts, the target needs more than 60 round trips per minute. Raise `min_amount` and `max_amount`, lower the target or increase `duration`.\n\n`bad_request`: Solana: `DelayBased.min_delay` is under 1000 ms or `max_delay` is over 300000 ms. Keep both delays between 1000 and 300000 ms.\n\n`bad_request`: `DelayBased.min_delay` is greater than `max_delay`. EVM sends the same message with 500 `internal_error`. Set `min_delay` at or below `max_delay`.\n\n`bad_request`: Solana: a `DelayBased` session omits `min_amount` or `max_amount`. Send both `min_amount` and `max_amount` with a `DelayBased` end condition.\n\n`bad_request`: Only one of `min_amount` and `max_amount` is set. EVM answers 500 `internal_error` with `provide both min_amount and max_amount, or neither`. Send both amounts, or neither to let the bot size the trades.\n\n`bad_request`: Solana: `min_amount` or `max_amount` is worth less than 0.0001 SOL (100000 lamports) in the launch quote. Raise both amounts to at least the equivalent of 0.0001 SOL.\n\n`bad_request`: Solana: `min_amount` is greater than `max_amount`. EVM answers 500 `internal_error` with `require 0 < min_amount <= max_amount`, also when `min_amount` is 0. Set `min_amount` at or below `max_amount`.\n\n`bad_request`: `wave_intensity` is outside 0.0–1.0. EVM sends the same message with 500 `internal_error`. Send a `wave_intensity` between 0 and 1.\n\n`bad_request`: EVM: the token is still a draft. The token must be launched before a session starts. Launch the token first with [Launch a token](/reference/launch-execution/#launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: not available here; use the winner launch once it resolves"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`end_condition` sets neither `target_volume` nor `target_volume_usd`, or sets it to 0. EVM answers 500 `internal_error` with `Provide target_volume or target_volume_usd`, `target_volume must be > 0` or `target_volume_usd must be > 0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Must provide target_volume or target_volume_usd > 0"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`end_condition` sets both `target_volume` and `target_volume_usd`. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Provide either target_volume or target_volume_usd, not both"
                    }
                  },
                  "bad_request_6": {
                    "summary": "Solana: `TimeBased.duration` is 0 or above 86400 seconds. EVM refuses only 0, with 500 `internal_error` and `duration must be > 0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid duration"
                    }
                  },
                  "bad_request_7": {
                    "summary": "Solana: at the largest trade size, the target needs more trades than fit in `duration`, counting at least 8 seconds per trade.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Duration too short for this volume target. Increase duration or reduce target volume"
                    }
                  },
                  "bad_request_8": {
                    "summary": "Solana: with explicit amounts, the target needs more than 60 round trips per minute.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Too many transactions for this duration. Increase trade amount, reduce target volume, or increase duration"
                    }
                  },
                  "bad_request_9": {
                    "summary": "Solana: `DelayBased.min_delay` is under 1000 ms or `max_delay` is over 300000 ms.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid delay range"
                    }
                  },
                  "bad_request_10": {
                    "summary": "`DelayBased.min_delay` is greater than `max_delay`. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "min_delay must be <= max_delay"
                    }
                  },
                  "bad_request_11": {
                    "summary": "Solana: a `DelayBased` session omits `min_amount` or `max_amount`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "DelayBased mode requires min_amount and max_amount"
                    }
                  },
                  "bad_request_12": {
                    "summary": "Only one of `min_amount` and `max_amount` is set. EVM answers 500 `internal_error` with `provide both min_amount and max_amount, or neither`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Provide both min_amount and max_amount, or neither"
                    }
                  },
                  "bad_request_13": {
                    "summary": "Solana: `min_amount` or `max_amount` is worth less than 0.0001 SOL (100000 lamports) in the launch quote.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Trade amount too small"
                    }
                  },
                  "bad_request_14": {
                    "summary": "Solana: `min_amount` is greater than `max_amount`. EVM answers 500 `internal_error` with `require 0 < min_amount <= max_amount`, also when `min_amount` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "min_amount must be <= max_amount"
                    }
                  },
                  "bad_request_15": {
                    "summary": "`wave_intensity` is outside 0.0–1.0. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wave_intensity must be between 0.0 and 1.0"
                    }
                  },
                  "bad_request_16": {
                    "summary": "EVM: the token is still a draft. The token must be launched before a session starts.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds `service: \"price_feed\"`. Retry in a few seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds `service: \"price_feed\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "price_feed api issue: The launch quote has no price right now"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is still a draft. EVM answers 400 `bad_request` with `token not launched`. Launch the token first with [Launch a token](/reference/launch-execution/#launch).\n\n`internal_error`: Solana: a Volume Bot session is already running for this launch. Wait for it to end or stop it with [Cancel a Volume Bot session](/reference/volume-bot/#cancel-volume-bot) first.\n\n`internal_error`: Solana: `wallet_pubkeys` is an empty array. Send `null` to use every holder wallet, or list at least one wallet.\n\n`internal_error`: Solana: an entry of `wallet_pubkeys` is not a valid Solana address. Correct or remove the malformed address.\n\n`internal_error`: Solana: none of the listed wallets belongs to the launch or the license's wallets, or `wallet_pubkeys` is `null` and the launch has no holder wallets. List wallets of the launch or license, or add holder wallets with [Add wallets to a launch](/reference/launches/#add-launch-wallets).\n\n`internal_error`: Solana: `target_volume_usd` is set and the SOL price is unavailable. Retry in a few seconds, or send `target_volume` instead.\n\n`internal_error`: Solana, quote-token launch: no wallet holds the 0.05 SOL it keeps for fees. Fund the wallets with about 0.05 SOL each.\n\n`internal_error`: Solana, SOL-quoted launch: no wallet holds more than the 0.05 SOL fee buffer plus the smallest trade. Fund the wallets, then start the session again.\n\n`internal_error`: Solana, quote-token launch: no wallet holds enough of the quote token for the smallest trade. Swap the wallets into the quote token with [Swap funding to the quote token](/reference/launch-funding/#swap-to-quote), then start again.\n\n`internal_error`: Solana: at the size the balances allow, the target needs more trades than fit in `duration`. The session is recorded as `Failed` with this reason. Fund the wallets, lower the target or increase `duration`.\n\n`internal_error`: EVM: a Volume Bot session is already running for this launch. Wait for it to end or stop it with [Cancel a Volume Bot session](/reference/volume-bot/#cancel-volume-bot) first.\n\n`internal_error`: EVM: no entry of `wallet_pubkeys` is a wallet of the launch. List addresses of the launch's own wallets, or send `null` to use all of them.\n\n`internal_error`: EVM: `wallet_pubkeys` is an empty array, or the launch holds no usable wallet. Send `null` to use every launch wallet, or list at least one launch wallet.\n\n`internal_error`: EVM: `mode` is `Bundle` on a chain that has no bundle relay. Use `Organic` mode on this chain.\n\n`internal_error`: EVM: the target is smaller than one trade of `max_amount`, typically a target sent in whole units instead of wei. Send `target_volume` in wei, or `target_volume_usd` in micro-USD.\n\n`internal_error`: EVM: the launch names a quote token that cannot be resolved right now. Retry in a few seconds.\n\n`internal_error`: EVM: `target_volume_usd` is set and the chain's native price is unavailable. Retry in a few seconds, or send `target_volume` in wei instead.\n\n`internal_error`: EVM: no wallet holds more native than the gas reserve a round trip needs. Fund the launch wallets with native gas, then start again.\n\n`internal_error`: EVM, launch whose quote is paid from the native balance: no wallet can afford `min_amount` after the gas reserve. Fund the launch wallets, then start again.\n\n`internal_error`: EVM, quote-token launch: no wallet holds `min_amount` of the quote token. Swap the wallets into the quote token with [Swap funding to the quote token](/reference/launch-funding/#swap-to-quote), then start again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is still a draft. EVM answers 400 `bad_request` with `token not launched`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: a Volume Bot session is already running for this launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Task already running"
                    }
                  },
                  "internal_error_3": {
                    "summary": "Solana: `wallet_pubkeys` is an empty array.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "wallet_pubkeys cannot be empty"
                    }
                  },
                  "internal_error_4": {
                    "summary": "Solana: an entry of `wallet_pubkeys` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Invalid pubkey"
                    }
                  },
                  "internal_error_5": {
                    "summary": "Solana: none of the listed wallets belongs to the launch or the license's wallets, or `wallet_pubkeys` is `null` and the launch has no holder wallets.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallets available"
                    }
                  },
                  "internal_error_6": {
                    "summary": "Solana: `target_volume_usd` is set and the SOL price is unavailable.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Failed to convert USD target to SOL (price unavailable)"
                    }
                  },
                  "internal_error_7": {
                    "summary": "Solana, quote-token launch: no wallet holds the 0.05 SOL it keeps for fees.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallet has enough SOL to pay tx fees. Fund wallets with ~0.05 SOL each"
                    }
                  },
                  "internal_error_8": {
                    "summary": "Solana, SOL-quoted launch: no wallet holds more than the 0.05 SOL fee buffer plus the smallest trade.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallet has enough SOL to trade. Fund your wallets first"
                    }
                  },
                  "internal_error_9": {
                    "summary": "Solana, quote-token launch: no wallet holds enough of the quote token for the smallest trade.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallet holds enough of the launch quote to trade. Fund the wallets with it first"
                    }
                  },
                  "internal_error_10": {
                    "summary": "Solana: at the size the balances allow, the target needs more trades than fit in `duration`. The session is recorded as `Failed` with this reason.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Wallet balances too low for this volume target and duration. Increase wallet funding, reduce target, or increase duration"
                    }
                  },
                  "internal_error_11": {
                    "summary": "EVM: a Volume Bot session is already running for this launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Volume bot already running for this launch"
                    }
                  },
                  "internal_error_12": {
                    "summary": "EVM: no entry of `wallet_pubkeys` is a wallet of the launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "wallet_pubkeys provided but none matched launch wallets"
                    }
                  },
                  "internal_error_13": {
                    "summary": "EVM: `wallet_pubkeys` is an empty array, or the launch holds no usable wallet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallets available for volume bot"
                    }
                  },
                  "internal_error_14": {
                    "summary": "EVM: `mode` is `Bundle` on a chain that has no bundle relay.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Bundle mode needs a bundle relay, which this chain has none of"
                    }
                  },
                  "internal_error_15": {
                    "summary": "EVM: the target is smaller than one trade of `max_amount`, typically a target sent in whole units instead of wei.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "target_volume too small (below one trade); send it in wei or use target_volume_usd (micro-USD)"
                    }
                  },
                  "internal_error_16": {
                    "summary": "EVM: the launch names a quote token that cannot be resolved right now.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "the launch quote cannot be resolved right now, retry in a moment"
                    }
                  },
                  "internal_error_17": {
                    "summary": "EVM: `target_volume_usd` is set and the chain's native price is unavailable.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "native price unavailable for USD target"
                    }
                  },
                  "internal_error_18": {
                    "summary": "EVM: no wallet holds more native than the gas reserve a round trip needs.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallet holds enough gas to trade. Fund the launch wallets first"
                    }
                  },
                  "internal_error_19": {
                    "summary": "EVM, launch whose quote is paid from the native balance: no wallet can afford `min_amount` after the gas reserve.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallet holds enough to trade. Fund the launch wallets first"
                    }
                  },
                  "internal_error_20": {
                    "summary": "EVM, quote-token launch: no wallet holds `min_amount` of the quote token.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallet holds enough of the launch quote to trade. Swap the wallets into it first"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve Volume Bot status](/reference/volume-bot/#get-volume-bot-status) first: `Running`, or a `started_at` later than your first call, means it went through. A second run is refused while a session runs."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/volume-bot/#run-volume-bot"
        }
      }
    },
    "/launch/volume/status/{launch_id}": {
      "get": {
        "operationId": "volume-bot.get-volume-bot-status",
        "summary": "Retrieve Volume Bot status",
        "description": "Returns the launch's Volume Bot session and its counters.",
        "tags": [
          "Volume Bot"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a Volume bot status object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "None",
                        "Planned",
                        "Running",
                        "Completed",
                        "Cancelled",
                        "Failed"
                      ],
                      "description": "Session state."
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "params": {
                          "type": "object",
                          "description": "The session parameters, as sent to plan or run."
                        },
                        "started_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session started."
                        },
                        "ended_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session ended."
                        },
                        "status_reason": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Why the session ended or failed, when known."
                        },
                        "target_volume": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Typed by the web client, but neither chain sends it."
                        },
                        "volume_generated": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Volume generated so far, raw quote units."
                        },
                        "net_cost": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Net cost so far (fees and slippage), raw quote units."
                        },
                        "usd_volume_generated": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Volume generated so far, micro-USD."
                        },
                        "usd_net_cost": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Net cost so far, micro-USD."
                        },
                        "round_trips_completed": {
                          "type": "integer",
                          "description": "Buy-and-sell round trips completed."
                        }
                      },
                      "required": [
                        "params",
                        "started_at",
                        "ended_at",
                        "status_reason"
                      ],
                      "description": "Session details. Absent when `status` is `None`."
                    }
                  },
                  "required": [
                    "status"
                  ]
                },
                "example": {
                  "status": "Running",
                  "info": {
                    "params": {
                      "mode": "Organic",
                      "end_condition": {
                        "TimeBased": {
                          "target_volume_usd": "25000000000",
                          "duration": 7200
                        }
                      },
                      "wallet_pubkeys": [
                        "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                        "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                        "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX"
                      ],
                      "wave_intensity": 0.6
                    },
                    "started_at": 1793655010,
                    "ended_at": null,
                    "status_reason": null,
                    "volume_generated": 61200000000,
                    "net_cost": 410000000,
                    "usd_volume_generated": 11475000000,
                    "usd_net_cost": 76870000,
                    "round_trips_completed": 118
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/volume-bot/#get-volume-bot-status"
        }
      }
    },
    "/launch/volume/estimate/{launch_id}": {
      "post": {
        "operationId": "volume-bot.estimate-volume-bot",
        "summary": "Estimate a Volume Bot session",
        "description": "Computes the cost, round trips and per-wallet balance a configuration needs, without starting it.\n\nTakes the same body as plan and run. The client returns only the `estimate` object to its callers. On EVM the token must already be launched. On Solana the listed wallets are not checked against the launch.",
        "tags": [
          "Volume Bot"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "enum": [
                      "Bundle",
                      "Organic"
                    ],
                    "description": "Trading pattern of the bot."
                  },
                  "end_condition": {
                    "type": "object",
                    "properties": {
                      "TimeBased": {
                        "type": "object",
                        "properties": {
                          "target_volume": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate: raw quote units on Solana, native wei on EVM. Send this or `target_volume_usd`."
                          },
                          "target_volume_usd": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate, micro-USD. Send this or `target_volume`."
                          },
                          "duration": {
                            "type": "integer",
                            "description": "Duration in seconds, at most 86400."
                          }
                        },
                        "required": [
                          "duration"
                        ],
                        "description": "Generate the target volume over a fixed duration."
                      },
                      "DelayBased": {
                        "type": "object",
                        "properties": {
                          "target_volume": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate: raw quote units on Solana, native wei on EVM. Send this or `target_volume_usd`."
                          },
                          "target_volume_usd": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "string"
                              }
                            ],
                            "description": "Volume to generate, micro-USD. Send this or `target_volume`."
                          },
                          "min_delay": {
                            "type": "integer",
                            "description": "Minimum delay in milliseconds (1000–300000)."
                          },
                          "max_delay": {
                            "type": "integer",
                            "description": "Maximum delay in milliseconds (1000–300000), at least `min_delay`."
                          }
                        },
                        "required": [
                          "min_delay",
                          "max_delay"
                        ],
                        "description": "Generate the target volume with a random delay between round trips."
                      }
                    },
                    "description": "When the bot stops. Exactly one key is set."
                  },
                  "min_amount": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Smallest trade, raw quote units. Send with `max_amount` to override the computed sizes."
                  },
                  "max_amount": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Largest trade, raw quote units."
                  },
                  "wallet_pubkeys": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Launch wallets that trade, or `null` for all of them. An empty array is rejected."
                  },
                  "fee_target": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Solana only: fee target, raw native units."
                  },
                  "wave_intensity": {
                    "type": "number",
                    "description": "`Organic` mode only: intensity of the volume waves, from `0.0` (tight buy/sell alternation) to `1.0` (long waves)."
                  }
                },
                "required": [
                  "mode",
                  "end_condition",
                  "wallet_pubkeys"
                ]
              },
              "example": {
                "mode": "Organic",
                "end_condition": {
                  "TimeBased": {
                    "target_volume_usd": "25000000000",
                    "duration": 7200
                  }
                },
                "wallet_pubkeys": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                  "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX"
                ],
                "wave_intensity": 0.6
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a Volume estimate object under `estimate`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "estimate": {
                      "type": "object",
                      "properties": {
                        "round_trips": {
                          "type": "integer",
                          "description": "Round trips the bot would make."
                        },
                        "cost": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Estimated cost, raw native units."
                        },
                        "quote_cost": {
                          "anyOf": [
                            {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "string"
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Typed by the web client, but neither chain sends it."
                        },
                        "min_balance_per_wallet": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "string"
                            }
                          ],
                          "description": "Native each wallet needs, raw units. On a quote-denominated launch this covers gas only."
                        },
                        "min_quote_per_wallet": {
                          "anyOf": [
                            {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "string"
                                }
                              ]
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "EVM only: quote each wallet needs to trade, raw units. `null` on a gas-token launch."
                        },
                        "quote_symbol": {
                          "type": "string",
                          "description": "EVM only: symbol of the quote token."
                        },
                        "quote_decimals": {
                          "type": "integer",
                          "description": "EVM only: decimals of the quote token."
                        },
                        "min_duration_secs": {
                          "type": "integer",
                          "description": "Shortest duration the configuration allows, in seconds."
                        },
                        "wallets": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          },
                          "description": "Wallets the bot would use."
                        }
                      },
                      "required": [
                        "round_trips",
                        "cost",
                        "min_balance_per_wallet",
                        "min_duration_secs",
                        "wallets"
                      ],
                      "description": "The estimate."
                    }
                  },
                  "required": [
                    "ok",
                    "estimate"
                  ]
                },
                "example": {
                  "ok": true,
                  "estimate": {
                    "round_trips": 240,
                    "wallets": [
                      "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                      "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh",
                      "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX"
                    ],
                    "cost": 820000000,
                    "min_balance_per_wallet": 450000000,
                    "min_duration_secs": 240
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: `end_condition` sets neither `target_volume` nor `target_volume_usd`, or sets it to 0. EVM answers 500 `internal_error` with `Provide target_volume or target_volume_usd`, `target_volume must be > 0` or `target_volume_usd must be > 0`. Set exactly one of `target_volume` or `target_volume_usd` to a positive value.\n\n`bad_request`: `end_condition` sets both `target_volume` and `target_volume_usd`. EVM sends the same message with 500 `internal_error`. Send only one of the two targets.\n\n`bad_request`: Solana: `TimeBased.duration` is 0 or above 86400 seconds. EVM refuses only 0, with 500 `internal_error` and `duration must be > 0`. Set `duration` between 1 and 86400 seconds.\n\n`bad_request`: Solana: at the largest trade size, the target needs more trades than fit in `duration`, counting at least 8 seconds per trade. Increase `duration`, lower the target or raise `max_amount`.\n\n`bad_request`: Solana: with explicit amounts, the target needs more than 60 round trips per minute. Raise `min_amount` and `max_amount`, lower the target or increase `duration`.\n\n`bad_request`: Solana: `DelayBased.min_delay` is under 1000 ms or `max_delay` is over 300000 ms. Keep both delays between 1000 and 300000 ms.\n\n`bad_request`: `DelayBased.min_delay` is greater than `max_delay`. EVM sends the same message with 500 `internal_error`. Set `min_delay` at or below `max_delay`.\n\n`bad_request`: Solana: a `DelayBased` session omits `min_amount` or `max_amount`. Send both `min_amount` and `max_amount` with a `DelayBased` end condition.\n\n`bad_request`: Only one of `min_amount` and `max_amount` is set. EVM answers 500 `internal_error` with `provide both min_amount and max_amount, or neither`. Send both amounts, or neither to let the bot size the trades.\n\n`bad_request`: Solana: `min_amount` or `max_amount` is worth less than 0.0001 SOL (100000 lamports) in the launch quote. Raise both amounts to at least the equivalent of 0.0001 SOL.\n\n`bad_request`: Solana: `min_amount` is greater than `max_amount`. EVM answers 500 `internal_error` with `require 0 < min_amount <= max_amount`, also when `min_amount` is 0. Set `min_amount` at or below `max_amount`.\n\n`bad_request`: `wave_intensity` is outside 0.0–1.0. EVM sends the same message with 500 `internal_error`. Send a `wave_intensity` between 0 and 1.\n\n`bad_request`: Solana: the computed average trade size is 0. EVM answers 500 `internal_error` with `average amount would be 0`. Raise the target volume, or set `min_amount` and `max_amount` explicitly.\n\n`bad_request`: EVM: the token is still a draft. Unlike Solana, EVM only estimates a session on a launched token. Launch the token first with [Launch a token](/reference/launch-execution/#launch).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: not available here; use the winner launch once it resolves"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`end_condition` sets neither `target_volume` nor `target_volume_usd`, or sets it to 0. EVM answers 500 `internal_error` with `Provide target_volume or target_volume_usd`, `target_volume must be > 0` or `target_volume_usd must be > 0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Must provide target_volume or target_volume_usd > 0"
                    }
                  },
                  "bad_request_5": {
                    "summary": "`end_condition` sets both `target_volume` and `target_volume_usd`. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Provide either target_volume or target_volume_usd, not both"
                    }
                  },
                  "bad_request_6": {
                    "summary": "Solana: `TimeBased.duration` is 0 or above 86400 seconds. EVM refuses only 0, with 500 `internal_error` and `duration must be > 0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid duration"
                    }
                  },
                  "bad_request_7": {
                    "summary": "Solana: at the largest trade size, the target needs more trades than fit in `duration`, counting at least 8 seconds per trade.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Duration too short for this volume target. Increase duration or reduce target volume"
                    }
                  },
                  "bad_request_8": {
                    "summary": "Solana: with explicit amounts, the target needs more than 60 round trips per minute.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Too many transactions for this duration. Increase trade amount, reduce target volume, or increase duration"
                    }
                  },
                  "bad_request_9": {
                    "summary": "Solana: `DelayBased.min_delay` is under 1000 ms or `max_delay` is over 300000 ms.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid delay range"
                    }
                  },
                  "bad_request_10": {
                    "summary": "`DelayBased.min_delay` is greater than `max_delay`. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "min_delay must be <= max_delay"
                    }
                  },
                  "bad_request_11": {
                    "summary": "Solana: a `DelayBased` session omits `min_amount` or `max_amount`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "DelayBased mode requires min_amount and max_amount"
                    }
                  },
                  "bad_request_12": {
                    "summary": "Only one of `min_amount` and `max_amount` is set. EVM answers 500 `internal_error` with `provide both min_amount and max_amount, or neither`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Provide both min_amount and max_amount, or neither"
                    }
                  },
                  "bad_request_13": {
                    "summary": "Solana: `min_amount` or `max_amount` is worth less than 0.0001 SOL (100000 lamports) in the launch quote.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Trade amount too small"
                    }
                  },
                  "bad_request_14": {
                    "summary": "Solana: `min_amount` is greater than `max_amount`. EVM answers 500 `internal_error` with `require 0 < min_amount <= max_amount`, also when `min_amount` is 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "min_amount must be <= max_amount"
                    }
                  },
                  "bad_request_15": {
                    "summary": "`wave_intensity` is outside 0.0–1.0. EVM sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wave_intensity must be between 0.0 and 1.0"
                    }
                  },
                  "bad_request_16": {
                    "summary": "Solana: the computed average trade size is 0. EVM answers 500 `internal_error` with `average amount would be 0`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Average amount would be 0"
                    }
                  },
                  "bad_request_17": {
                    "summary": "EVM: the token is still a draft. Unlike Solana, EVM only estimates a session on a launched token.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds `service: \"price_feed\"`. Retry in a few seconds.\n\n`upstream_failure`: Solana: `target_volume_usd` is set and the SOL price is unavailable. The body adds `service: \"price_feed\"`. Retry in a few seconds, or send `target_volume` instead.\n\n`unprocessable`: Solana: `wallet_pubkeys` is an empty array, or it is `null` and the launch has no holder wallets. Send `null` to use every holder wallet, or add holder wallets with [Add wallets to a launch](/reference/launches/#add-launch-wallets).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "Solana: the launch quote has no price right now, so trade bounds cannot be computed. The body adds `service: \"price_feed\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "price_feed api issue: The launch quote has no price right now"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "Solana: `target_volume_usd` is set and the SOL price is unavailable. The body adds `service: \"price_feed\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "price_feed api issue: Failed to convert USD target to SOL"
                    }
                  },
                  "unprocessable": {
                    "summary": "Solana: `wallet_pubkeys` is an empty array, or it is `null` and the launch has no holder wallets.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No wallets available"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: EVM: no entry of `wallet_pubkeys` is a wallet of the launch. List addresses of the launch's own wallets, or send `null` to use all of them.\n\n`internal_error`: EVM: `wallet_pubkeys` is an empty array, or the launch holds no usable wallet. Send `null` to use every launch wallet, or list at least one launch wallet.\n\n`internal_error`: EVM: `mode` is `Bundle` on a chain that has no bundle relay. Use `Organic` mode on this chain.\n\n`internal_error`: EVM: the target is smaller than one trade of `max_amount`, typically a target sent in whole units instead of wei. Send `target_volume` in wei, or `target_volume_usd` in micro-USD.\n\n`internal_error`: EVM: the launch names a quote token that cannot be resolved right now. Retry in a few seconds.\n\n`internal_error`: EVM: `target_volume_usd` is set and the chain's native price is unavailable. Retry in a few seconds, or send `target_volume` in wei instead.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "EVM: no entry of `wallet_pubkeys` is a wallet of the launch.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "wallet_pubkeys provided but none matched launch wallets"
                    }
                  },
                  "internal_error_2": {
                    "summary": "EVM: `wallet_pubkeys` is an empty array, or the launch holds no usable wallet.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "No wallets available for volume bot"
                    }
                  },
                  "internal_error_3": {
                    "summary": "EVM: `mode` is `Bundle` on a chain that has no bundle relay.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Bundle mode needs a bundle relay, which this chain has none of"
                    }
                  },
                  "internal_error_4": {
                    "summary": "EVM: the target is smaller than one trade of `max_amount`, typically a target sent in whole units instead of wei.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "target_volume too small (below one trade); send it in wei or use target_volume_usd (micro-USD)"
                    }
                  },
                  "internal_error_5": {
                    "summary": "EVM: the launch names a quote token that cannot be resolved right now.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "the launch quote cannot be resolved right now, retry in a moment"
                    }
                  },
                  "internal_error_6": {
                    "summary": "EVM: `target_volume_usd` is set and the chain's native price is unavailable.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "native price unavailable for USD target"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only: nothing is saved or sent."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/volume-bot/#estimate-volume-bot"
        }
      }
    },
    "/launch/volume/cancel/{launch_id}": {
      "post": {
        "operationId": "volume-bot.cancel-volume-bot",
        "summary": "Cancel a Volume Bot session",
        "description": "Stops the launch's planned or running Volume Bot session.\n\nOn Solana it marks the launch's latest session `Cancelled` whatever its state, including a `Planned` or finished one, and answers `ok` when there is none. On EVM only a `Running` session is cancelled; a `Planned` one stays planned until [discarded](/reference/volume-bot/#discard-volume-bot).",
        "tags": [
          "Volume Bot"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Volume bot cancelled"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Cancelling again has no further effect."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/volume-bot/#cancel-volume-bot"
        }
      }
    },
    "/launch/volume/discard/{launch_id}": {
      "post": {
        "operationId": "volume-bot.discard-volume-bot",
        "summary": "Discard a Volume Bot session",
        "description": "Clears a planned or finished Volume Bot session from the launch.\n\nOn Solana a running session is refused with `409`. On EVM the call answers `ok` and leaves a running session in place.",
        "tags": [
          "Volume Bot"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Volume bot session discarded"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Solana: a Volume Bot session is running. EVM does not refuse: it answers `ok` and leaves the running session in place. Stop it with [Cancel a Volume Bot session](/reference/volume-bot/#cancel-volume-bot) first, then discard.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Solana: a Volume Bot session is running. EVM does not refuse: it answers `ok` and leaves the running session in place.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot discard running session"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Discarding again has no further effect."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/volume-bot/#discard-volume-bot"
        }
      }
    },
    "/launch/cleanup/run/{launch_id}": {
      "post": {
        "operationId": "cleanup.run-cleanup",
        "summary": "Start a Cleanup session",
        "description": "Starts moving tokens from the input wallets to the output wallets.\n\nThe launch must be live. Delays must lie within 500–300000 ms with `min_delay_ms` not above `max_delay_ms`, and `double_buy_pct` within 0–100. On EVM, before the session opens, the funder tops up every wallet short of gas for its rounds; the call fails without starting a session if the funder cannot cover them all.\n\nMoves tokens between launch wallets on-chain and spends native balances on fees.",
        "tags": [
          "Cleanup"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "input_wallet_pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Solana: wallets whose tokens are moved out (sellers). Required on Solana."
                  },
                  "output_wallet_pubkeys": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Solana: wallets that receive the tokens (buyers). Required on Solana."
                  },
                  "input_addresses": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "EVM: wallets whose tokens are moved out. Required on EVM chains."
                  },
                  "output_addresses": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "EVM: wallets that receive the tokens. Required on EVM chains."
                  },
                  "min_delay_ms": {
                    "type": "integer",
                    "description": "Minimum delay between rounds in milliseconds (500–300000)."
                  },
                  "max_delay_ms": {
                    "type": "integer",
                    "description": "Maximum delay between rounds in milliseconds, at least `min_delay_ms` and at most 300000."
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "buyback",
                      "streamflow_airdrop"
                    ],
                    "description": "Solana: how tokens move. `buyback` sells input tokens to the output wallets through an on-chain buyback; `streamflow_airdrop` distributes them through a Streamflow airdrop. EVM accepts only `buyback`.",
                    "default": "buyback"
                  },
                  "double_buy_pct": {
                    "type": "integer",
                    "description": "Solana, `buyback` only: double-buy percentage, 0–100. EVM refuses any value other than 0."
                  },
                  "fake_tip_pct": {
                    "type": "integer",
                    "description": "Typed by the web client but ignored on Solana, whose request has no such field. EVM refuses any value other than 0."
                  }
                },
                "required": [
                  "min_delay_ms",
                  "max_delay_ms"
                ]
              },
              "example": {
                "input_wallet_pubkeys": [
                  "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                  "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                ],
                "output_wallet_pubkeys": [
                  "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX"
                ],
                "min_delay_ms": 2000,
                "max_delay_ms": 8000,
                "double_buy_pct": 10,
                "fake_tip_pct": 0
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Cleanup started"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one. Call it with the winning member's launch ID once the group resolves.\n\n`bad_request`: The body is not valid JSON, or a field is missing or has the wrong type. Fix the field named in `message` and send the request again.\n\n`bad_request`: A required top-level field is missing, e.g. Solana `input_wallet_pubkeys` sent to an EVM launch, which expects `input_addresses`, or the reverse. Send the wallet fields that match the launch chain: `input_wallet_pubkeys`/`output_wallet_pubkeys` on Solana, `input_addresses`/`output_addresses` on EVM.\n\n`bad_request`: EVM: the token is still a draft. The token must be launched before a cleanup starts. Launch the token first with [Launch a token](/reference/launch-execution/#launch).\n\n`bad_request`: EVM: a Cleanup session is already running for this launch. Solana sends the same message with 500 `internal_error`. Wait for it to end or stop it with [Cancel a Cleanup session](/reference/cleanup/#cancel-cleanup) first.\n\n`bad_request`: `min_delay_ms` is outside 500–300000. Solana sends the same message with 500 `internal_error`. Set `min_delay_ms` between 500 and 300000.\n\n`bad_request`: `max_delay_ms` is below `min_delay_ms` or above 300000. Solana sends the same message with 500 `internal_error`. Set `max_delay_ms` between `min_delay_ms` and 300000.\n\n`bad_request`: EVM: no input wallet holds the token. Solana sends the same message with 500 `internal_error`. List input wallets that hold the token.\n\n`bad_request`: EVM: `input_addresses` is empty. List at least one input wallet.\n\n`bad_request`: EVM: `output_addresses` is empty. List at least one output wallet.\n\n`bad_request`: EVM: `method` is set to something other than `buyback`. Omit `method` or send `buyback`.\n\n`bad_request`: EVM: `double_buy_pct` is above 0. Omit `double_buy_pct` or send 0.\n\n`bad_request`: EVM: `fake_tip_pct` is above 0. Omit `fake_tip_pct` or send 0.\n\n`bad_request`: EVM: the launch's platform has no cleanup. Move the tokens with [Transfer tokens](/reference/launch-trading/#transfer-tokens) instead.\n\n`bad_request`: EVM: a listed address is neither a launch wallet nor one of the license's wallets. List only wallets of this launch or license.\n\n`bad_request`: EVM: the funder cannot cover the gas top-ups the rounds need plus its own reserve. Nothing was sent. Fund the launch funder with at least the amount named in `message`, then start again.\n\n`bad_request`: EVM: after the funder topped up the wallets, some are still short of gas. The top-ups already sent stay on the wallets. Fund the wallets named in `message`, then start again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "EVM: `launch_id` is a multi-launch group container. This route loads the launch itself, so it answers with the launch-level wording rather than the session one.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: not available here; use the winner launch once it resolves"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The body is not valid JSON, or a field is missing or has the wrong type.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: <path>: <cause>"
                    }
                  },
                  "bad_request_4": {
                    "summary": "A required top-level field is missing, e.g. Solana `input_wallet_pubkeys` sent to an EVM launch, which expects `input_addresses`, or the reverse.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid body: missing field `<field>` at line <line> column <column>"
                    }
                  },
                  "bad_request_5": {
                    "summary": "EVM: the token is still a draft. The token must be launched before a cleanup starts.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "token not launched"
                    }
                  },
                  "bad_request_6": {
                    "summary": "EVM: a Cleanup session is already running for this launch. Solana sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Cleanup task already running"
                    }
                  },
                  "bad_request_7": {
                    "summary": "`min_delay_ms` is outside 500–300000. Solana sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "min_delay_ms must be between 500 and 300000"
                    }
                  },
                  "bad_request_8": {
                    "summary": "`max_delay_ms` is below `min_delay_ms` or above 300000. Solana sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "max_delay_ms must be >= min_delay_ms and <= 300000"
                    }
                  },
                  "bad_request_9": {
                    "summary": "EVM: no input wallet holds the token. Solana sends the same message with 500 `internal_error`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "No input wallets have tokens to sell"
                    }
                  },
                  "bad_request_10": {
                    "summary": "EVM: `input_addresses` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "input_addresses cannot be empty"
                    }
                  },
                  "bad_request_11": {
                    "summary": "EVM: `output_addresses` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "output_addresses cannot be empty"
                    }
                  },
                  "bad_request_12": {
                    "summary": "EVM: `method` is set to something other than `buyback`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "only the buyback method exists on evm launches"
                    }
                  },
                  "bad_request_13": {
                    "summary": "EVM: `double_buy_pct` is above 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "double_buy_pct is not supported on evm launches"
                    }
                  },
                  "bad_request_14": {
                    "summary": "EVM: `fake_tip_pct` is above 0.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "fake_tip_pct is not supported on evm cleanup"
                    }
                  },
                  "bad_request_15": {
                    "summary": "EVM: the launch's platform has no cleanup.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Cleanup is not supported on this platform"
                    }
                  },
                  "bad_request_16": {
                    "summary": "EVM: a listed address is neither a launch wallet nor one of the license's wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Some wallets not found"
                    }
                  },
                  "bad_request_17": {
                    "summary": "EVM: the funder cannot cover the gas top-ups the rounds need plus its own reserve. Nothing was sent.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "funder <funder> has <balance> wei but cleanup needs <needed> in top-ups (+reserve <reserve>) — aborting before start"
                    }
                  },
                  "bad_request_18": {
                    "summary": "EVM: after the funder topped up the wallets, some are still short of gas. The top-ups already sent stay on the wallets.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<count> wallet(s) still short of gas after the top-up, cleanup not started: <wallets>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: Solana, `buyback`: every input wallet holding tokens is short of the SOL its sell needs. Fund the input wallets with SOL, then start again.\n\n`unprocessable`: Solana, `buyback`: every output wallet is short of the SOL its buy needs. Fund the output wallets with SOL, then start again.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "Solana, `buyback`: every input wallet holding tokens is short of the SOL its sell needs.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No input wallet holds enough SOL to pay for its sell"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "Solana, `buyback`: every output wallet is short of the SOL its buy needs.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "No output wallet holds enough SOL to pay for its buy"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "`internal_error`: Solana: the token is still a draft. EVM answers 400 `bad_request` with `token not launched`. Launch the token first with [Launch a token](/reference/launch-execution/#launch).\n\n`internal_error`: Solana: `input_wallet_pubkeys` is empty. List at least one input wallet.\n\n`internal_error`: Solana: `output_wallet_pubkeys` is empty. List at least one output wallet.\n\n`internal_error`: Solana: `double_buy_pct` is above 100. Set `double_buy_pct` between 0 and 100.\n\n`internal_error`: Solana: an entry of `input_wallet_pubkeys` is not a valid Solana address. Correct or remove the malformed input address.\n\n`internal_error`: Solana: an entry of `output_wallet_pubkeys` is not a valid Solana address. Correct or remove the malformed output address.\n\n`internal_error`: Solana: an input wallet is neither a launch wallet nor one of the license's wallets. List only wallets of this launch or license.\n\n`internal_error`: Solana: an output wallet is neither a launch wallet nor one of the license's wallets. List only wallets of this launch or license.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "internal_error": {
                    "summary": "Solana: the token is still a draft. EVM answers 400 `bad_request` with `token not launched`.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Token not launched"
                    }
                  },
                  "internal_error_2": {
                    "summary": "Solana: `input_wallet_pubkeys` is empty.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "input_wallet_pubkeys cannot be empty"
                    }
                  },
                  "internal_error_3": {
                    "summary": "Solana: `output_wallet_pubkeys` is empty.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "output_wallet_pubkeys cannot be empty"
                    }
                  },
                  "internal_error_4": {
                    "summary": "Solana: `double_buy_pct` is above 100.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "double_buy_pct must be between 0 and 100"
                    }
                  },
                  "internal_error_5": {
                    "summary": "Solana: an entry of `input_wallet_pubkeys` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Invalid input wallet pubkey"
                    }
                  },
                  "internal_error_6": {
                    "summary": "Solana: an entry of `output_wallet_pubkeys` is not a valid Solana address.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Invalid output wallet pubkey"
                    }
                  },
                  "internal_error_7": {
                    "summary": "Solana: an input wallet is neither a launch wallet nor one of the license's wallets.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Some input wallets not found"
                    }
                  },
                  "internal_error_8": {
                    "summary": "Solana: an output wallet is neither a launch wallet nor one of the license's wallets.",
                    "value": {
                      "ok": false,
                      "code": "internal_error",
                      "message": "Some output wallets not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Read [Retrieve Cleanup status](/reference/cleanup/#get-cleanup-status) first: `Running` means the first call went through, and a second run is refused while it runs. On EVM a failed call may already have topped up wallets from the funder; a repeat only tops up what is still short."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/cleanup/#run-cleanup"
        }
      }
    },
    "/launch/cleanup/status/{launch_id}": {
      "get": {
        "operationId": "cleanup.get-cleanup-status",
        "summary": "Retrieve Cleanup status",
        "description": "Returns the launch's Cleanup session and its progress.",
        "tags": [
          "Cleanup"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a Cleanup status object.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "enum": [
                        "None",
                        "Planned",
                        "Running",
                        "Completed",
                        "Cancelled",
                        "Failed"
                      ],
                      "description": "Session state. The client also accepts lowercase values."
                    },
                    "info": {
                      "type": "object",
                      "properties": {
                        "params": {
                          "type": "object",
                          "description": "The parameters the session was started with."
                        },
                        "started_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session started."
                        },
                        "ended_at": {
                          "anyOf": [
                            {
                              "type": "integer"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unix timestamp (seconds) the session ended."
                        },
                        "status_reason": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Why the session ended or failed, when known."
                        },
                        "rounds_completed": {
                          "type": "integer",
                          "description": "Rounds completed."
                        },
                        "rounds_total": {
                          "type": "integer",
                          "description": "Rounds planned."
                        }
                      },
                      "required": [
                        "params",
                        "started_at",
                        "ended_at",
                        "status_reason",
                        "rounds_completed",
                        "rounds_total"
                      ],
                      "description": "Session details. Absent when `status` is `None`."
                    }
                  },
                  "required": [
                    "status"
                  ]
                },
                "example": {
                  "status": "Running",
                  "info": {
                    "params": {
                      "input_wallet_pubkeys": [
                        "3pGh8WcR5vTn2YkLz9QmXbE7aDs4FjU6wHrN1tKyPqVe",
                        "6rVb2NqT8xK4mWc9HsZpG7eYjD3uLfA5tRnE1kQwXzMh"
                      ],
                      "output_wallet_pubkeys": [
                        "BqW7nR3tY5kP9xC2vM8hL4dJ6sF1aZ3gE7uN5rT2yKpX"
                      ],
                      "min_delay_ms": 2000,
                      "max_delay_ms": 8000,
                      "double_buy_pct": 10,
                      "method": "buyback"
                    },
                    "started_at": 1793655010,
                    "ended_at": null,
                    "status_reason": null,
                    "rounds_completed": 3,
                    "rounds_total": 8
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/cleanup/#get-cleanup-status"
        }
      }
    },
    "/launch/cleanup/cancel/{launch_id}": {
      "post": {
        "operationId": "cleanup.cancel-cleanup",
        "summary": "Cancel a Cleanup session",
        "description": "Stops the launch's running Cleanup session.\n\nOn Solana it answers `ok` even when there is no session, and marks a finished session `Cancelled` too. On EVM it answers `404` when the launch has no Cleanup session.",
        "tags": [
          "Cleanup"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Cleanup cancelled"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.\n\n`not_found`: EVM: the launch has no Cleanup session. Solana answers `ok` instead. Check [Retrieve Cleanup status](/reference/cleanup/#get-cleanup-status); there is nothing to cancel.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "EVM: the launch has no Cleanup session. Solana answers `ok` instead.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "no cleanup session"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Cancelling again has no further effect."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/cleanup/#cancel-cleanup"
        }
      }
    },
    "/launch/cleanup/discard/{launch_id}": {
      "post": {
        "operationId": "cleanup.discard-cleanup",
        "summary": "Discard a Cleanup session",
        "description": "Clears a finished Cleanup session from the launch.",
        "tags": [
          "Cleanup"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch ID: the 15-digit chain-encoded ID. Its first three digits name the chain (`101` Solana, `201` BSC, `202` Base, `204` Ethereum).",
            "schema": {
              "type": "string"
            },
            "example": "101000000004217"
          }
        ],
        "responses": {
          "200": {
            "description": "Returns `ok` and a confirmation `message`.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Cleanup session discarded"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a chain-encoded launch ID. Pass the 15-digit chain-encoded launch ID exactly as the API returned it.\n\n`bad_request`: `launch_id` is a multi-launch group container; sessions run on the winning member launch. Call it with the winning member's launch ID once the group resolves.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a chain-encoded launch ID.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`launch_id` is a multi-launch group container; sessions run on the winning member launch.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "multi-launch container: sessions run on the winner launch once it resolves"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`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.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch with this ID belongs to the license in your token.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: A Cleanup session is running for this launch. Stop it with [Cancel a Cleanup session](/reference/cleanup/#cancel-cleanup) first, then discard.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "A Cleanup session is running for this launch.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "Cannot discard running session"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Discarding again has no further effect."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/cleanup/#discard-cleanup"
        }
      }
    },
    "/market/chains": {
      "get": {
        "operationId": "market.list-chains",
        "summary": "List market chains",
        "description": "Lists the chains covered by the market data.\n\nThe SDK returns the `chains` array. The app keeps only chains it supports, then fetches each chain's series.",
        "tags": [
          "Market Overview"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "chains": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "chain": {
                            "type": "string",
                            "description": "Provider chain identifier, e.g. `solana`, `bnb`, `ethereum`, `base`."
                          },
                          "display_name": {
                            "type": "string",
                            "description": "Human-readable chain name."
                          },
                          "through": {
                            "type": "string",
                            "description": "Latest day with data (`YYYY-MM-DD`)."
                          }
                        },
                        "required": [
                          "chain",
                          "display_name",
                          "through"
                        ]
                      },
                      "description": "Covered chains."
                    }
                  },
                  "required": [
                    "chains"
                  ]
                },
                "example": {
                  "chains": [
                    {
                      "chain": "solana",
                      "display_name": "Solana",
                      "through": "2026-11-01"
                    },
                    {
                      "chain": "bnb",
                      "display_name": "BNB Chain",
                      "through": "2026-11-01"
                    },
                    {
                      "chain": "base",
                      "display_name": "Base",
                      "through": "2026-11-01"
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "tehcscreener failed and the backend holds no cached copy of this dataset.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tehcscreener api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/market/#list-chains"
        }
      }
    },
    "/market/chains/{chain}": {
      "get": {
        "operationId": "market.retrieve-chain",
        "summary": "Retrieve chain activity",
        "description": "Returns daily transactions, active wallets and DEX volume for one chain.",
        "tags": [
          "Market Overview"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "description": "Provider chain identifier from [List market chains](#list-chains).",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string",
                      "description": "Provider chain identifier."
                    },
                    "through": {
                      "type": "string",
                      "description": "Latest day with data."
                    },
                    "days": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Days of the series (`YYYY-MM-DD`)."
                    },
                    "txns": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      },
                      "description": "Transactions per day."
                    },
                    "active_wallets": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      },
                      "description": "Active wallets per day."
                    },
                    "dex_volume_usd": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      },
                      "description": "DEX volume in USD per day."
                    },
                    "dex_trades": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      },
                      "description": "DEX trades per day."
                    }
                  },
                  "required": [
                    "chain",
                    "through",
                    "days",
                    "txns",
                    "active_wallets",
                    "dex_volume_usd",
                    "dex_trades"
                  ]
                },
                "example": {
                  "chain": "solana",
                  "through": "2026-11-01",
                  "days": [
                    "2026-10-30",
                    "2026-10-31",
                    "2026-11-01"
                  ],
                  "txns": [
                    81244310,
                    79310022,
                    83102877
                  ],
                  "active_wallets": [
                    4120331,
                    3988214,
                    4211907
                  ],
                  "dex_volume_usd": [
                    3812440120.4,
                    3655201988.1,
                    4022118733.9
                  ],
                  "dex_trades": [
                    21330442,
                    20877120,
                    22410093
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`. Use a chain ID from [List market chains](/reference/market/#list-chains).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid id: <chain>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The data provider has no data for this chain. Use a chain ID from [List market chains](/reference/market/#list-chains).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The data provider has no data for this chain.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "no market data"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "tehcscreener failed and the backend holds no cached copy of this dataset.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tehcscreener api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/market/#retrieve-chain"
        }
      }
    },
    "/market/launchpads": {
      "get": {
        "operationId": "market.list-launchpads",
        "summary": "List launchpad activity",
        "description": "Returns daily volume and tokens launched for every covered launchpad.\n\nAll series share the top-level `days` axis.",
        "tags": [
          "Market Overview"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "through": {
                      "type": "string",
                      "description": "Latest day with data."
                    },
                    "days": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Days shared by every series (`YYYY-MM-DD`)."
                    },
                    "series": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "chain": {
                            "type": "string",
                            "description": "Provider chain identifier."
                          },
                          "pad": {
                            "type": "string",
                            "description": "Provider launchpad identifier, e.g. `pumpfun`, `letsbonk`, `ponsfamily.com`."
                          },
                          "volume_usd": {
                            "type": "array",
                            "items": {
                              "type": "number"
                            },
                            "description": "Volume in USD per day."
                          },
                          "tokens_launched": {
                            "type": "array",
                            "items": {
                              "type": "number"
                            },
                            "description": "Tokens created per day."
                          }
                        },
                        "required": [
                          "chain",
                          "pad",
                          "volume_usd",
                          "tokens_launched"
                        ]
                      },
                      "description": "One series per launchpad."
                    }
                  },
                  "required": [
                    "through",
                    "days",
                    "series"
                  ]
                },
                "example": {
                  "through": "2026-11-01",
                  "days": [
                    "2026-10-30",
                    "2026-10-31",
                    "2026-11-01"
                  ],
                  "series": [
                    {
                      "chain": "solana",
                      "pad": "pumpfun",
                      "volume_usd": [
                        402118320.5,
                        388220193.2,
                        421003877
                      ],
                      "tokens_launched": [
                        23110,
                        22870,
                        24180
                      ]
                    },
                    {
                      "chain": "solana",
                      "pad": "letsbonk",
                      "volume_usd": [
                        18220331,
                        17110290.4,
                        19004112.8
                      ],
                      "tokens_launched": [
                        1320,
                        1288,
                        1402
                      ]
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "tehcscreener failed and the backend holds no cached copy of this dataset.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tehcscreener api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/market/#list-launchpads"
        }
      }
    },
    "/market/launchpads/{chain}/{pad}": {
      "get": {
        "operationId": "market.retrieve-launchpad",
        "summary": "Retrieve launchpad activity",
        "description": "Returns daily tokens launched, volume and trades for one launchpad.\n\nCalled when a launchpad is selected in the Market Overview panel.",
        "tags": [
          "Market Overview"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "description": "Provider chain identifier.",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          },
          {
            "name": "pad",
            "in": "path",
            "required": true,
            "description": "Provider launchpad identifier. URL-encoded by the SDK.",
            "schema": {
              "type": "string"
            },
            "example": "pumpfun"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "chain": {
                      "type": "string",
                      "description": "Provider chain identifier."
                    },
                    "pad": {
                      "type": "string",
                      "description": "Provider launchpad identifier."
                    },
                    "daily": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "day": {
                            "type": "string",
                            "description": "Day (`YYYY-MM-DD`)."
                          },
                          "tokens_launched": {
                            "type": "number",
                            "description": "Tokens created that day."
                          },
                          "volume_usd": {
                            "type": "number",
                            "description": "Volume in USD."
                          },
                          "trade_txns": {
                            "type": "number",
                            "description": "Trade transactions."
                          }
                        },
                        "required": [
                          "day",
                          "tokens_launched",
                          "volume_usd",
                          "trade_txns"
                        ]
                      },
                      "description": "One entry per day."
                    }
                  },
                  "required": [
                    "chain",
                    "pad",
                    "daily"
                  ]
                },
                "example": {
                  "chain": "solana",
                  "pad": "pumpfun",
                  "daily": [
                    {
                      "day": "2026-10-31",
                      "tokens_launched": 22870,
                      "volume_usd": 388220193.2,
                      "trade_txns": 8812044
                    },
                    {
                      "day": "2026-11-01",
                      "tokens_launched": 24180,
                      "volume_usd": 421003877,
                      "trade_txns": 9120331
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain` or `pad` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`. Use an identifier from [List market chains](/reference/market/#list-chains) or [List launchpad activity](/reference/market/#list-launchpads).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain` or `pad` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid id: <id>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The data provider has no data for this launchpad. Use a launchpad from [List launchpad activity](/reference/market/#list-launchpads).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The data provider has no data for this launchpad.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "no market data"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "tehcscreener failed and the backend holds no cached copy of this dataset.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tehcscreener api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/market/#retrieve-launchpad"
        }
      }
    },
    "/market/launchpads/{chain}/{pad}/revenue": {
      "get": {
        "operationId": "market.retrieve-launchpad-revenue",
        "summary": "Retrieve launchpad revenue",
        "description": "Returns daily protocol revenue, creator revenue and buybacks for one launchpad.\n\nA launchpad the data provider has no revenue data for answers `200` with an empty `daily`, not `404`.",
        "tags": [
          "Market Overview"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "description": "Provider chain identifier.",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          },
          {
            "name": "pad",
            "in": "path",
            "required": true,
            "description": "Provider launchpad identifier. URL-encoded by the SDK.",
            "schema": {
              "type": "string"
            },
            "example": "pumpfun"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "daily": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "day": {
                            "type": "string",
                            "description": "Day (`YYYY-MM-DD`)."
                          },
                          "protocol_revenue_usd": {
                            "type": "number",
                            "description": "Protocol revenue in USD."
                          },
                          "creator_revenue_usd": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Revenue paid to token creators in USD, or `null` when not tracked for this launchpad."
                          },
                          "buyback_usd": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Buybacks in USD, or `null` when not tracked for this launchpad."
                          }
                        },
                        "required": [
                          "day",
                          "protocol_revenue_usd",
                          "creator_revenue_usd",
                          "buyback_usd"
                        ]
                      },
                      "description": "One entry per day. Empty when the launchpad has no revenue coverage."
                    }
                  },
                  "required": [
                    "daily"
                  ]
                },
                "example": {
                  "daily": [
                    {
                      "day": "2026-10-31",
                      "protocol_revenue_usd": 1203344.18,
                      "creator_revenue_usd": 388120.02,
                      "buyback_usd": null
                    },
                    {
                      "day": "2026-11-01",
                      "protocol_revenue_usd": 1311870.4,
                      "creator_revenue_usd": 402771.95,
                      "buyback_usd": null
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain` or `pad` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`. Use an identifier from [List market chains](/reference/market/#list-chains) or [List launchpad activity](/reference/market/#list-launchpads).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain` or `pad` is empty, longer than 64 characters, or has characters other than letters, digits, `.`, `-` and `_`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid id: <id>"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "tehcscreener failed and the backend holds no cached copy of this dataset.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tehcscreener api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/market/#retrieve-launchpad-revenue"
        }
      }
    },
    "/market/trench": {
      "get": {
        "operationId": "market.retrieve-trench",
        "summary": "Retrieve the trench score",
        "description": "Returns today's trench score with its band, and the daily score history.\n\nThe score runs from 0 to 100. The app labels its ends **Ded** and **Euphoric** and colors the bands `ded`, `cold`, `active`, `hot` and `euphoric`.",
        "tags": [
          "Market Overview"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "today": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "day": {
                              "type": "string",
                              "description": "Day of the score (`YYYY-MM-DD`)."
                            },
                            "score": {
                              "type": "number",
                              "description": "Score from 0 to 100."
                            },
                            "band": {
                              "type": "string",
                              "description": "Band label, e.g. `cold`, `active`, `hot`."
                            }
                          },
                          "required": [
                            "day",
                            "score",
                            "band"
                          ]
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Latest score, or `null` when none is available."
                    },
                    "history": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "day": {
                            "type": "string",
                            "description": "Day (`YYYY-MM-DD`)."
                          },
                          "score": {
                            "type": "number",
                            "description": "Score from 0 to 100."
                          }
                        },
                        "required": [
                          "day",
                          "score"
                        ]
                      },
                      "description": "Past daily scores."
                    }
                  },
                  "required": [
                    "today",
                    "history"
                  ]
                },
                "example": {
                  "today": {
                    "day": "2026-11-01",
                    "score": 62.4,
                    "band": "active"
                  },
                  "history": [
                    {
                      "day": "2026-10-30",
                      "score": 55.1
                    },
                    {
                      "day": "2026-10-31",
                      "score": 58.9
                    },
                    {
                      "day": "2026-11-01",
                      "score": 62.4
                    }
                  ]
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: tehcscreener failed and the backend holds no cached copy of this dataset. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "tehcscreener failed and the backend holds no cached copy of this dataset.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "tehcscreener api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/market/#retrieve-trench"
        }
      }
    },
    "/get-prices": {
      "get": {
        "operationId": "prices.retrieve-prices",
        "summary": "Retrieve prices",
        "description": "Returns native asset prices per chain and quote token prices per chain, in micro-USD.\n\nTop-level keys are chain IDs; the current backend sends all seven below, read from its price cache. `quotes` maps each chain ID to an object keyed by token mint (Solana) or contract address (EVM).",
        "tags": [
          "Prices"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "sol": {
                      "type": "integer",
                      "description": "SOL price in micro-USD."
                    },
                    "eth": {
                      "type": "integer",
                      "description": "Ethereum native asset price in micro-USD."
                    },
                    "bsc": {
                      "type": "integer",
                      "description": "BNB Chain native asset price in micro-USD."
                    },
                    "base": {
                      "type": "integer",
                      "description": "Base native asset price in micro-USD."
                    },
                    "robinhood": {
                      "type": "integer",
                      "description": "Robinhood Chain native asset price in micro-USD."
                    },
                    "arc": {
                      "type": "integer",
                      "description": "Arc native asset price in micro-USD. Arc's native asset is a dollar stablecoin, served at its peg (`1000000`)."
                    },
                    "xlayer": {
                      "type": "integer",
                      "description": "X Layer native asset price in micro-USD."
                    },
                    "quotes": {
                      "type": "object",
                      "description": "Quote token prices: `{ [chain_id]: { [mint_or_address]: micro_usd } }`. A quote the backend cannot value is absent rather than `0`. The chain's own native asset is never listed here."
                    }
                  }
                },
                "example": {
                  "sol": 168420000,
                  "eth": 3912550000,
                  "bsc": 1094120000,
                  "base": 3912550000,
                  "robinhood": 3912550000,
                  "arc": 1000000,
                  "xlayer": 171230000,
                  "quotes": {
                    "sol": {
                      "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": 1000002
                    },
                    "bsc": {
                      "0xffe463433bfe884b7dc37be8fc7b86b75c7a1215": 999870
                    },
                    "base": {},
                    "eth": {},
                    "robinhood": {},
                    "arc": {},
                    "xlayer": {}
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/prices/#retrieve-prices"
        }
      }
    },
    "/charts/{launch_id}/subscribe": {
      "get": {
        "operationId": "charts.create-chart-token",
        "summary": "Create a chart token",
        "description": "Issues a datafeed token scoped to the mint of a launch the caller owns or holds a share on.\n\nThe token is a JWT whose `mint` claim names the launch's token; the web app uses it to authenticate the datafeed WebSocket for that mint and calls this endpoint again when a renewal is due. The call also registers the token's pools with the indexer.\n\nThe SDK retries when the response carries no `token` or the call fails, up to `maxRetries` times (default 5) with a linear backoff of 1 s, 2 s, 3 s... The datafeed provider passes `maxRetries = 0` and runs its own exponential backoff instead.\n\nA grantee whose share carries `launch.read` gets a token too. It expires 5 minutes after the call, or at the grant's expiry if that comes first; the owner's token lasts as long as a session.\n\nA launch still waiting for its deploy can fail for minutes; callers should retry with backoff rather than treat each failure as fatal.",
        "tags": [
          "Charts"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` on success."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Chain ID of the launch."
                    },
                    "mint": {
                      "type": "string",
                      "description": "Token mint or contract address the token is scoped to."
                    },
                    "token": {
                      "type": "string",
                      "description": "Datafeed JWT carrying `mint` and `exp` claims. Valid for one week."
                    }
                  },
                  "required": [
                    "token"
                  ]
                },
                "example": {
                  "ok": true,
                  "chain": "sol",
                  "mint": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
                  "token": "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJtaW50IjoiRmU3ZFRVd1l2THc3em52WHFpakFOWmd6dGlEVldpRTRKM2NqRHM2UmlhWiIsImV4cCI6MTc5NDIxOTMwMH0.ZXhhbXBsZS1zaWduYXR1cmUtbm90LXZhbGlk"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID is not a valid `ext_id`. Pass the 15-digit launch `ext_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID is not a valid `ext_id`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller reaches the launch through a share that does not carry `launch.read`. Ask the owner to add `launch.read` to your grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller reaches the launch through a share that does not carry `launch.read`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'launch.read'"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The launch does not exist, or the caller neither owns it nor holds a live share on it. Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches).\n\n`not_found`: The launch is on an EVM chain and its token is not deployed yet. Request the token again with backoff once the deploy has landed.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The launch does not exist, or the caller neither owns it nor holds a live share on it.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "The launch is on an EVM chain and its token is not deployed yet.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Token not launched yet"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call issues a new token and may register the token's pools with the indexer again; nothing else changes."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/charts/#create-chart-token"
        }
      }
    },
    "/charts/{audience}/token": {
      "get": {
        "operationId": "charts.create-unscoped-token",
        "summary": "Create an unscoped datafeed token",
        "description": "Issues a five-minute datafeed token to the account for the screener or the wallet reads.\n\nThe SDK throws when the response has no `token`, and defaults `expires_in` to `300` when it is missing. The app caches the token and fetches a new one 60 seconds before `exp`, or immediately when the datafeed answers 401.\n\nThe screener and wallet pages are behind feature flags and are enabled by default only on the dev deployment.",
        "tags": [
          "Charts"
        ],
        "parameters": [
          {
            "name": "audience",
            "in": "path",
            "required": true,
            "description": "Datafeed audience the token is issued for.",
            "schema": {
              "type": "string",
              "enum": [
                "screener",
                "wallet"
              ]
            },
            "example": "screener"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "type": "string",
                      "description": "Datafeed JWT."
                    },
                    "expires_in": {
                      "type": "integer",
                      "description": "Lifetime in seconds."
                    }
                  },
                  "required": [
                    "token"
                  ]
                },
                "example": {
                  "token": "eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3OTM2MTQ4MDB9.ZXhhbXBsZS1zaWduYXR1cmUtbm90LXZhbGlk",
                  "expires_in": 300
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: `audience` is `screener` and the caller is not an admin. Call it with an admin account's session.\n\n`forbidden`: `audience` is `wallet` and the caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "`audience` is `screener` and the caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "the screener is admin-only"
                    }
                  },
                  "forbidden_2": {
                    "summary": "`audience` is `wallet` and the caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "the wallet explorer is admin-only"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: More than 30 tokens for this audience in a minute for this account. For `wallet`, the message names `wallet_token`. Reuse the token until 60 seconds before its `exp`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "More than 30 tokens for this audience in a minute for this account. For `wallet`, the message names `wallet_token`.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "rate limit exceeded for screener_token, please retry later"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Each call issues a new token and counts toward the limit of 30 per minute."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/charts/#create-unscoped-token"
        }
      }
    },
    "/history": {
      "get": {
        "operationId": "history.list-events",
        "summary": "List activity events",
        "description": "Lists the caller's activity events, newest first.\n\nBacks the **Logs** page and the funder history. The SDK always sends `cursor`, using `0` for the first page; the app requests 50 events per page.\n\n`id` and `launch_ext_id` can exceed 2^53. They arrive as strings, and the client also rewrites them to strings if a bare number appears, so never parse them as JavaScript numbers.",
        "tags": [
          "Activity history"
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": true,
            "description": "`next_cursor` of the previous page, or `0` for the first page.",
            "schema": {
              "type": "string",
              "default": "0"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Events per page, from 1 to 100.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Comma-separated event types to include, e.g. `launch.create,launch.deploy_mev`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "launch_ext_id",
            "in": "query",
            "required": false,
            "description": "Restrict to one launch.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Restrict to one chain.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "bsc",
                "eth",
                "base",
                "robinhood",
                "xlayer"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Lower bound on `created_at` in Unix seconds, inclusive.",
            "schema": {
              "type": "string"
            },
            "example": "1790985600"
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Upper bound on `created_at` in Unix seconds, inclusive.",
            "schema": {
              "type": "string"
            },
            "example": "1793663999"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "events": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Activity event](#object-activity-event) objects."
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor for the next page, or `null` when there are no more events."
                    }
                  },
                  "required": [
                    "events",
                    "next_cursor"
                  ]
                },
                "example": {
                  "events": [
                    {
                      "id": "884213",
                      "created_at": 1793614500,
                      "event_type": "launch.deploy_mev",
                      "chain_id": "sol",
                      "launch_ext_id": "101920010239643",
                      "payload": {
                        "tx_hashes": [
                          "NeC5ayJvChpkwNvpzKBU8aBUhvPMw6EEL21rEz1dB3PVBcWo5L6tDk3fGwhRdQnkPeRS5A19mCBPgsddwAdyM8ND"
                        ],
                        "mint": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
                        "platform": "pumpfun"
                      }
                    },
                    {
                      "id": "884207",
                      "created_at": 1793613492,
                      "event_type": "withdraw",
                      "chain_id": "sol",
                      "launch_ext_id": null,
                      "payload": {
                        "origin": "global",
                        "status": "completed",
                        "src_asset": "native",
                        "amount_native_atomic": "2500000000"
                      }
                    }
                  ],
                  "next_cursor": "884207"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain` is not one of the supported chains. Send `sol`, `bsc`, `eth`, `base`, `robinhood` or `xlayer`, or omit `chain`.\n\n`bad_request`: `cursor` is not a 64-bit integer. Send `0` for the first page, then the previous page's `next_cursor`.\n\n`bad_request`: `launch_ext_id` is not a 64-bit integer. Send the launch `ext_id` as a decimal string.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain` is not one of the supported chains.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid chain '<chain>' (expected sol|bsc|eth|base|robinhood|xlayer)"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`cursor` is not a 64-bit integer.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid cursor (must be an int64)"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`launch_ext_id` is not a 64-bit integer.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch_ext_id (must be an int64)"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/history/#list-events"
        }
      }
    },
    "/history/launch/{launch_id}": {
      "get": {
        "operationId": "history.list-launch-events",
        "summary": "List a launch's activity events",
        "description": "Lists the activity events of one launch, newest first.\n\nBacks the history panel of a live launch, which refreshes it every 2 seconds. Takes the same query parameters as [List activity events](#list-events) except `launch_ext_id`; the path wins.\n\nOn a launch shared through Launch Sharing, a grantee with `history.read` receives the events with `payload` removed.\n\nA launch the caller neither owns nor holds a share on answers an empty page, not `404`.",
        "tags": [
          "Activity history"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "The launch `ext_id`.",
            "schema": {
              "type": "string"
            },
            "example": "101920010239643"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": true,
            "description": "`next_cursor` of the previous page, or `0` for the first page.",
            "schema": {
              "type": "string",
              "default": "0"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Events per page, from 1 to 100.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Comma-separated event types to include.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Restrict to one chain.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "bsc",
                "eth",
                "base",
                "robinhood",
                "xlayer"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Lower bound in Unix seconds, inclusive.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Upper bound in Unix seconds, inclusive.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "events": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Activity event](#object-activity-event) objects."
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor for the next page, or `null`."
                    }
                  },
                  "required": [
                    "events",
                    "next_cursor"
                  ]
                },
                "example": {
                  "events": [
                    {
                      "id": "884230",
                      "created_at": 1793614504,
                      "event_type": "autosell.run",
                      "chain_id": "sol",
                      "launch_ext_id": "101920010239643",
                      "payload": {
                        "session_id": "f5281570-a530-4505-b29e-b5e2b64ea166",
                        "wallet_count": 8
                      }
                    }
                  ],
                  "next_cursor": null
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The launch ID in the path is not a 64-bit integer. Pass the launch `ext_id` as a decimal string.\n\n`bad_request`: `chain` is not one of the supported chains. Send `sol`, `bsc`, `eth`, `base`, `robinhood` or `xlayer`, or omit `chain`.\n\n`bad_request`: `cursor` is not a 64-bit integer. Send `0` for the first page, then the previous page's `next_cursor`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The launch ID in the path is not a 64-bit integer.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch_ext_id (must be an int64)"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`chain` is not one of the supported chains.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid chain '<chain>' (expected sol|bsc|eth|base|robinhood|xlayer)"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`cursor` is not a 64-bit integer.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid cursor (must be an int64)"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller reaches the launch through a share that does not carry `history.read`. Ask the owner to add `history.read` to your grant.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller reaches the launch through a share that does not carry `history.read`.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "this share does not carry 'history.read'"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/history/#list-launch-events"
        }
      }
    },
    "/admin/system-events": {
      "get": {
        "operationId": "history.list-system-events",
        "summary": "List system events",
        "description": "Lists events recorded by the platform itself rather than by an account.\n\nBacks the admin **Logs** page. Returns only events with no license, such as `system.boot` and `system.session_restart.*`. Takes the same query parameters as [List activity events](#list-events) except `launch_ext_id`.",
        "tags": [
          "Activity history"
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": true,
            "description": "`next_cursor` of the previous page, or `0` for the first page.",
            "schema": {
              "type": "string",
              "default": "0"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Events per page, from 1 to 100.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Comma-separated event types to include.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Restrict to one chain.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "bsc",
                "eth",
                "base",
                "robinhood",
                "xlayer"
              ]
            }
          },
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Lower bound in Unix seconds, inclusive.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Upper bound in Unix seconds, inclusive.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "events": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Activity event](#object-activity-event) objects."
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor for the next page, or `null`."
                    },
                    "dropped_total": {
                      "type": "integer",
                      "description": "Events the writer has shed since start because its queue was full. Not read by the web app."
                    }
                  },
                  "required": [
                    "events",
                    "next_cursor"
                  ]
                },
                "example": {
                  "events": [
                    {
                      "id": "884100",
                      "created_at": 1793577600,
                      "event_type": "system.boot",
                      "chain_id": null,
                      "launch_ext_id": null,
                      "payload": {
                        "version": "1.42.0",
                        "environment": "production"
                      }
                    }
                  ],
                  "next_cursor": null,
                  "dropped_total": 0
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `chain` is not one of the supported chains. Send `sol`, `bsc`, `eth`, `base`, `robinhood` or `xlayer`, or omit `chain`.\n\n`bad_request`: `cursor` is not a 64-bit integer. Send `0` for the first page, then the previous page's `next_cursor`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`chain` is not one of the supported chains.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid chain '<chain>' (expected sol|bsc|eth|base|robinhood|xlayer)"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`cursor` is not a 64-bit integer.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid cursor (must be an int64)"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/history/#list-system-events"
        }
      }
    },
    "/dashboard": {
      "get": {
        "operationId": "dashboard.retrieve-dashboard",
        "summary": "Retrieve dashboard aggregates",
        "description": "Returns the caller's activity totals over a window, grouped by the requested dimensions.\n\nWithout `since` and `until`, the window is the last 30 days ending now. Without `group_by`, rows are grouped by `event_type`.\n\nNot called by the current web app. The admin dashboard uses `GET /admin/dashboard`, which takes the same parameters.\n\nMoney fields are strings so large sums keep full precision. Parse them with a big-number type.",
        "tags": [
          "Dashboard"
        ],
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Window start in Unix seconds. Defaults to 30 days before `until`.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Window end in Unix seconds. Defaults to now.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Restrict to one chain ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "event_type",
            "in": "query",
            "required": false,
            "description": "Restrict to one event type.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "Restrict to one event source.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "group_by",
            "in": "query",
            "required": false,
            "description": "Comma-separated dimensions: `day`, `chain`, `event_type`, `source`, `platform`, `quote_mint`. The SDK also accepts an array and joins it.",
            "schema": {
              "type": "string",
              "default": "event_type"
            },
            "example": "day,chain"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "from": {
                      "type": "integer",
                      "description": "Window start used, in Unix seconds."
                    },
                    "to": {
                      "type": "integer",
                      "description": "Window end used, in Unix seconds."
                    },
                    "group_by": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Grouping columns applied. `chain` is reported as `chain_id`."
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "day": {
                            "type": "string",
                            "description": "UTC day (`YYYY-MM-DD`)."
                          },
                          "chain_id": {
                            "type": "string",
                            "description": "Chain ID."
                          },
                          "event_type": {
                            "type": "string",
                            "description": "Event type."
                          },
                          "source": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Event source."
                          },
                          "platform": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Launchpad."
                          },
                          "quote_mint": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Quote token mint or address."
                          },
                          "amount_usd": {
                            "type": "string",
                            "description": "Sum in micro-USD."
                          },
                          "amount_native": {
                            "type": "string",
                            "description": "Sum in native base units."
                          },
                          "amount_quote": {
                            "type": "string",
                            "description": "Sum in quote token base units."
                          },
                          "amount_token": {
                            "type": "string",
                            "description": "Sum in launched-token base units."
                          },
                          "fee_native": {
                            "type": "string",
                            "description": "Fees in native base units. Only in the admin variant of this aggregate."
                          },
                          "fee_usd": {
                            "type": "string",
                            "description": "Fees in micro-USD. Only in the admin variant of this aggregate."
                          },
                          "native_mixed": {
                            "type": "boolean",
                            "description": "`true` when the row spans several chains, so `amount_native` mixes units."
                          },
                          "count_sum": {
                            "type": "number",
                            "description": "Sum of the events' item counts."
                          },
                          "event_count": {
                            "type": "number",
                            "description": "Number of events in the row."
                          }
                        }
                      },
                      "description": "One row per group. Only the grouped dimensions are present."
                    }
                  },
                  "required": [
                    "from",
                    "to",
                    "group_by",
                    "rows"
                  ]
                },
                "example": {
                  "from": 1790985600,
                  "to": 1793614500,
                  "group_by": [
                    "chain_id",
                    "event_type"
                  ],
                  "rows": [
                    {
                      "chain_id": "sol",
                      "event_type": "buy",
                      "amount_usd": "18422310000",
                      "amount_native": "109400000000",
                      "amount_quote": "0",
                      "amount_token": "84211000000000",
                      "native_mixed": false,
                      "count_sum": 0,
                      "event_count": 412
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `group_by` names an unknown dimension. Use `day`, `chain`, `event_type`, `source`, `platform` or `quote_mint`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`group_by` names an unknown dimension.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid group_by dimension: <dimension>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/dashboard/#retrieve-dashboard"
        }
      }
    },
    "/tracker/stream": {
      "get": {
        "operationId": "tracker.stream-events",
        "summary": "Stream tracker events",
        "description": "Opens a server-sent event stream of the shared tracker session.\n\nThe response is `text/event-stream`. Events are separated by a blank line (`\\n\\n`); the client keeps only `data:` lines, strips the prefix, joins multi-line data with `\\n`, and parses the result as JSON. Each message has a `type`:\n\n- `status`: session state, with `status`, `error`, `latency` and `session`.\n- `event`: one realtime event in `d`. `d.event` is `twitter.post.new`, `twitter.post.update`, `twitter.following.new`, `twitter.following.removed`, `twitter.follower.new`, `twitter.profile.update` or `twitter.tweet.deleted`; `d.task_info.handle` names the tracked account and `d.data` carries the event data.\n- `handles`: the tracked set changed; reload [List tracked accounts](#list-handles).\n- `suggestions`: name/ticker suggestions ready for `tweet_id`.\n- `lagged`: `skipped` events were dropped.\n\nThe SDK makes a raw `fetch` with the bearer token and returns the `Response`; the caller reads and closes the body. On 401 or 403 the app stops and reports that the tracker is restricted to admins. On any other failure or end of stream it reconnects with exponential backoff capped at 30 seconds.\n\nThis call bypasses the SDK transport: it gets no automatic 2FA retry or session-revocation handling. It still sends `Authorization` and `X-Sent-At`.",
        "tags": [
          "X Tracker"
        ],
        "responses": {
          "200": {
            "description": "A stream of `data:` events, each a JSON message.",
            "content": {
              "text/event-stream": {
                "example": "data: {\"type\":\"status\",\"status\":\"connected\",\"error\":null,\"latency\":182,\"session\":{\"modules\":[],\"handles\":48,\"maxHandles\":200}}\n\ndata: {\"type\":\"event\",\"d\":{\"event\":\"twitter.post.new\",\"event_time\":1793614504000,\"task_info\":{\"handle\":\"examplecaller\"},\"data\":{\"id\":\"1852200000000000001\",\"type\":\"post\",\"text\":\"the otter is coming $OTTER\",\"author\":{\"handle\":\"examplecaller\"},\"created_at\":1793614500000,\"cashtags\":[\"OTTER\"]}}}\n\ndata: {\"type\":\"suggestions\",\"tweet_id\":\"1852200000000000001\",\"suggestions\":[{\"name\":\"Moon Otter\",\"symbol\":\"OTTER\",\"image\":null}]}\n\n"
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. The web app stops reconnecting on this status, as it does on 401. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin. The web app stops reconnecting on this status, as it does on 401.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Xanguard key, so there is no session to stream. Set `XANGUARD_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Xanguard key, so there is no session to stream.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "xanguard api issue: XANGUARD_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#stream-events"
        }
      }
    },
    "/tracker/handles": {
      "get": {
        "operationId": "tracker.list-handles",
        "summary": "List tracked accounts",
        "description": "Lists the X accounts followed by the shared tracker session.\n\nThe SDK returns the `handles` array.",
        "tags": [
          "X Tracker"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Tracked handle](#object-tracked-handle) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "handles": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Tracked handle](#object-tracked-handle) objects."
                    }
                  },
                  "required": [
                    "handles"
                  ]
                },
                "example": {
                  "handles": [
                    {
                      "handle": "examplecaller",
                      "displayName": "Example Caller",
                      "isActive": true,
                      "twitterUserId": "1580000000000000001"
                    },
                    {
                      "handle": "demo_trader",
                      "displayName": null,
                      "isActive": true,
                      "twitterUserId": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Xanguard key, or the Xanguard API failed. Set `XANGUARD_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Xanguard key, or the Xanguard API failed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "xanguard api issue: XANGUARD_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#list-handles"
        }
      },
      "post": {
        "operationId": "tracker.add-handle",
        "summary": "Track an account",
        "description": "Adds an X account to the shared tracker session.\n\nThe web app normalizes input before sending: it strips a leading `@` and an `x.com` or `twitter.com` URL prefix, drops anything after `/`, `?` or `#`, and lowercases. The SDK returns the stored `handle`. Bulk import sends one request per handle.",
        "tags": [
          "X Tracker"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "handle": {
                    "type": "string",
                    "description": "X handle, without `@`."
                  }
                },
                "required": [
                  "handle"
                ]
              },
              "example": {
                "handle": "demo_trader"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "handle": {
                      "type": "string",
                      "description": "Handle as stored."
                    }
                  },
                  "required": [
                    "handle"
                  ]
                },
                "example": {
                  "handle": "demo_trader"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `handle` does not reduce to an X handle of 1 to 50 letters, digits or `_`. Send `@name`, `name` or an `x.com` profile link.\n\n`bad_request`: Xanguard refused the handle, with its own message. Bulk import skips it and continues.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`handle` does not reduce to an X handle of 1 to 50 letters, digits or `_`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Enter a valid handle"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Xanguard refused the handle, with its own message. Bulk import skips it and continues.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<xanguard_error>"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The tracking limit of the Xanguard plan is reached, with Xanguard's own message. Bulk import stops here. Stop tracking an account with [Stop tracking an account](/reference/tracker/#remove-handle) first.\n\n`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The tracking limit of the Xanguard plan is reached, with Xanguard's own message. Bulk import stops here.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "<xanguard_error>"
                    }
                  },
                  "forbidden_2": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: Xanguard does not know this X account. Bulk import skips it and continues. Check the handle on X.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "Xanguard does not know this X account. Bulk import skips it and continues.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "<xanguard_error>"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The account is already tracked. Bulk import skips it and continues. Nothing to do: the account is already tracked.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The account is already tracked. Bulk import skips it and continues.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "<xanguard_error>"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Xanguard key, or the Xanguard API failed. Set `XANGUARD_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Xanguard key, or the Xanguard API failed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "xanguard api issue: XANGUARD_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers 409 once the account is tracked; [List tracked accounts](/reference/tracker/#list-handles) shows the current set."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#add-handle"
        }
      }
    },
    "/tracker/handles/{handle}": {
      "delete": {
        "operationId": "tracker.remove-handle",
        "summary": "Stop tracking an account",
        "description": "Removes an X account from the shared tracker session.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "X handle, without `@`.",
            "schema": {
              "type": "string"
            },
            "example": "demo_trader"
          }
        ],
        "responses": {
          "200": {
            "description": "The web app does not read the response body.",
            "content": {
              "application/json": {
                "example": {}
              }
            }
          },
          "400": {
            "description": "`bad_request`: `handle` is not a valid X handle. Send `@name`, `name` or an `x.com` profile link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`handle` is not a valid X handle.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Enter a valid handle"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Xanguard key, or the Xanguard API failed. Set `XANGUARD_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Xanguard key, or the Xanguard API failed.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "xanguard api issue: XANGUARD_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat after a success may answer an error relayed from Xanguard; [List tracked accounts](/reference/tracker/#list-handles) shows the current set."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#remove-handle"
        }
      }
    },
    "/tracker/tweets": {
      "get": {
        "operationId": "tracker.list-tweets",
        "summary": "List saved tweets",
        "description": "Returns stored tweets of the given accounts, used to fill the feed on load.\n\nThe web app requests each viewed account once, in batches of 40 handles with `per_handle=100`. The SDK returns the `tweets` array. Saved suggestions are merged into the feed.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "handles",
            "in": "query",
            "required": false,
            "description": "Comma-separated handles.",
            "schema": {
              "type": "string"
            },
            "example": "examplecaller,demo_trader"
          },
          {
            "name": "per_handle",
            "in": "query",
            "required": false,
            "description": "Maximum tweets per handle.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum tweets in total.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Saved tweet](#object-saved-tweet) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tweets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Saved tweet](#object-saved-tweet) objects."
                    }
                  },
                  "required": [
                    "tweets"
                  ]
                },
                "example": {
                  "tweets": [
                    {
                      "event": {
                        "event": "twitter.post.new",
                        "event_time": 1793614504000,
                        "task_info": {
                          "handle": "examplecaller"
                        },
                        "data": {
                          "id": "1852200000000000001",
                          "type": "post",
                          "text": "the otter is coming $OTTER",
                          "author": {
                            "id": "1580000000000000001",
                            "handle": "examplecaller"
                          },
                          "created_at": 1793614500000,
                          "cashtags": [
                            "OTTER"
                          ]
                        }
                      },
                      "received_at": 1793614504000,
                      "deleted": false,
                      "suggestions": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. The app stays silent instead of showing an error. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin. The app stays silent instead of showing an error.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#list-tweets"
        }
      }
    },
    "/tracker/settings": {
      "get": {
        "operationId": "tracker.retrieve-settings",
        "summary": "Retrieve tracker settings",
        "description": "Returns the caller's saved tracker settings document.\n\nThe document is free-form JSON owned by the client. The web app stores `feed` (`sound`, `showMedia`, `detectVision`, `maxDepth`), per-account `prefs`, keyword `alerts`, `activeList`, `defaultList`, `deploy` presets and `layout`. The SDK returns `settings`. If loading fails, the app disables saving so stored settings are never overwritten with defaults.",
        "tags": [
          "X Tracker"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "settings": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Saved document, or `null` when nothing is saved."
                    }
                  },
                  "required": [
                    "settings"
                  ]
                },
                "example": {
                  "settings": {
                    "feed": {
                      "sound": true,
                      "showMedia": true,
                      "detectVision": false,
                      "maxDepth": 2
                    },
                    "activeList": "67744a28-e685-49cd-a56b-803b8e647080",
                    "alerts": {
                      "alerts": [],
                      "desktop": false
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#retrieve-settings"
        }
      },
      "put": {
        "operationId": "tracker.save-settings",
        "summary": "Save tracker settings",
        "description": "Replaces the caller's tracker settings document.\n\nThe web app saves 800 ms after the last change, and only when the document differs from the last saved copy.",
        "tags": [
          "X Tracker"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "settings": {
                    "type": "object",
                    "description": "The full settings document."
                  }
                },
                "required": [
                  "settings"
                ]
              },
              "example": {
                "settings": {
                  "feed": {
                    "sound": false,
                    "showMedia": true,
                    "detectVision": true,
                    "maxDepth": 3
                  },
                  "activeList": null
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The web app does not read the response body.",
            "content": {
              "application/json": {
                "example": {}
              }
            }
          },
          "400": {
            "description": "`bad_request`: `settings` is not a JSON object. Send `settings` as an object.\n\n`bad_request`: `settings` is larger than 256 KB once serialized. Trim the settings below 256 KB.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`settings` is not a JSON object.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "settings must be an object"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`settings` is larger than 256 KB once serialized.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "settings are too large"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "The body replaces the saved settings whole."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#save-settings"
        }
      }
    },
    "/tracker/lists": {
      "get": {
        "operationId": "tracker.list-lists",
        "summary": "List tracker lists",
        "description": "Lists the caller's tracker lists.\n\nThe SDK returns the `lists` array; the app sorts it by `position`.",
        "tags": [
          "X Tracker"
        ],
        "responses": {
          "200": {
            "description": "Returns a list of [Tracker list](#object-tracker-list) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "lists": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Tracker list](#object-tracker-list) objects."
                    }
                  },
                  "required": [
                    "lists"
                  ]
                },
                "example": {
                  "lists": [
                    {
                      "id": "67744a28-e685-49cd-a56b-803b8e647080",
                      "name": "Callers",
                      "handles": [
                        "examplecaller",
                        "demo_trader"
                      ],
                      "position": 0,
                      "icon": null,
                      "color": "#4f8cff"
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#list-lists"
        }
      },
      "post": {
        "operationId": "tracker.create-list",
        "summary": "Create a list",
        "description": "Creates a tracker list from a name and a set of tracked handles.",
        "tags": [
          "X Tracker"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "List name."
                  },
                  "handles": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Handles in the list."
                  },
                  "icon": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Icon name."
                  },
                  "color": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Color as `#rrggbb`."
                  }
                },
                "required": [
                  "name",
                  "handles"
                ]
              },
              "example": {
                "name": "Callers",
                "handles": [
                  "examplecaller",
                  "demo_trader"
                ],
                "color": "#4f8cff"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the created [Tracker list](#object-tracker-list).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "list": {
                      "type": "object",
                      "description": "The [Tracker list](#object-tracker-list)."
                    }
                  },
                  "required": [
                    "list"
                  ]
                },
                "example": {
                  "list": {
                    "id": "67744a28-e685-49cd-a56b-803b8e647080",
                    "name": "Callers",
                    "handles": [
                      "examplecaller",
                      "demo_trader"
                    ],
                    "position": 0,
                    "icon": null,
                    "color": "#4f8cff"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The caller already has 50 lists. Free a slot with [Delete a list](/reference/tracker/#delete-list) first.\n\n`bad_request`: `name` is empty or longer than 40 characters. Send a name of 1 to 40 characters.\n\n`bad_request`: `icon` is longer than 32 characters or has characters other than ASCII letters and digits. Send an icon name from the app's icon set, or an empty string to clear it.\n\n`bad_request`: `color` is not a `#rrggbb` hex color. Send a color such as `#1d9bf0`, or an empty string to clear it.\n\n`bad_request`: An entry in `handles` is not a valid X handle. Send `@name`, `name` or an `x.com` profile link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The caller already has 50 lists.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "At most 50 lists"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`name` is empty or longer than 40 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "List name must be 1 to 40 characters"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`icon` is longer than 32 characters or has characters other than ASCII letters and digits.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid list icon"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`color` is not a `#rrggbb` hex color.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "List color must be #rrggbb"
                    }
                  },
                  "bad_request_5": {
                    "summary": "An entry in `handles` is not a valid X handle.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Enter a valid handle"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat creates a second list with the same name. Look for it in [List tracker lists](/reference/tracker/#list-lists) first."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#create-list"
        }
      }
    },
    "/tracker/lists/{list_id}": {
      "patch": {
        "operationId": "tracker.update-list",
        "summary": "Update a list",
        "description": "Updates a list's name, handles, position, icon or color.\n\nOnly the fields sent change. To clear `icon` or `color`, send an empty string; the SDK turns a `null` into `\"\"`.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "required": true,
            "description": "List ID.",
            "schema": {
              "type": "string"
            },
            "example": "67744a28-e685-49cd-a56b-803b8e647080"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "New name."
                  },
                  "handles": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "New set of handles."
                  },
                  "position": {
                    "type": "integer",
                    "description": "New sort position."
                  },
                  "icon": {
                    "type": "string",
                    "description": "Icon name, or `\"\"` to clear."
                  },
                  "color": {
                    "type": "string",
                    "description": "Color as `#rrggbb`, or `\"\"` to clear."
                  }
                }
              },
              "example": {
                "name": "Top callers",
                "color": ""
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns the updated [Tracker list](#object-tracker-list).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "list": {
                      "type": "object",
                      "description": "The [Tracker list](#object-tracker-list)."
                    }
                  },
                  "required": [
                    "list"
                  ]
                },
                "example": {
                  "list": {
                    "id": "67744a28-e685-49cd-a56b-803b8e647080",
                    "name": "Top callers",
                    "handles": [
                      "examplecaller",
                      "demo_trader"
                    ],
                    "position": 0,
                    "icon": null,
                    "color": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `name` is empty or longer than 40 characters. Send a name of 1 to 40 characters.\n\n`bad_request`: `icon` is longer than 32 characters or has characters other than ASCII letters and digits. Send an icon name from the app's icon set, or an empty string to clear it.\n\n`bad_request`: `color` is not a `#rrggbb` hex color. Send a color such as `#1d9bf0`, or an empty string to clear it.\n\n`bad_request`: An entry in `handles` is not a valid X handle. Send `@name`, `name` or an `x.com` profile link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`name` is empty or longer than 40 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "List name must be 1 to 40 characters"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`icon` is longer than 32 characters or has characters other than ASCII letters and digits.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid list icon"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`color` is not a `#rrggbb` hex color.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "List color must be #rrggbb"
                    }
                  },
                  "bad_request_4": {
                    "summary": "An entry in `handles` is not a valid X handle.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Enter a valid handle"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No list with this ID belongs to the caller. Pick a list ID from [List tracker lists](/reference/tracker/#list-lists).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No list with this ID belongs to the caller.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "List not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#update-list"
        }
      },
      "delete": {
        "operationId": "tracker.delete-list",
        "summary": "Delete a list",
        "description": "Deletes one of the caller's tracker lists.\n\nTracked accounts are not affected.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "list_id",
            "in": "path",
            "required": true,
            "description": "List ID.",
            "schema": {
              "type": "string"
            },
            "example": "67744a28-e685-49cd-a56b-803b8e647080"
          }
        ],
        "responses": {
          "200": {
            "description": "The web app does not read the response body.",
            "content": {
              "application/json": {
                "example": {}
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No list with this ID belongs to the caller. Pick a list ID from [List tracker lists](/reference/tracker/#list-lists).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No list with this ID belongs to the caller.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "List not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat answers 404 once the list is gone."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#delete-list"
        }
      }
    },
    "/tracker/frontrun/search": {
      "get": {
        "operationId": "tracker.search-posts",
        "summary": "Search X posts",
        "description": "Searches X through Frontrun, newest first.\n\nAccepts keywords, contract addresses and X operators such as `from:` or `min_faves:`. The backend relays Frontrun's envelope unchanged: check `status` before reading `data`. The app caches each page for 60 seconds.\n\nEach search costs 3 Frontrun credits.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search query.",
            "schema": {
              "type": "string"
            },
            "example": "$OTTER min_faves:50"
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "description": "Results per page. The app sends `20`.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`nextCursor` from the previous page.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "boolean",
                      "description": "`false` when Frontrun reports a failure, with `message`."
                    },
                    "message": {
                      "type": "string",
                      "description": "Frontrun's message."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "tweets": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Raw tweets with `tweet_id`, `url`, `screen_name`, `text`, `created_at`, engagement counts, `user_info`, `media` and `entities`."
                        },
                        "nextCursor": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Cursor for the next page, or `null`."
                        }
                      },
                      "required": [
                        "tweets",
                        "nextCursor"
                      ],
                      "description": "Search page."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "status": true,
                  "data": {
                    "tweets": [
                      {
                        "tweet_id": "1852200000000000001",
                        "url": "https://x.com/examplecaller/status/1852200000000000001",
                        "screen_name": "examplecaller",
                        "text": "the otter is coming $OTTER",
                        "created_at": "2026-11-02T10:15:00.000Z",
                        "favorites": 120,
                        "retweets": 14,
                        "replies": 9,
                        "quotes": 2,
                        "views": "18200",
                        "user_info": {
                          "screen_name": "examplecaller",
                          "name": "Example Caller",
                          "rest_id": "1580000000000000001",
                          "followers_count": 48210,
                          "avatar": "https://pbs.twimg.com/profile_images/example.jpg",
                          "verified": true
                        },
                        "media": []
                      }
                    ],
                    "nextCursor": "c2VhcmNoLWN1cnNvci0y"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `q` is empty. Send a search query in `q`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`q` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "q is required"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Frontrun rejected the server's API key. Relayed with Frontrun's own body, without a Proxima `code`. Check the Frontrun key configured on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.\n\nFrontrun rejected the server's API key. Relayed with Frontrun's own body, without a Proxima `code`. Check the Frontrun key configured on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Frontrun key, or the call to Frontrun failed in transit. Set `FRONTRUN_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Frontrun key, or the call to Frontrun failed in transit.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "frontrun api issue: FRONTRUN_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Frontrun rate limit (60 requests per minute). Relayed with Frontrun's own body, without a Proxima `code`. Wait a minute before the next Frontrun call.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#search-posts"
        }
      }
    },
    "/tracker/frontrun/profile/{handle}/{report}": {
      "get": {
        "operationId": "tracker.retrieve-profile-report",
        "summary": "Retrieve an X profile report",
        "description": "Returns a Frontrun report on an X account: its profile, its smart followers, or the contract addresses it posted.\n\nThe `data` shape depends on `report`:\n\n- `info`: profile with `twitterId`, `name`, `twitterUsername`, `bio`, `profilePhoto`, `followersCount`, `followingsCount` and labels, or `null`.\n- `smart-followers`: `{ smartFollowers, totalCount }`.\n- `tweets-with-ca`: `{ topUndeletedTweets, topDeletedTweets, undeletedCACount, deletedCACount, undeletedTweetCount, deletedTweetCount }`, including tweets that were later deleted.\n\nThe app caches each report for 10 minutes so reopening a profile does not spend credits twice.\n\nCredit cost per report: `info` 10, `smart-followers` 10, `tweets-with-ca` 25.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "X handle, without `@`.",
            "schema": {
              "type": "string"
            },
            "example": "examplecaller"
          },
          {
            "name": "report",
            "in": "path",
            "required": true,
            "description": "Report to fetch.",
            "schema": {
              "type": "string",
              "enum": [
                "info",
                "smart-followers",
                "tweets-with-ca"
              ]
            },
            "example": "info"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "boolean",
                      "description": "`false` when Frontrun reports a failure."
                    },
                    "message": {
                      "type": "string",
                      "description": "Frontrun's message."
                    },
                    "data": {
                      "description": "Report payload; see above."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "status": true,
                  "data": {
                    "twitterId": "1580000000000000001",
                    "name": "Example Caller",
                    "twitterUsername": "examplecaller",
                    "bio": "memes and charts",
                    "profilePhoto": null,
                    "followersCount": 48210,
                    "followingsCount": 812,
                    "primaryLabel": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `handle` is not a valid X handle. Send `@name`, `name` or an `x.com` profile link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`handle` is not a valid X handle.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Enter a valid handle"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: `report` is not `info`, `smart-followers` or `tweets-with-ca`. Use `info`, `smart-followers` or `tweets-with-ca`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "`report` is not `info`, `smart-followers` or `tweets-with-ca`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Unknown profile endpoint"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Frontrun key, or the call to Frontrun failed in transit. Set `FRONTRUN_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Frontrun key, or the call to Frontrun failed in transit.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "frontrun api issue: FRONTRUN_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "Frontrun rate limit (60 requests per minute). Relayed with Frontrun's own body, without a Proxima `code`. Wait a minute before the next Frontrun call.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#retrieve-profile-report"
        }
      }
    },
    "/tracker/frontrun/old-username/{handle}": {
      "get": {
        "operationId": "tracker.lookup-old-username",
        "summary": "Look up previous owners of a handle",
        "description": "Returns the X accounts that used this handle before renaming away from it.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "handle",
            "in": "path",
            "required": true,
            "description": "X handle, without `@`.",
            "schema": {
              "type": "string"
            },
            "example": "examplecaller"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "boolean",
                      "description": "`false` when Frontrun reports a failure."
                    },
                    "message": {
                      "type": "string",
                      "description": "Frontrun's message."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "found": {
                          "type": "boolean",
                          "description": "Whether earlier owners were found."
                        },
                        "profiles": {
                          "type": "array",
                          "items": {
                            "type": "object"
                          },
                          "description": "Earlier accounts. The app reads `twitterUsername` (or `username`, `twitter`), `name` and `profilePhoto`."
                        }
                      },
                      "required": [
                        "found",
                        "profiles"
                      ],
                      "description": "Lookup result."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "status": true,
                  "data": {
                    "found": true,
                    "profiles": [
                      {
                        "twitterUsername": "otter_archive",
                        "name": "Otter Archive",
                        "profilePhoto": null
                      }
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `handle` is not a valid X handle. Send `@name`, `name` or an `x.com` profile link.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`handle` is not a valid X handle.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Enter a valid handle"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Frontrun key, or the call to Frontrun failed in transit. Set `FRONTRUN_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Frontrun key, or the call to Frontrun failed in transit.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "frontrun api issue: FRONTRUN_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#lookup-old-username"
        }
      }
    },
    "/tracker/frontrun/credits": {
      "get": {
        "operationId": "tracker.retrieve-credits",
        "summary": "Retrieve Frontrun credits",
        "description": "Returns the Frontrun credit balance of the tracker's API key.",
        "tags": [
          "X Tracker"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "boolean",
                      "description": "`false` when Frontrun reports a failure."
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "currentPoints": {
                          "type": "number",
                          "description": "Credits left."
                        },
                        "totalCredits": {
                          "type": "string",
                          "description": "Total credits, as a numeric string."
                        }
                      },
                      "required": [
                        "currentPoints",
                        "totalCredits"
                      ],
                      "description": "Credit balance."
                    }
                  },
                  "required": [
                    "data"
                  ]
                },
                "example": {
                  "status": true,
                  "data": {
                    "currentPoints": 41820,
                    "totalCredits": "50000"
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Frontrun key, or the call to Frontrun failed in transit. Set `FRONTRUN_API_KEY` on the server, or retry later.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Frontrun key, or the call to Frontrun failed in transit.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "frontrun api issue: FRONTRUN_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#retrieve-credits"
        }
      }
    },
    "/tracker/suggest": {
      "post": {
        "operationId": "tracker.suggest-tokens",
        "summary": "Suggest token names for a tweet",
        "description": "Returns name and ticker picks for a tweet, to prefill a token deploy.\n\nThe web app asks for three picks per tweet, once the tweet card scrolls into view, and caches them for the session. The SDK returns the `suggestions` array.\n\nThe body is typed as a free-form object in the SDK; the fields above are what the web app sends.",
        "tags": [
          "X Tracker"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Tweet ID."
                  },
                  "text": {
                    "type": "string",
                    "description": "Tweet text."
                  },
                  "handle": {
                    "type": "string",
                    "description": "Author handle."
                  },
                  "followers": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Author follower count."
                  },
                  "media": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Photo URLs."
                  },
                  "posters": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Video poster URLs."
                  },
                  "avatar": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Author avatar URL."
                  },
                  "quoted_handle": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Handle of the quoted tweet's author."
                  },
                  "quoted_text": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Text of the quoted tweet."
                  },
                  "quoted_media": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Photo URLs of the quoted tweet."
                  },
                  "reply_to": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Handle the tweet replies to."
                  },
                  "cashtags": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Cashtags in the text, without `$`."
                  }
                }
              },
              "example": {
                "id": "1852200000000000001",
                "text": "the otter is coming $OTTER",
                "handle": "examplecaller",
                "followers": 48210,
                "media": [],
                "posters": [],
                "avatar": null,
                "quoted_handle": null,
                "quoted_text": null,
                "quoted_media": [],
                "reply_to": null,
                "cashtags": [
                  "OTTER"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns a list of [Suggestion](#object-suggestion) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "suggestions": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "[Suggestion](#object-suggestion) objects."
                    }
                  },
                  "required": [
                    "suggestions"
                  ]
                },
                "example": {
                  "suggestions": [
                    {
                      "name": "Moon Otter",
                      "symbol": "OTTER",
                      "image": null
                    },
                    {
                      "name": "Otter Coming",
                      "symbol": "OTCOME",
                      "image": null
                    },
                    {
                      "name": "Otter",
                      "symbol": "OTR",
                      "image": null
                    }
                  ]
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The examples the suggestions rely on cannot be loaded. Check the trench examples on the server (`TRENCH_AI_DIR`).\n\n`upstream_failure`: The server has no Gemini key. Set `GEMINI_API_KEY` on the server.\n\n`upstream_failure`: Gemini returned no usable suggestion for this tweet. Retry, or name the token by hand.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The examples the suggestions rely on cannot be loaded.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Trench examples unusable (<error>)"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The server has no Gemini key.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "gemini api issue: GEMINI_API_KEY is not configured"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "Gemini returned no usable suggestion for this tweet.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "gemini api issue: no suggestions"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Picks are made once per tweet `id` and saved; a repeat returns the saved picks."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#suggest-tokens"
        }
      }
    },
    "/tracker/vision": {
      "post": {
        "operationId": "tracker.analyze-image",
        "summary": "Analyze a tweet image",
        "description": "Detects the subjects and legible texts in an image, with their positions.\n\nSend either `url` (an X media URL) or `image` (a `data:image/...;base64,` URL for an image only the browser holds, such as a captured video frame). The SDK picks the field from the source string. Boxes are in percent of the image, from 0 to 100. The app draws them over tweet images when **detect vision** is on.",
        "tags": [
          "X Tracker"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "X media URL. Send this or `image`."
                  },
                  "image": {
                    "type": "string",
                    "description": "Image as a `data:` URL. Send this or `url`."
                  }
                }
              },
              "example": {
                "url": "https://pbs.twimg.com/media/example.jpg"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "subjects": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "What the subject is."
                          },
                          "box": {
                            "type": "object",
                            "description": "`{ x, y, width, height }` in percent of the image."
                          }
                        },
                        "required": [
                          "label",
                          "box"
                        ]
                      },
                      "description": "Detected subjects."
                    },
                    "texts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "text": {
                            "type": "string",
                            "description": "Text as read."
                          },
                          "name": {
                            "type": "string",
                            "description": "Token name derived from the text."
                          },
                          "symbol": {
                            "type": "string",
                            "description": "Ticker derived from the text."
                          },
                          "box": {
                            "type": "object",
                            "description": "`{ x, y, width, height }` in percent of the image."
                          }
                        },
                        "required": [
                          "text",
                          "name",
                          "symbol",
                          "box"
                        ]
                      },
                      "description": "Legible texts."
                    }
                  },
                  "required": [
                    "subjects",
                    "texts"
                  ]
                },
                "example": {
                  "subjects": [
                    {
                      "label": "otter",
                      "box": {
                        "x": 22.5,
                        "y": 10,
                        "width": 48,
                        "height": 70
                      }
                    }
                  ],
                  "texts": [
                    {
                      "text": "OTTER SZN",
                      "name": "Otter Season",
                      "symbol": "OTTER",
                      "box": {
                        "x": 30,
                        "y": 82,
                        "width": 40,
                        "height": 10
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The body has both `url` and `image`, or neither. Send exactly one of `url` and `image`.\n\n`bad_request`: `url` is not a valid URL. Send the full `https` URL of the image.\n\n`bad_request`: `url` is not an `https` image on `pbs.twimg.com`, `abs.twimg.com` or `video.twimg.com`. Send an X media URL, or the image itself in `image`.\n\n`bad_request`: `image` is not a base64 `data:` URL. Send `image` as `data:image/<type>;base64,<data>`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The body has both `url` and `image`, or neither.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Send either url or image"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`url` is not a valid URL.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid image url"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`url` is not an `https` image on `pbs.twimg.com`, `abs.twimg.com` or `video.twimg.com`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Only X media images can be analysed"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`image` is not a base64 `data:` URL.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid image data"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: The URL or the data does not hold an image. Send an image.\n\n`unprocessable`: The image is larger than 8 MB. Send an image under 8 MB.\n\n`upstream_failure`: The X media host answered an error status for `url`. Check that the image still exists on X.\n\n`upstream_failure`: The server has no Gemini key. Set `GEMINI_API_KEY` on the server.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "The URL or the data does not hold an image.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Not an image"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "The image is larger than 8 MB.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "Image is too large"
                    }
                  },
                  "upstream_failure": {
                    "summary": "The X media host answered an error status for `url`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "x media api issue: image answered <status>"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "The server has no Gemini key.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "gemini api issue: GEMINI_API_KEY is not configured"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Results are cached per image for an hour."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#analyze-image"
        }
      }
    },
    "/tracker/images": {
      "get": {
        "operationId": "tracker.search-images",
        "summary": "Search web images",
        "description": "Searches Google Images through Serper, to pick a deploy image.\n\nReturns Serper's payload as relayed by the backend. The app reads `imageUrl`, `title`, `thumbnailUrl`, `imageWidth`, `imageHeight` and `source` (or `domain`) from each image, and caches results per query for the session.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Search query.",
            "schema": {
              "type": "string"
            },
            "example": "sea otter meme"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "images": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Image results."
                    }
                  }
                },
                "example": {
                  "images": [
                    {
                      "title": "Sea otter floating",
                      "imageUrl": "https://images.example.com/otter.jpg",
                      "imageWidth": 1200,
                      "imageHeight": 800,
                      "thumbnailUrl": "https://images.example.com/otter-thumb.jpg",
                      "source": "example.com"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `q` is empty or longer than 120 characters. Send a query of 1 to 120 characters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`q` is empty or longer than 120 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Query must be 1-120 characters"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The server has no Serper key. Set `SERPER_API_KEY` on the server.\n\n`upstream_failure`: Serper answered an error status. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The server has no Serper key.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "serper api issue: SERPER_API_KEY is not configured"
                    }
                  },
                  "upstream_failure_2": {
                    "summary": "Serper answered an error status.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "serper api issue: Image search failed (<status>)"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#search-images"
        }
      }
    },
    "/tracker/fx/{tweet_id}": {
      "get": {
        "operationId": "tracker.retrieve-tweet",
        "summary": "Retrieve a tweet",
        "description": "Returns a public tweet's details from FxTwitter, used to walk reply threads and quote chains.\n\nThe backend relays FxTwitter's status payload. The app reads `id`, `text`, `url`, `author` (`screen_name`, `name`, `avatar_url`, `followers`), `media.all`, `created_timestamp` (Unix seconds), `replying_to`, `replying_to_status` and `quote`. Requests run at most 4 at a time and results are cached for the session.",
        "tags": [
          "X Tracker"
        ],
        "parameters": [
          {
            "name": "tweet_id",
            "in": "path",
            "required": true,
            "description": "Tweet ID.",
            "schema": {
              "type": "string"
            },
            "example": "1852200000000000001"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tweet": {
                      "type": "object",
                      "description": "FxTwitter tweet object."
                    }
                  }
                },
                "example": {
                  "tweet": {
                    "id": "1852200000000000001",
                    "url": "https://x.com/examplecaller/status/1852200000000000001",
                    "text": "the otter is coming $OTTER",
                    "author": {
                      "screen_name": "examplecaller",
                      "name": "Example Caller",
                      "avatar_url": null,
                      "followers": 48210
                    },
                    "created_timestamp": 1793614500,
                    "replying_to": null,
                    "replying_to_status": null
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `tweet_id` is not 1 to 25 digits. Pass the numeric ID from the tweet URL.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`tweet_id` is not 1 to 25 digits.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid tweet id"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "`forbidden`: The caller is not an admin. Call it with an admin account's session.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "forbidden": {
                    "summary": "The caller is not an admin.",
                    "value": {
                      "ok": false,
                      "code": "forbidden",
                      "message": "admin role required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "The tweet was deleted or does not exist. Relayed from FxTwitter with its own body, without a Proxima `code`; the backend caches the miss for 10 minutes and the app caches it too.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: FxTwitter could not be reached. Retry in a few minutes.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "FxTwitter could not be reached.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "fxtwitter api issue: <error>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/tracker/#retrieve-tweet"
        }
      }
    },
    "/marketplace/catalog": {
      "get": {
        "operationId": "marketplace-catalog.list-catalog-wallets",
        "summary": "List catalog wallets",
        "description": "Returns a page of wallets for sale that match the filters.\n\nKeyset-paginated: pass the previous page's `next_cursor` as `cursor` to fetch the next page. The Marketplace page requests 500 wallets per page and builds the lot to buy from them. Empty filter values are not sent.",
        "tags": [
          "Marketplace catalog"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "description": "Marketplace chain slug. These are marketplace slugs, not Proxima chain ids.",
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "bsc",
                "base",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          },
          {
            "name": "count",
            "in": "query",
            "required": false,
            "description": "Page size. The web app requests `500`.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Cursor from a previous page's `next_cursor`.",
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          {
            "name": "min_balance",
            "in": "query",
            "required": false,
            "description": "Minimum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_balance",
            "in": "query",
            "required": false,
            "description": "Maximum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Minimum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Maximum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_age_days",
            "in": "query",
            "required": false,
            "description": "Minimum wallet age, in days. The web app defaults to `1`.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "max_age_days",
            "in": "query",
            "required": false,
            "description": "Maximum wallet age, in days.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "min_tx_count",
            "in": "query",
            "required": false,
            "description": "Minimum number of on-chain transactions.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "max_tx_count",
            "in": "query",
            "required": false,
            "description": "Maximum number of on-chain transactions.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sources",
            "in": "query",
            "required": false,
            "description": "Comma-separated funding sources, as returned by [List funding sources](#list-funding-sources).",
            "schema": {
              "type": "string"
            },
            "example": "binance,kucoin"
          },
          {
            "name": "tier",
            "in": "query",
            "required": false,
            "description": "Comma-separated activity tiers, e.g. `tier0,tier1`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "persona",
            "in": "query",
            "required": false,
            "description": "Activity persona, e.g. `active_trader`. Not set by the web app.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timezone",
            "in": "query",
            "required": false,
            "description": "Comma-separated activity timezone slugs, e.g. `europe,europe_cet_evening`. The web app expands each region it shows into the slugs it covers.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_funding_gap_seconds",
            "in": "query",
            "required": false,
            "description": "Minimum spacing, in seconds, between wallet funding timestamps. The web app defaults to `1800` (30 minutes) to limit funding-time clustering.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "gap_with",
            "in": "query",
            "required": false,
            "description": "Comma-separated Unix timestamps (seconds) of existing wallets whose funding times the results must also stay apart from. The web app sends the funding times of the destination folders' wallets, only together with `min_funding_gap_seconds`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Sort field. Not set by the web app.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "Sort direction. Not set by the web app.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a page of [Catalog wallet](#object-catalog-wallet) objects.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Wallets on this page. See [Catalog wallet](#object-catalog-wallet)."
                    },
                    "next_cursor": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor for the next page; `null` on the last page."
                    }
                  },
                  "required": [
                    "items"
                  ]
                },
                "example": {
                  "items": [
                    {
                      "id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                      "network": "svm",
                      "chain": "solana",
                      "status": "listed",
                      "balance": "41250000",
                      "tx_count": 14,
                      "funded_at": "2026-08-14T09:21:07Z",
                      "first_tx_at": "2026-08-14T11:02:44Z",
                      "last_tx_at": "2026-10-29T18:40:12Z",
                      "created_at": "2026-08-13T22:10:00Z",
                      "funding_source": "husher",
                      "funding_exchange": "binance",
                      "sold_at": null,
                      "source_kind": "cex",
                      "tier": "tier1",
                      "persona_name": "active_trader",
                      "timezone_name": "europe_cet_evening",
                      "user_price": "135000000",
                      "token_holdings": [
                        {
                          "mint": "1kF6kS9Z9RitRBAbgT6LzzxDrdr8odsxtqfEE7PWRCF",
                          "symbol": "DEMO",
                          "decimals": 6,
                          "balance": "1520000000",
                          "ui_multiplier": null,
                          "usd_value": 0.84
                        }
                      ]
                    }
                  ],
                  "next_cursor": "eyJpZCI6IjlmYjliOTg1In0"
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-catalog/#list-catalog-wallets"
        }
      }
    },
    "/marketplace/catalog/count": {
      "get": {
        "operationId": "marketplace-catalog.count-catalog-wallets",
        "summary": "Count catalog wallets",
        "description": "Returns how many wallets match the filters.\n\nTakes the same filters as [List catalog wallets](#list-catalog-wallets). The Marketplace page shows it as the matching total.",
        "tags": [
          "Marketplace catalog"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "description": "Marketplace chain slug. These are marketplace slugs, not Proxima chain ids.",
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "bsc",
                "base",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          },
          {
            "name": "min_balance",
            "in": "query",
            "required": false,
            "description": "Minimum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_balance",
            "in": "query",
            "required": false,
            "description": "Maximum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Minimum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Maximum sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_age_days",
            "in": "query",
            "required": false,
            "description": "Minimum wallet age, in days. The web app defaults to `1`.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "max_age_days",
            "in": "query",
            "required": false,
            "description": "Maximum wallet age, in days.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "min_tx_count",
            "in": "query",
            "required": false,
            "description": "Minimum number of on-chain transactions.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "max_tx_count",
            "in": "query",
            "required": false,
            "description": "Maximum number of on-chain transactions.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sources",
            "in": "query",
            "required": false,
            "description": "Comma-separated funding sources, as returned by [List funding sources](#list-funding-sources).",
            "schema": {
              "type": "string"
            },
            "example": "binance,kucoin"
          },
          {
            "name": "tier",
            "in": "query",
            "required": false,
            "description": "Comma-separated activity tiers, e.g. `tier0,tier1`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "persona",
            "in": "query",
            "required": false,
            "description": "Activity persona, e.g. `active_trader`. Not set by the web app.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "timezone",
            "in": "query",
            "required": false,
            "description": "Comma-separated activity timezone slugs, e.g. `europe,europe_cet_evening`. The web app expands each region it shows into the slugs it covers.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "min_funding_gap_seconds",
            "in": "query",
            "required": false,
            "description": "Minimum spacing, in seconds, between wallet funding timestamps. The web app defaults to `1800` (30 minutes) to limit funding-time clustering.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "gap_with",
            "in": "query",
            "required": false,
            "description": "Comma-separated Unix timestamps (seconds) of existing wallets whose funding times the results must also stay apart from. The web app sends the funding times of the destination folders' wallets, only together with `min_funding_gap_seconds`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Sort field. Not set by the web app.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "Sort direction. Not set by the web app.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "integer",
                      "description": "Number of matching wallets."
                    }
                  },
                  "required": [
                    "count"
                  ]
                },
                "example": {
                  "count": 1284
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-catalog/#count-catalog-wallets"
        }
      }
    },
    "/marketplace/catalog/facets": {
      "get": {
        "operationId": "marketplace-catalog.retrieve-catalog-facets",
        "summary": "Retrieve catalog facets",
        "description": "Returns the bounds, histograms and taxonomy used to build the catalog filters.",
        "tags": [
          "Marketplace catalog"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "description": "Marketplace chain slug.",
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "bsc",
                "base",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "integer",
                      "description": "Number of wallets in the catalog for the chain."
                    },
                    "max_balance": {
                      "type": "string",
                      "description": "Highest native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                    },
                    "max_price": {
                      "type": "string",
                      "description": "Highest sale price in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                    },
                    "max_tx": {
                      "type": "integer",
                      "description": "Highest transaction count."
                    },
                    "max_age_days": {
                      "type": "integer",
                      "description": "Oldest wallet age, in days."
                    },
                    "balance_hist": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "Wallet counts per balance bucket."
                    },
                    "tx_hist": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "Wallet counts per transaction-count bucket."
                    },
                    "price_hist": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "Wallet counts per price bucket."
                    },
                    "age_hist": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "Wallet counts per age bucket."
                    },
                    "tiers": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Activity tiers present, e.g. `tier0`."
                    },
                    "personas": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Activity personas present."
                    },
                    "timezones": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Activity timezone slugs present."
                    }
                  },
                  "required": [
                    "count",
                    "max_balance",
                    "max_price",
                    "max_tx",
                    "max_age_days",
                    "balance_hist",
                    "tx_hist",
                    "price_hist",
                    "age_hist",
                    "tiers",
                    "personas",
                    "timezones"
                  ]
                },
                "example": {
                  "count": 1284,
                  "max_balance": "2500000000",
                  "max_price": "900000000",
                  "max_tx": 312,
                  "max_age_days": 420,
                  "balance_hist": [
                    210,
                    188,
                    140,
                    96,
                    51,
                    22,
                    9,
                    3
                  ],
                  "tx_hist": [
                    402,
                    311,
                    220,
                    140,
                    98,
                    61,
                    30,
                    22
                  ],
                  "price_hist": [
                    96,
                    230,
                    301,
                    270,
                    188,
                    120,
                    52,
                    27
                  ],
                  "age_hist": [
                    18,
                    77,
                    160,
                    254,
                    300,
                    251,
                    150,
                    74
                  ],
                  "tiers": [
                    "tier0",
                    "tier1",
                    "tier2"
                  ],
                  "personas": [
                    "active_trader",
                    "long_term_holder"
                  ],
                  "timezones": [
                    "americas_et_evening",
                    "europe_cet_evening",
                    "asia_jst_evening"
                  ]
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-catalog/#retrieve-catalog-facets"
        }
      }
    },
    "/marketplace/catalog/sources": {
      "get": {
        "operationId": "marketplace-catalog.list-funding-sources",
        "summary": "List funding sources",
        "description": "Returns the funding venues present in the catalog for a chain.",
        "tags": [
          "Marketplace catalog"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "description": "Marketplace chain slug.",
            "schema": {
              "type": "string",
              "enum": [
                "solana",
                "ethereum",
                "bsc",
                "base",
                "robinhood",
                "arc"
              ]
            },
            "example": "solana"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "sources": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Funding venue slugs, usable in the `sources` catalog filter."
                    }
                  },
                  "required": [
                    "sources"
                  ]
                },
                "example": {
                  "sources": [
                    "binance",
                    "bybit",
                    "kucoin",
                    "mexc"
                  ]
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-catalog/#list-funding-sources"
        }
      }
    },
    "/marketplace/prices": {
      "get": {
        "operationId": "marketplace-catalog.retrieve-native-prices",
        "summary": "Retrieve native token prices",
        "description": "Returns the current USD price of each chain's native token.\n\nThe web app uses these prices to value token holdings in native units. It reads the `ethereum` price for Robinhood and treats Arc's native token as worth 1 USD.",
        "tags": [
          "Marketplace catalog"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "solana": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "USD price of SOL."
                    },
                    "ethereum": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "USD price of ETH."
                    },
                    "bsc": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "USD price of BNB."
                    },
                    "base": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "USD price of ETH on Base."
                    }
                  }
                },
                "example": {
                  "solana": 182.41,
                  "ethereum": 3520.18,
                  "bsc": 612.3,
                  "base": 3520.18
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-catalog/#retrieve-native-prices"
        }
      }
    },
    "/marketplace/quote": {
      "post": {
        "operationId": "marketplace-orders.create-a-quote",
        "summary": "Create a quote",
        "description": "Reserves a lot of catalog wallets and returns its price and deposit address.\n\nThe web app sends the exact lot previewed in the catalog as `wallet_ids`, with `count` set to its length, and remembers the quote id locally so an open checkout can resume after a reload. The other filter fields belong to the request type but the SDK method does not set them.\n\nCreating a quote holds the wallets but moves no funds. An unpaid hold lapses at `reserved_until`; [cancel the quote](#cancel-a-quote) to release it sooner.",
        "tags": [
          "Marketplace orders"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "chain": {
                    "type": "string",
                    "enum": [
                      "solana",
                      "ethereum",
                      "bsc",
                      "base",
                      "robinhood",
                      "arc"
                    ],
                    "description": "Marketplace chain slug."
                  },
                  "count": {
                    "type": "integer",
                    "description": "Number of wallets to reserve. The web app sends the length of `wallet_ids`."
                  },
                  "wallet_ids": {
                    "anyOf": [
                      {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Exact catalog wallet ids to reserve."
                  },
                  "sell_tokens_after_purchase": {
                    "type": "boolean",
                    "description": "Asks for the wallets' tokens to be sold after purchase. The client type only allows `true`."
                  },
                  "min_balance": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Minimum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                  },
                  "max_balance": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Maximum native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                  },
                  "min_age_days": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Minimum wallet age, in days."
                  },
                  "max_age_days": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Maximum wallet age, in days."
                  },
                  "min_gap_seconds": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Minimum spacing between funding timestamps, in seconds."
                  },
                  "source": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Funding source to draw from."
                  }
                },
                "required": [
                  "chain",
                  "sell_tokens_after_purchase"
                ]
              },
              "example": {
                "chain": "solana",
                "count": 2,
                "wallet_ids": [
                  "9fb9b985-594c-42e9-9592-fb986f90badb",
                  "b99b3501-9fbb-49a4-b344-226023503aca"
                ],
                "sell_tokens_after_purchase": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns a [Quote](#object-quote) object.",
            "content": {
              "application/json": {
                "example": {
                  "id": "96332c18-bc7b-48c7-a6a8-e95cc039a9d3",
                  "chain": "solana",
                  "status": "reserved",
                  "items": [
                    {
                      "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                      "user_price": "135000000",
                      "balance": "41250000",
                      "token_holdings": []
                    },
                    {
                      "wallet_id": "b99b3501-9fbb-49a4-b344-226023503aca",
                      "user_price": "128000000",
                      "balance": "38900000",
                      "token_holdings": []
                    }
                  ],
                  "user_price_total": "263000000",
                  "buyer_ref": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                  "pay_address": "NEHongC3s1wu2512RY9PeCSKxSafTewh4LaBtZLUwqYa",
                  "pay_checkout_url": null,
                  "pay_intent_id": null,
                  "payment_tx_hash": null,
                  "reserved_until": "2026-11-02T14:05:30Z",
                  "hard_expiry": "2026-11-02T14:30:00Z",
                  "created_at": "2026-11-02T14:00:30Z",
                  "completed_at": null,
                  "received_amount": "0",
                  "expected_amount": "263000000",
                  "payment_status": "awaiting_payment",
                  "sell_tokens_after_purchase": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The body is not a JSON object. Send the body as a JSON object.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The body is not a JSON object.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "body must be a json object"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "unsafe",
          "note": "Each call reserves another lot, and a lost response leaves no quote id to look up. No funds move: an unpaid hold lapses at `reserved_until`."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#create-a-quote"
        }
      }
    },
    "/marketplace/quote/{quote_id}": {
      "get": {
        "operationId": "marketplace-orders.retrieve-a-quote",
        "summary": "Retrieve a quote",
        "description": "Returns a quote with its items and payment state.\n\nOn load, the Marketplace page re-reads the quote it last held and resumes the checkout if it is still `reserved` and `reserved_until` is in the future. During checkout it is the fallback read when [Settle a quote](#settle-a-quote) fails.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Quote id returned by [Create a quote](#create-a-quote).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a [Quote](#object-quote) object.",
            "content": {
              "application/json": {
                "example": {
                  "id": "96332c18-bc7b-48c7-a6a8-e95cc039a9d3",
                  "chain": "solana",
                  "status": "reserved",
                  "items": [
                    {
                      "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                      "user_price": "135000000",
                      "balance": "41250000",
                      "token_holdings": []
                    },
                    {
                      "wallet_id": "b99b3501-9fbb-49a4-b344-226023503aca",
                      "user_price": "128000000",
                      "balance": "38900000",
                      "token_holdings": []
                    }
                  ],
                  "user_price_total": "263000000",
                  "buyer_ref": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                  "pay_address": "NEHongC3s1wu2512RY9PeCSKxSafTewh4LaBtZLUwqYa",
                  "pay_checkout_url": null,
                  "pay_intent_id": null,
                  "payment_tx_hash": null,
                  "reserved_until": "2026-11-02T14:05:30Z",
                  "hard_expiry": "2026-11-02T14:30:00Z",
                  "created_at": "2026-11-02T14:00:30Z",
                  "completed_at": null,
                  "received_amount": "0",
                  "expected_amount": "263000000",
                  "payment_status": "awaiting_payment",
                  "sell_tokens_after_purchase": true
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The quote does not exist or was created by another account. Use a quote id that [Create a quote](/reference/marketplace-orders/#create-a-quote) returned to this account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The quote does not exist or was created by another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "quote not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#retrieve-a-quote"
        }
      }
    },
    "/marketplace/quotes": {
      "get": {
        "operationId": "marketplace-orders.list-quotes",
        "summary": "List quotes",
        "description": "Returns the caller's quotes.\n\nThe Marketplace page shows each returned quote as a chip with its wallet count, total and status.\n\nThe API does not serve this route yet: it answers `404` with an empty body. Keep the IDs returned by [Create a quote](/reference/marketplace-orders/#create-a-quote) until it does.",
        "tags": [
          "Marketplace orders"
        ],
        "responses": {
          "200": {
            "description": "Returns an array of [Quote](#object-quote) objects.",
            "content": {
              "application/json": {
                "example": [
                  {
                    "id": "96332c18-bc7b-48c7-a6a8-e95cc039a9d3",
                    "chain": "solana",
                    "status": "reserved",
                    "items": [
                      {
                        "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                        "user_price": "135000000",
                        "balance": "41250000",
                        "token_holdings": []
                      },
                      {
                        "wallet_id": "b99b3501-9fbb-49a4-b344-226023503aca",
                        "user_price": "128000000",
                        "balance": "38900000",
                        "token_holdings": []
                      }
                    ],
                    "user_price_total": "263000000",
                    "buyer_ref": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                    "pay_address": "NEHongC3s1wu2512RY9PeCSKxSafTewh4LaBtZLUwqYa",
                    "pay_checkout_url": null,
                    "pay_intent_id": null,
                    "payment_tx_hash": null,
                    "reserved_until": "2026-11-02T14:05:30Z",
                    "hard_expiry": "2026-11-02T14:30:00Z",
                    "created_at": "2026-11-02T14:00:30Z",
                    "completed_at": null,
                    "received_amount": "0",
                    "expected_amount": "263000000",
                    "payment_status": "awaiting_payment",
                    "sell_tokens_after_purchase": true
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "x-proxima-client-only": true,
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#list-quotes"
        }
      }
    },
    "/marketplace/quote/{quote_id}/wallets": {
      "get": {
        "operationId": "marketplace-orders.list-quote-wallets",
        "summary": "List quote wallets",
        "description": "Returns the wallets a quote reserved, with their addresses.\n\nA durable snapshot of the reserved lot: it stays readable after the hold expires or is cancelled.\n\nNot called by the current web app.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Quote id returned by [Create a quote](#create-a-quote).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "wallet_id": {
                        "type": "string",
                        "description": "Marketplace wallet id."
                      },
                      "pubkey": {
                        "type": "string",
                        "description": "Wallet address."
                      },
                      "user_price": {
                        "type": "string",
                        "description": "Price of the wallet in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                      },
                      "balance": {
                        "type": "string",
                        "description": "Native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                      },
                      "age_days_at_reserve": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Wallet age in days when reserved, as a decimal string."
                      }
                    },
                    "required": [
                      "wallet_id",
                      "pubkey",
                      "user_price",
                      "balance"
                    ]
                  }
                },
                "example": [
                  {
                    "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                    "pubkey": "mEQxMmVdmn9yzhgz4iHCejoj6QuKuCwXmc56ZNVRcrNk",
                    "user_price": "135000000",
                    "balance": "41250000",
                    "age_days_at_reserve": "80.2"
                  }
                ]
              }
            }
          },
          "404": {
            "description": "`not_found`: The quote does not exist or was created by another account. Use a quote id that [Create a quote](/reference/marketplace-orders/#create-a-quote) returned to this account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The quote does not exist or was created by another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "quote not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#list-quote-wallets"
        }
      }
    },
    "/marketplace/quote/{quote_id}/refresh": {
      "post": {
        "operationId": "marketplace-orders.refresh-a-quote",
        "summary": "Refresh a quote",
        "description": "Extends a quote's reservation hold.\n\nEach refresh pushes `reserved_until` back by 30 seconds, within the quote's cap. The checkout calls it once when it opens on an unsettled quote.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Quote id returned by [Create a quote](#create-a-quote).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns the updated [Quote](#object-quote) object.",
            "content": {
              "application/json": {
                "example": {
                  "id": "96332c18-bc7b-48c7-a6a8-e95cc039a9d3",
                  "chain": "solana",
                  "status": "reserved",
                  "items": [
                    {
                      "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                      "user_price": "135000000",
                      "balance": "41250000",
                      "token_holdings": []
                    },
                    {
                      "wallet_id": "b99b3501-9fbb-49a4-b344-226023503aca",
                      "user_price": "128000000",
                      "balance": "38900000",
                      "token_holdings": []
                    }
                  ],
                  "user_price_total": "263000000",
                  "buyer_ref": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                  "pay_address": "NEHongC3s1wu2512RY9PeCSKxSafTewh4LaBtZLUwqYa",
                  "pay_checkout_url": null,
                  "pay_intent_id": null,
                  "payment_tx_hash": null,
                  "reserved_until": "2026-11-02T14:05:30Z",
                  "hard_expiry": "2026-11-02T14:30:00Z",
                  "created_at": "2026-11-02T14:00:30Z",
                  "completed_at": null,
                  "received_amount": "0",
                  "expected_amount": "263000000",
                  "payment_status": "awaiting_payment",
                  "sell_tokens_after_purchase": true
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The quote does not exist or was created by another account. Use a quote id that [Create a quote](/reference/marketplace-orders/#create-a-quote) returned to this account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The quote does not exist or was created by another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "quote not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat only pushes the hold back again, within the quote's cap."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#refresh-a-quote"
        }
      }
    },
    "/marketplace/quote/{quote_id}/settle": {
      "post": {
        "operationId": "marketplace-orders.settle-a-quote",
        "summary": "Settle a quote",
        "description": "Confirms the purchase and forces a payment check.\n\nOptional: a quote settles on its own once the deposit reaches `expected_amount`. The call is safe to repeat. The checkout calls it right after paying, then every 4 seconds until the quote settles.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Quote id returned by [Create a quote](#create-a-quote).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns the updated [Quote](#object-quote) object.",
            "content": {
              "application/json": {
                "example": {
                  "id": "96332c18-bc7b-48c7-a6a8-e95cc039a9d3",
                  "chain": "solana",
                  "status": "settled",
                  "items": [
                    {
                      "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                      "user_price": "135000000",
                      "balance": "41250000",
                      "token_holdings": []
                    },
                    {
                      "wallet_id": "b99b3501-9fbb-49a4-b344-226023503aca",
                      "user_price": "128000000",
                      "balance": "38900000",
                      "token_holdings": []
                    }
                  ],
                  "user_price_total": "263000000",
                  "buyer_ref": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                  "pay_address": "NEHongC3s1wu2512RY9PeCSKxSafTewh4LaBtZLUwqYa",
                  "pay_checkout_url": null,
                  "pay_intent_id": null,
                  "payment_tx_hash": "1hngFymVsG1N5viNWg6uyWcKWmdKjJvqt7DkfhGu5CvARP7QMyk81DTiiPU9EkDA33ohCZxzEQxk3qKYWNhBjk8J",
                  "reserved_until": "2026-11-02T14:05:30Z",
                  "hard_expiry": "2026-11-02T14:30:00Z",
                  "created_at": "2026-11-02T14:00:30Z",
                  "completed_at": "2026-11-02T14:02:11Z",
                  "received_amount": "263000000",
                  "expected_amount": "263000000",
                  "payment_status": "awaiting_payment",
                  "sell_tokens_after_purchase": true
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The quote does not exist or was created by another account. Use a quote id that [Create a quote](/reference/marketplace-orders/#create-a-quote) returned to this account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The quote does not exist or was created by another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "quote not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Settling only checks the payment and confirms the buyer; it never charges or books the sale twice."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#settle-a-quote"
        }
      }
    },
    "/marketplace/quote/{quote_id}/cancel": {
      "post": {
        "operationId": "marketplace-orders.cancel-a-quote",
        "summary": "Cancel a quote",
        "description": "Releases a quote's reserved wallets.\n\nThe checkout cancels the held quote when it is closed before any payment was sent, and ignores failures because the hold may already be settled or expired.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Quote id returned by [Create a quote](#create-a-quote).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the reservation was released."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The quote does not exist or was created by another account. Use a quote id that [Create a quote](/reference/marketplace-orders/#create-a-quote) returned to this account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The quote does not exist or was created by another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "quote not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The quote can no longer be cancelled, and the message is the marketplace's. If it settled in the meantime, the API delivers its wallets to the caller's account. Read the quote's `status` with [Retrieve a quote](/reference/marketplace-orders/#retrieve-a-quote); a `settled` quote has already been delivered.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The quote can no longer be cancelled, and the message is the marketplace's. If it settled in the meantime, the API delivers its wallets to the caller's account.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "<message>"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A repeat after a successful cancel answers `409`."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#cancel-a-quote"
        }
      }
    },
    "/marketplace/quote/{quote_id}/pay": {
      "post": {
        "operationId": "marketplace-orders.pay-a-quote",
        "summary": "Pay a quote",
        "description": "Pays a reserved quote from one of the caller's funder wallets.\n\nThe amount and destination are not parameters: the API sends `expected_amount − received_amount` to the quote's `pay_address`, so a partial deposit is topped up rather than paid twice. The network fee is paid on top of the amount. After a successful call the checkout settles the quote and polls until it does.\n\n**Moves funds.** The call signs and sends a transfer from the selected funder. It is not idempotent: only the checks above stop a second debit.\n\nAccounts that protect withdrawals with 2FA are challenged here, because the deposit address is not one of their funders.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Quote id returned by [Create a quote](#create-a-quote).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "funder_pubkey": {
                    "type": "string",
                    "description": "Funder wallet that pays: a base58 pubkey on Solana, a `0x` address on EVM chains. It must belong to the caller's license."
                  }
                },
                "required": [
                  "funder_pubkey"
                ]
              },
              "example": {
                "funder_pubkey": "Fgi2HMYCFt7Hu4ZR7fmiHNxQQvqVDgPx8WUz23zE33Xc"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when the transfer was sent."
                    },
                    "quote_id": {
                      "type": "string",
                      "description": "Quote that was paid."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Chain the payment was sent on."
                    },
                    "recipient": {
                      "type": "string",
                      "description": "Deposit address that received the payment."
                    },
                    "amount_sent": {
                      "type": "string",
                      "description": "Amount sent in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                    },
                    "tx": {
                      "type": "string",
                      "description": "Payment transaction signature or hash."
                    }
                  },
                  "required": [
                    "ok",
                    "quote_id",
                    "chain",
                    "recipient",
                    "amount_sent",
                    "tx"
                  ]
                },
                "example": {
                  "ok": true,
                  "quote_id": "96332c18-bc7b-48c7-a6a8-e95cc039a9d3",
                  "chain": "sol",
                  "recipient": "NEHongC3s1wu2512RY9PeCSKxSafTewh4LaBtZLUwqYa",
                  "amount_sent": "263000000",
                  "tx": "1hngFymVsG1N5viNWg6uyWcKWmdKjJvqt7DkfhGu5CvARP7QMyk81DTiiPU9EkDA33ohCZxzEQxk3qKYWNhBjk8J"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `funder_pubkey` is missing or blank. A body that does not parse answers `invalid body: <detail>`. Send `funder_pubkey` with the address of the wallet that pays.\n\n`bad_request`: `funder_pubkey` is not a wallet of the caller's account whose key the API holds. On EVM chains the message is `no signable wallet for license: <address>`, and an address that does not parse answers `invalid funder address: <address>`. Pay from one of the account's own wallets, such as one returned by [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`funder_pubkey` is missing or blank. A body that does not parse answers `invalid body: <detail>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "funder_pubkey is required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`funder_pubkey` is not a wallet of the caller's account whose key the API holds. On EVM chains the message is `no signable wallet for license: <address>`, and an address that does not parse answers `invalid funder address: <address>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "wallet not found for license: <funder_pubkey>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The quote does not exist or was created by another account. Use a quote id that [Create a quote](/reference/marketplace-orders/#create-a-quote) returned to this account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The quote does not exist or was created by another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "quote not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: Fewer than 15 seconds remain on the hold, too little for a transfer to land and be seen. Extend the hold with [Refresh a quote](/reference/marketplace-orders/#refresh-a-quote), then pay again.\n\n`conflict`: The quote is not `reserved`, so it cannot be paid. A hold that has already run out answers `the reservation has expired — reserve the lot again`. Reserve the lot again with [Create a quote](/reference/marketplace-orders/#create-a-quote).\n\n`conflict`: The marketplace has not provisioned the deposit address yet. Wait until [Retrieve a quote](/reference/marketplace-orders/#retrieve-a-quote) returns a `pay_address`, then pay again.\n\n`conflict`: A payment for this quote is already in flight or waiting to be credited, so the API refuses to send another. Related messages: `the deposit is already funded — waiting for settlement`, `payment already landed; waiting for settlement`, `payment confirmation is pending; retry to check its status`. Poll [Settle a quote](/reference/marketplace-orders/#settle-a-quote) until the quote settles instead of paying again.\n\n`conflict`: The funder cannot cover the amount plus the network fee. On EVM chains the amounts are in wei. Top up the funder, or pay from another wallet returned by [List funders](/reference/funders/#list-funders).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "Fewer than 15 seconds remain on the hold, too little for a transfer to land and be seen.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the reservation expires in <seconds>s — refresh the hold before paying"
                    }
                  },
                  "conflict_2": {
                    "summary": "The quote is not `reserved`, so it cannot be paid. A hold that has already run out answers `the reservation has expired — reserve the lot again`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "quote is <status> and cannot be paid"
                    }
                  },
                  "conflict_3": {
                    "summary": "The marketplace has not provisioned the deposit address yet.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "the deposit address is not provisioned yet"
                    }
                  },
                  "conflict_4": {
                    "summary": "A payment for this quote is already in flight or waiting to be credited, so the API refuses to send another. Related messages: `the deposit is already funded — waiting for settlement`, `payment already landed; waiting for settlement`, `payment confirmation is pending; retry to check its status`.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "a payment for this quote has already been sent and is waiting to be credited"
                    }
                  },
                  "conflict_5": {
                    "summary": "The funder cannot cover the amount plus the network fee. On EVM chains the amounts are in wei.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "funder holds <balance> lamports, needs <needed>"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The transfer was sent but has not confirmed yet. The quote stays locked to that payment, so a retry checks it instead of sending again. Other messages with this code: `hushxima api issue: payment transfer did not land; you can retry payment` (the transfer expired without landing and the lock is released), `hushxima api issue: payment transfer failed: <error>`, and any marketplace failure. Retry the call to check the transfer, or read `received_amount` with [Retrieve a quote](/reference/marketplace-orders/#retrieve-a-quote).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The transfer was sent but has not confirmed yet. The quote stays locked to that payment, so a retry checks it instead of sending again. Other messages with this code: `hushxima api issue: payment transfer did not land; you can retry payment` (the transfer expired without landing and the lock is released), `hushxima api issue: payment transfer failed: <error>`, and any marketplace failure.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: payment confirmation is pending; retry to check its status"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-2fa": true,
        "x-proxima-2fa-action": "wallet.withdraw",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A lost call may have sent funds. Read the quote with [Retrieve a quote](/reference/marketplace-orders/#retrieve-a-quote): a higher `received_amount` or a `status` past `reserved` means it was paid, and the API refuses a second payment while one is unconfirmed."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#pay-a-quote"
        }
      }
    },
    "/marketplace/quote/{quote_id}/deliver": {
      "post": {
        "operationId": "marketplace-orders.deliver-a-quote",
        "summary": "Deliver a quote",
        "description": "Imports a settled quote's wallets into the caller's account.\n\nSettlement is asynchronous, so poll this call: while the quote has not settled it answers `pending: true` with `imported: 0` and the current `status`. Once settled, the wallets are added to the account with their original funding time and venue, and the web app adds them to the chosen folders. Replaying a delivery is safe and never books the sale twice.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Quote id returned by [Create a quote](#create-a-quote).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "imported": {
                      "type": "integer",
                      "description": "Number of wallets imported by this call."
                    },
                    "pending": {
                      "type": "boolean",
                      "description": "`true` while the quote has not settled yet."
                    },
                    "status": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Quote status, e.g. `paid`, `settling` or `settled`."
                    },
                    "wallets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "wallet_id": {
                            "type": "string",
                            "description": "Marketplace wallet id."
                          },
                          "pubkey": {
                            "type": "string",
                            "description": "Wallet address, now in the caller's account."
                          }
                        },
                        "required": [
                          "wallet_id",
                          "pubkey"
                        ]
                      },
                      "description": "Delivered wallets."
                    }
                  },
                  "required": [
                    "imported",
                    "pending",
                    "wallets"
                  ]
                },
                "example": {
                  "imported": 2,
                  "pending": false,
                  "status": "settled",
                  "wallets": [
                    {
                      "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                      "pubkey": "mEQxMmVdmn9yzhgz4iHCejoj6QuKuCwXmc56ZNVRcrNk"
                    },
                    {
                      "wallet_id": "b99b3501-9fbb-49a4-b344-226023503aca",
                      "pubkey": "nFSZLpyf9UfANbyDzSf6igfD9CmTe975LeakYJEWiw4"
                    }
                  ]
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The quote does not exist or was created by another account. Use a quote id that [Create a quote](/reference/marketplace-orders/#create-a-quote) returned to this account.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The quote does not exist or was created by another account.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "quote not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The quote reached `expired`, `cancelled` or `failed` and can never be delivered. Start a new purchase with [Create a quote](/reference/marketplace-orders/#create-a-quote).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The quote reached `expired`, `cancelled` or `failed` and can never be delivered.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "quote is <status> — nothing to deliver"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Delivery is idempotent: a repeat imports no wallet twice, and `imported` counts only new ones."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#deliver-a-quote"
        }
      }
    },
    "/marketplace/purchases": {
      "get": {
        "operationId": "marketplace-orders.list-purchases",
        "summary": "List purchases",
        "description": "Returns the caller's settled purchases, newest first.\n\nFeeds the purchase history in the Marketplace and the wallet import pickers of the launch and funding flows.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum number of purchases. The web app always sends `100`; the API defaults to 50 and caps at 500.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns an array of [Purchase](#object-purchase) objects.",
            "content": {
              "application/json": {
                "example": [
                  {
                    "id": "dcf7c199-074f-4a38-8ea8-83bcaec48e4a",
                    "quote_id": "96332c18-bc7b-48c7-a6a8-e95cc039a9d3",
                    "chain": "solana",
                    "user_price_total": "263000000",
                    "wallet_count": 2,
                    "settled_at": "2026-11-02T14:02:11Z",
                    "payment_tx_hash": "1hngFymVsG1N5viNWg6uyWcKWmdKjJvqt7DkfhGu5CvARP7QMyk81DTiiPU9EkDA33ohCZxzEQxk3qKYWNhBjk8J"
                  }
                ]
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#list-purchases"
        }
      }
    },
    "/marketplace/purchases/{purchase_id}/wallets": {
      "get": {
        "operationId": "marketplace-orders.list-purchase-wallets",
        "summary": "List purchase wallets",
        "description": "Returns the wallets bought in one of the caller's purchases.\n\nThe web app reads it to import a past order's wallets into a launch or a funding run.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "purchase_id",
            "in": "path",
            "required": true,
            "description": "Purchase id from [List purchases](#list-purchases).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "wallet_id": {
                        "type": "string",
                        "description": "Marketplace wallet id."
                      },
                      "pubkey": {
                        "type": "string",
                        "description": "Wallet address."
                      },
                      "user_price": {
                        "type": "string",
                        "description": "Price paid for the wallet in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                      },
                      "age_days_at_sale": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Wallet age in days at the time of sale, as a decimal string."
                      }
                    },
                    "required": [
                      "wallet_id",
                      "pubkey",
                      "user_price"
                    ]
                  }
                },
                "example": [
                  {
                    "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                    "pubkey": "mEQxMmVdmn9yzhgz4iHCejoj6QuKuCwXmc56ZNVRcrNk",
                    "user_price": "135000000",
                    "age_days_at_sale": "80.2"
                  },
                  {
                    "wallet_id": "b99b3501-9fbb-49a4-b344-226023503aca",
                    "pubkey": "nFSZLpyf9UfANbyDzSf6igfD9CmTe975LeakYJEWiw4",
                    "user_price": "128000000",
                    "age_days_at_sale": "64.7"
                  }
                ]
              }
            }
          },
          "404": {
            "description": "`not_found`: The purchase does not exist or belongs to another license. Use a purchase id returned by [List purchases](/reference/marketplace-orders/#list-purchases).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The purchase does not exist or belongs to another license.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "purchase not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#list-purchase-wallets"
        }
      }
    },
    "/marketplace/wallets/by-pubkey/{pubkey}/tokens": {
      "get": {
        "operationId": "marketplace-orders.retrieve-wallet-tokens",
        "summary": "Retrieve a bought wallet's tokens",
        "description": "Returns the tokens a delivered Marketplace wallet still holds, with any queued operations.\n\nUsed by the *Sell all tokens* panel, which is switched off in the current web app.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "pubkey",
            "in": "path",
            "required": true,
            "description": "Address of a wallet bought on the Marketplace and delivered to the caller's account (base58 on Solana, `0x` address on EVM).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallet_id": {
                      "type": "string",
                      "description": "Marketplace wallet id."
                    },
                    "pubkey": {
                      "type": "string",
                      "description": "Wallet address."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Chain slug of the wallet."
                    },
                    "count": {
                      "type": "integer",
                      "description": "Number of tokens listed."
                    },
                    "has_tokens": {
                      "type": "boolean",
                      "description": "Whether the wallet holds any token."
                    },
                    "has_sellable_tokens": {
                      "type": "boolean",
                      "description": "Whether any token can be sold."
                    },
                    "has_queued_sell": {
                      "type": "boolean",
                      "description": "Whether a sell is already queued."
                    },
                    "has_queued_withdraw": {
                      "type": "boolean",
                      "description": "Whether a withdrawal is already queued."
                    },
                    "native_balance": {
                      "type": "string",
                      "description": "Native balance in the chain's smallest unit (lamports on Solana, wei on EVM chains), as an integer string."
                    },
                    "total_usd_value": {
                      "type": "number",
                      "description": "USD value of all tokens."
                    },
                    "sellable_usd_value": {
                      "type": "number",
                      "description": "USD value of the sellable part."
                    },
                    "tokens": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "mint": {
                            "type": "string",
                            "description": "Token mint or contract address."
                          },
                          "symbol": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Token symbol."
                          },
                          "decimals": {
                            "type": "integer",
                            "description": "Token decimals."
                          },
                          "balance": {
                            "type": "string",
                            "description": "Raw balance as an integer string."
                          },
                          "ui_multiplier": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Display multiplier scaled by 1e18."
                          },
                          "usd_value": {
                            "type": "number",
                            "description": "USD value of the balance."
                          },
                          "sellable_balance": {
                            "type": "string",
                            "description": "Raw sellable balance as an integer string."
                          },
                          "sellable_usd_value": {
                            "type": "number",
                            "description": "USD value of the sellable balance."
                          },
                          "post_sale": {
                            "type": "boolean",
                            "description": "`true` for a token received after the sale. The web app leaves these out of *Sell all*."
                          }
                        },
                        "required": [
                          "mint",
                          "decimals",
                          "balance",
                          "usd_value",
                          "sellable_balance",
                          "sellable_usd_value",
                          "post_sale"
                        ]
                      },
                      "description": "Token positions."
                    },
                    "queued_operations": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "description": "Operation id."
                          },
                          "kind": {
                            "type": "string",
                            "description": "Operation kind."
                          },
                          "mint": {
                            "type": "string",
                            "description": "Token concerned."
                          },
                          "status": {
                            "type": "string",
                            "description": "Operation status."
                          },
                          "to_address": {
                            "type": "string",
                            "description": "Destination address."
                          },
                          "tx_hash": {
                            "type": "string",
                            "description": "Transaction, once sent."
                          },
                          "created_at": {
                            "type": "string",
                            "description": "Queue time."
                          }
                        },
                        "required": [
                          "id",
                          "kind",
                          "mint",
                          "status",
                          "to_address",
                          "tx_hash",
                          "created_at"
                        ]
                      },
                      "description": "Sells and withdrawals in progress on the wallet."
                    }
                  },
                  "required": [
                    "wallet_id",
                    "pubkey",
                    "chain",
                    "count",
                    "has_tokens",
                    "has_sellable_tokens",
                    "has_queued_sell",
                    "has_queued_withdraw",
                    "total_usd_value",
                    "sellable_usd_value",
                    "tokens",
                    "queued_operations"
                  ]
                },
                "example": {
                  "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                  "pubkey": "mEQxMmVdmn9yzhgz4iHCejoj6QuKuCwXmc56ZNVRcrNk",
                  "chain": "solana",
                  "count": 1,
                  "has_tokens": true,
                  "has_sellable_tokens": true,
                  "has_queued_sell": false,
                  "has_queued_withdraw": false,
                  "native_balance": "40180000",
                  "total_usd_value": 0.84,
                  "sellable_usd_value": 0.84,
                  "tokens": [
                    {
                      "mint": "1kF6kS9Z9RitRBAbgT6LzzxDrdr8odsxtqfEE7PWRCF",
                      "symbol": "DEMO",
                      "decimals": 6,
                      "balance": "1520000000",
                      "ui_multiplier": null,
                      "usd_value": 0.84,
                      "sellable_balance": "1520000000",
                      "sellable_usd_value": 0.84,
                      "post_sale": false
                    }
                  ],
                  "queued_operations": []
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: `wallet not found`: the address is not one of the caller's delivered Marketplace wallets. The web app skips these wallets silently. Use the address of a wallet imported by [Deliver a quote](/reference/marketplace-orders/#deliver-a-quote).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "`wallet not found`: the address is not one of the caller's delivered Marketplace wallets. The web app skips these wallets silently.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "wallet not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Retry after a short wait; the failure is on the marketplace side.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#retrieve-wallet-tokens"
        }
      }
    },
    "/marketplace/wallets/by-pubkey/{pubkey}/sell-all": {
      "post": {
        "operationId": "marketplace-orders.sell-all-wallet-tokens",
        "summary": "Sell all of a bought wallet's tokens",
        "description": "Queues a sale of every token a delivered Marketplace wallet holds.\n\nTakes no body. Returns the queued operation ids; follow them with [Retrieve a bought wallet's tokens](#retrieve-wallet-tokens). A wallet that was paid for but not yet delivered is not addressable. The web app's caller sits in the *Sell all tokens* panel, which is switched off.\n\nSale proceeds stay on the wallet as its native token; nothing is transferred out. The call is not idempotent: a second call sells whatever arrived in between.",
        "tags": [
          "Marketplace orders"
        ],
        "parameters": [
          {
            "name": "pubkey",
            "in": "path",
            "required": true,
            "description": "Address of a wallet bought on the Marketplace and delivered to the caller's account (base58 on Solana, `0x` address on EVM).",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallet_id": {
                      "type": "string",
                      "description": "Marketplace wallet id."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Chain slug of the wallet."
                    },
                    "tokens": {
                      "type": "integer",
                      "description": "Number of tokens queued for sale."
                    },
                    "operation_ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Ids of the queued sell operations."
                    }
                  },
                  "required": [
                    "wallet_id",
                    "chain",
                    "tokens",
                    "operation_ids"
                  ]
                },
                "example": {
                  "wallet_id": "9fb9b985-594c-42e9-9592-fb986f90badb",
                  "chain": "solana",
                  "tokens": 1,
                  "operation_ids": [
                    "79645c07-73aa-4ea5-9b52-a83291f35785"
                  ]
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: `wallet not found`: the address is not one of the caller's delivered Marketplace wallets. The web app skips these wallets silently. Use the address of a wallet imported by [Deliver a quote](/reference/marketplace-orders/#deliver-a-quote).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "`wallet not found`: the address is not one of the caller's delivered Marketplace wallets. The web app skips these wallets silently.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "wallet not found"
                    }
                  }
                }
              }
            }
          },
          "422": {
            "description": "`upstream_failure`: The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`. Check `has_queued_sell` with [Retrieve a bought wallet's tokens](/reference/marketplace-orders/#retrieve-wallet-tokens) before retrying.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "upstream_failure": {
                    "summary": "The marketplace could not be reached, failed, or sent a body the API could not read. The body also carries `service: \"hushxima\"`.",
                    "value": {
                      "ok": false,
                      "code": "upstream_failure",
                      "message": "hushxima api issue: <message>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A repeat queues a sale of whatever the wallet holds by then. Check `has_queued_sell` with [Retrieve a bought wallet's tokens](/reference/marketplace-orders/#retrieve-wallet-tokens) before retrying."
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/marketplace-orders/#sell-all-wallet-tokens"
        }
      }
    },
    "/api/unread": {
      "get": {
        "operationId": "support.get-unread",
        "summary": "Get unread tickets",
        "description": "Returns how many tickets have unread agent replies, and which.\n\nDrives the badge on the support icon. Polled every 60 seconds and on window focus.",
        "tags": [
          "Support"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "type": "integer",
                      "description": "Number of tickets with unread replies."
                    },
                    "ticketIds": {
                      "type": "array",
                      "items": {
                        "type": "integer"
                      },
                      "description": "IDs of those tickets."
                    }
                  },
                  "required": [
                    "count",
                    "ticketIds"
                  ]
                },
                "example": {
                  "count": 1,
                  "ticketIds": [
                    1042
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#get-unread"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/tickets": {
      "get": {
        "operationId": "support.list-tickets",
        "summary": "List tickets",
        "description": "Lists the signed-in user's support tickets.\n\nPolled every 20 seconds while the support page is open.",
        "tags": [
          "Support"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tickets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "The user's tickets, as `SupportTicket` objects."
                    }
                  },
                  "required": [
                    "tickets"
                  ]
                },
                "example": {
                  "tickets": [
                    {
                      "id": 1042,
                      "number": "31042",
                      "title": "Chart stays on the loading screen",
                      "state": "open",
                      "priority": "normal",
                      "createdAt": "2026-10-28T14:03:11Z",
                      "updatedAt": "2026-10-28T15:20:45Z",
                      "lastAgentReplyAt": "2026-10-28T15:20:45Z",
                      "closedAt": null,
                      "articleCount": 3,
                      "unread": true
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#list-tickets"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      },
      "post": {
        "operationId": "support.create-ticket",
        "summary": "Create a ticket",
        "description": "Opens a new support conversation, with optional files and a diagnostics bundle.\n\nSent as `multipart/form-data`. The web client attaches a redacted diagnostics JSON string (page, app version, device, recent console logs, Sentry breadcrumbs, local/session storage with sensitive keys filtered) built by `buildDiagnostics()` in `src/lib/bugReport/collect.ts`.\n\nClient-side limits (from `src/config/support.ts`): title up to 200 characters, message 3 to 8000 characters, at most 5 files of 25 MiB each. Whether the worker enforces the same limits is not visible from the client.",
        "tags": [
          "Support"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "description": "Subject line."
                  },
                  "body": {
                    "type": "string",
                    "description": "First message."
                  },
                  "diagnostics": {
                    "type": "string",
                    "description": "Redacted diagnostics JSON, serialized as a string. Empty string if collection failed."
                  },
                  "display_name": {
                    "type": "string",
                    "description": "Name shown for the customer. Omitted when unknown."
                  },
                  "files": {
                    "type": "string",
                    "format": "binary",
                    "description": "Attachment. Repeat the field once per file."
                  }
                },
                "required": [
                  "title",
                  "body",
                  "diagnostics"
                ]
              },
              "example": {
                "title": "Chart stays on the loading screen",
                "body": "The chart on my launch never finishes loading.",
                "diagnostics": "{\"createdAt\":\"2026-10-28T14:03:10.512Z\",\"page\":{\"path\":\"/launch/4821/live\"}}",
                "display_name": "degen_dev",
                "files": "<screenshot.png>"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticket": {
                      "type": "object",
                      "description": "The created `SupportTicket`."
                    }
                  },
                  "required": [
                    "ticket"
                  ]
                },
                "example": {
                  "ticket": {
                    "id": 1043,
                    "number": "31043",
                    "title": "Chart stays on the loading screen",
                    "state": "new",
                    "priority": "normal",
                    "createdAt": "2026-10-28T14:03:11Z",
                    "updatedAt": "2026-10-28T14:03:11Z",
                    "lastAgentReplyAt": null,
                    "closedAt": null,
                    "articleCount": 1,
                    "unread": false
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call opens a new ticket. Before retrying, call [List tickets](/reference/support/#list-tickets) and check whether the ticket was created."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#create-ticket"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/tickets/{ticket_id}": {
      "get": {
        "operationId": "support.retrieve-ticket",
        "summary": "Retrieve a ticket",
        "description": "Returns a ticket and its full message thread.\n\nAfter a successful read the web client marks the ticket as read in its local cache. It also hides any attachment named `diagnostics.json` (the diagnostics bundle sent on creation) from the thread.",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticket": {
                      "type": "object",
                      "description": "The `SupportTicket`."
                    },
                    "articles": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Messages in the thread, as `SupportArticle` objects."
                    }
                  },
                  "required": [
                    "ticket",
                    "articles"
                  ]
                },
                "example": {
                  "ticket": {
                    "id": 1042,
                    "number": "31042",
                    "title": "Chart stays on the loading screen",
                    "state": "open",
                    "priority": "normal",
                    "createdAt": "2026-10-28T14:03:11Z",
                    "updatedAt": "2026-10-28T15:20:45Z",
                    "lastAgentReplyAt": "2026-10-28T15:20:45Z",
                    "closedAt": null,
                    "articleCount": 2,
                    "unread": false
                  },
                  "articles": [
                    {
                      "id": 88400,
                      "sender": "customer",
                      "author": "degen_dev",
                      "body": "The chart on my launch never finishes loading.",
                      "createdAt": "2026-10-28T14:03:11Z",
                      "attachments": []
                    },
                    {
                      "id": 88412,
                      "sender": "agent",
                      "author": "Proxima Support",
                      "body": "Thanks, we can reproduce it. A fix is rolling out today.",
                      "createdAt": "2026-10-28T15:20:45Z",
                      "attachments": []
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#retrieve-ticket"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/tickets/{ticket_id}/articles": {
      "post": {
        "operationId": "support.reply-to-ticket",
        "summary": "Reply to a ticket",
        "description": "Adds a customer message, with optional files, to a ticket.\n\nAfter a successful reply to a `closed` ticket, the web client shows it as `open` locally before refetching.",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "body": {
                    "type": "string",
                    "description": "Message text."
                  },
                  "files": {
                    "type": "string",
                    "format": "binary",
                    "description": "Attachment. Repeat the field once per file."
                  }
                },
                "required": [
                  "body"
                ]
              },
              "example": {
                "body": "It works now, thanks!"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "article": {
                      "type": "object",
                      "description": "The created `SupportArticle`."
                    }
                  },
                  "required": [
                    "article"
                  ]
                },
                "example": {
                  "article": {
                    "id": 88430,
                    "sender": "customer",
                    "author": "degen_dev",
                    "body": "It works now, thanks!",
                    "createdAt": "2026-10-28T16:02:09Z",
                    "attachments": []
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call posts a new message. Before retrying, call [Retrieve a ticket](/reference/support/#retrieve-ticket) and check whether the reply is in the thread."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#reply-to-ticket"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/tickets/{ticket_id}/close": {
      "post": {
        "operationId": "support.close-ticket",
        "summary": "Close a ticket",
        "description": "Closes a ticket on the customer's behalf.",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticket": {
                      "type": "object",
                      "description": "The updated `SupportTicket`."
                    }
                  },
                  "required": [
                    "ticket"
                  ]
                },
                "example": {
                  "ticket": {
                    "id": 1042,
                    "number": "31042",
                    "title": "Chart stays on the loading screen",
                    "state": "closed",
                    "priority": "normal",
                    "createdAt": "2026-10-28T14:03:11Z",
                    "updatedAt": "2026-10-28T16:05:00Z",
                    "lastAgentReplyAt": "2026-10-28T15:20:45Z",
                    "closedAt": "2026-10-28T16:05:00Z",
                    "articleCount": 3,
                    "unread": false
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Closing a closed ticket leaves it closed."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#close-ticket"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/tickets/{ticket_id}/articles/{article_id}/attachments/{attachment_id}": {
      "get": {
        "operationId": "support.download-attachment",
        "summary": "Download an attachment",
        "description": "Returns the raw bytes of a file attached to a ticket message.\n\nThe web client reads the body as a `Blob` and caches it for the session. Any non-2xx status is reported as \"Could not load attachment\".",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          },
          {
            "name": "article_id",
            "in": "path",
            "required": true,
            "description": "Article (message) ID.",
            "schema": {
              "type": "integer"
            },
            "example": 88412
          },
          {
            "name": "attachment_id",
            "in": "path",
            "required": true,
            "description": "Attachment ID.",
            "schema": {
              "type": "integer"
            },
            "example": 5521
          }
        ],
        "responses": {
          "200": {
            "description": "The file bytes. The content type is the attachment's own MIME type.",
            "content": {
              "application/octet-stream": {
                "example": "<binary>"
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#download-attachment"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/admin/tickets": {
      "get": {
        "operationId": "support.admin-list-tickets",
        "summary": "List all tickets (admin)",
        "description": "Lists every ticket for the admin support inbox.\n\nCalled from the admin support page with the admin's Proxima JWT. Polled every 20 seconds.",
        "tags": [
          "Support"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tickets": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "All tickets, as `AdminSupportTicket` objects."
                    }
                  },
                  "required": [
                    "tickets"
                  ]
                },
                "example": {
                  "tickets": [
                    {
                      "id": 1042,
                      "number": "31042",
                      "title": "Chart stays on the loading screen",
                      "state": "open",
                      "priority": "normal",
                      "status": "awaiting_agent",
                      "customer": "degen_dev",
                      "owner": null,
                      "createdAt": "2026-10-28T14:03:11Z",
                      "updatedAt": "2026-10-28T14:03:11Z",
                      "articleCount": 1
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#admin-list-tickets"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/admin/tickets/{ticket_id}": {
      "get": {
        "operationId": "support.admin-retrieve-ticket",
        "summary": "Retrieve a ticket (admin)",
        "description": "Returns a ticket and its full thread, including internal notes and system messages.",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticket": {
                      "type": "object",
                      "description": "The `AdminSupportTicket`."
                    },
                    "articles": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "description": "Article ID."
                          },
                          "sender": {
                            "type": "string",
                            "enum": [
                              "agent",
                              "customer",
                              "system"
                            ],
                            "description": "Who wrote the message."
                          },
                          "internal": {
                            "type": "boolean",
                            "description": "Internal note, hidden from the customer."
                          },
                          "author": {
                            "type": "string",
                            "description": "Display name of the author."
                          },
                          "body": {
                            "type": "string",
                            "description": "Message body."
                          },
                          "createdAt": {
                            "type": "string",
                            "description": "Creation timestamp."
                          },
                          "attachments": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            },
                            "description": "Attachments (`id`, `filename`, `size`, `contentType`). Admins also see `diagnostics.json`."
                          }
                        },
                        "required": [
                          "id",
                          "sender",
                          "internal",
                          "author",
                          "body",
                          "createdAt",
                          "attachments"
                        ]
                      },
                      "description": "Thread messages."
                    }
                  },
                  "required": [
                    "ticket",
                    "articles"
                  ]
                },
                "example": {
                  "ticket": {
                    "id": 1042,
                    "number": "31042",
                    "title": "Chart stays on the loading screen",
                    "state": "open",
                    "priority": "normal",
                    "status": "awaiting_agent",
                    "customer": "degen_dev",
                    "owner": null,
                    "createdAt": "2026-10-28T14:03:11Z",
                    "updatedAt": "2026-10-28T14:03:11Z",
                    "articleCount": 1
                  },
                  "articles": [
                    {
                      "id": 88400,
                      "sender": "customer",
                      "internal": false,
                      "author": "degen_dev",
                      "body": "The chart on my launch never finishes loading.",
                      "createdAt": "2026-10-28T14:03:11Z",
                      "attachments": [
                        {
                          "id": 5510,
                          "filename": "diagnostics.json",
                          "size": 48211,
                          "contentType": "application/json"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#admin-retrieve-ticket"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/admin/tickets/{ticket_id}/articles": {
      "post": {
        "operationId": "support.admin-reply-to-ticket",
        "summary": "Reply to a ticket (admin)",
        "description": "Posts an agent reply or an internal note on a ticket.",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "body": {
                    "type": "string",
                    "description": "Message text."
                  },
                  "internal": {
                    "type": "string",
                    "enum": [
                      "true",
                      "false"
                    ],
                    "description": "`true` posts an internal note the customer does not see."
                  },
                  "author_name": {
                    "type": "string",
                    "description": "Name to sign the reply with. Omitted when not set."
                  },
                  "files": {
                    "type": "string",
                    "format": "binary",
                    "description": "Attachment. Repeat the field once per file."
                  }
                },
                "required": [
                  "body",
                  "internal"
                ]
              },
              "example": {
                "body": "Thanks, we can reproduce it. A fix is rolling out today.",
                "internal": "false",
                "author_name": "Proxima Support"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "article": {
                      "type": "object",
                      "description": "The created admin article (same shape as in Retrieve a ticket (admin))."
                    }
                  },
                  "required": [
                    "article"
                  ]
                },
                "example": {
                  "article": {
                    "id": 88412,
                    "sender": "agent",
                    "internal": false,
                    "author": "Proxima Support",
                    "body": "Thanks, we can reproduce it. A fix is rolling out today.",
                    "createdAt": "2026-10-28T15:20:45Z",
                    "attachments": []
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call posts a new message or note. Before retrying, call [Retrieve a ticket (admin)](/reference/support/#admin-retrieve-ticket) and check whether it is in the thread."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#admin-reply-to-ticket"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/admin/tickets/{ticket_id}/update": {
      "post": {
        "operationId": "support.admin-update-ticket",
        "summary": "Update a ticket (admin)",
        "description": "Changes a ticket's state or priority, or snoozes it.",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "state": {
                    "type": "string",
                    "enum": [
                      "open",
                      "closed",
                      "pending reminder"
                    ],
                    "description": "New state."
                  },
                  "priority": {
                    "type": "string",
                    "enum": [
                      "low",
                      "normal",
                      "high"
                    ],
                    "description": "New priority."
                  },
                  "pendingDays": {
                    "type": "integer",
                    "description": "Reminder delay in days, used with `pending reminder`."
                  },
                  "authorName": {
                    "type": "string",
                    "description": "Agent name to record on the change."
                  }
                }
              },
              "example": {
                "state": "pending reminder",
                "pendingDays": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ticket": {
                      "type": "object",
                      "description": "The updated `AdminSupportTicket`."
                    }
                  },
                  "required": [
                    "ticket"
                  ]
                },
                "example": {
                  "ticket": {
                    "id": 1042,
                    "number": "31042",
                    "title": "Chart stays on the loading screen",
                    "state": "pending reminder",
                    "priority": "normal",
                    "status": "awaiting_customer",
                    "customer": "degen_dev",
                    "owner": "Proxima Support",
                    "createdAt": "2026-10-28T14:03:11Z",
                    "updatedAt": "2026-10-28T16:10:00Z",
                    "articleCount": 2
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Sending the same update again leaves the ticket in the same state."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#admin-update-ticket"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/api/admin/tickets/{ticket_id}/articles/{article_id}/attachments/{attachment_id}": {
      "get": {
        "operationId": "support.admin-download-attachment",
        "summary": "Download an attachment (admin)",
        "description": "Returns the raw bytes of any attachment, including diagnostics bundles.",
        "tags": [
          "Support"
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Ticket ID.",
            "schema": {
              "type": "integer"
            },
            "example": 1042
          },
          {
            "name": "article_id",
            "in": "path",
            "required": true,
            "description": "Article (message) ID.",
            "schema": {
              "type": "integer"
            },
            "example": 88400
          },
          {
            "name": "attachment_id",
            "in": "path",
            "required": true,
            "description": "Attachment ID.",
            "schema": {
              "type": "integer"
            },
            "example": 5510
          }
        ],
        "responses": {
          "200": {
            "description": "The file bytes.",
            "content": {
              "application/octet-stream": {
                "example": "<binary>"
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/support/#admin-download-attachment"
        },
        "servers": [
          {
            "url": "https://support-api.proxima.tools"
          }
        ]
      }
    },
    "/symbol": {
      "get": {
        "operationId": "datafeed-http.retrieve-symbol-stats",
        "summary": "Retrieve symbol stats",
        "description": "Returns a coin's header figures: supply, transaction count, per-window buys and sells, and price changes.\n\nCalled once the datafeed socket has authenticated the mint, with the same chart token. The web client uses `supply` as the circulating supply for market-cap charts.",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "mint",
            "in": "query",
            "required": true,
            "description": "Token mint or contract address.",
            "schema": {
              "type": "string"
            },
            "example": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "mint": {
                      "type": "string",
                      "description": "Token address."
                    },
                    "chain": {
                      "type": "string",
                      "description": "Datafeed chain slug."
                    },
                    "symbol": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Ticker."
                    },
                    "name": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Token name."
                    },
                    "supply": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Token supply."
                    },
                    "totalTxCount": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Total transaction count."
                    },
                    "windows": {
                      "type": "object",
                      "additionalProperties": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "buys": {
                                "type": "integer",
                                "description": "Buy count."
                              },
                              "sells": {
                                "type": "integer",
                                "description": "Sell count."
                              },
                              "buyVolumeUsd": {
                                "type": "number",
                                "description": "Buy volume, USD."
                              },
                              "sellVolumeUsd": {
                                "type": "number",
                                "description": "Sell volume, USD."
                              }
                            },
                            "required": [
                              "buys",
                              "sells",
                              "buyVolumeUsd",
                              "sellVolumeUsd"
                            ]
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Trades over one window, keyed `m5`, `h1`, `h4` or `h24`. `null` where the producer row does not state it."
                      },
                      "x-proxima-key": "window",
                      "description": "Keys `m5`, `h1`, `h4`, `h24`; each `null` where the producer's row does not state it."
                    },
                    "priceChange": {
                      "type": "object",
                      "description": "Keys `m5`, `h1`, `h4`, `h24`: price change in percent, or `null`."
                    },
                    "updatedAt": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Last refresh time (unit not visible from the client)."
                    }
                  },
                  "required": [
                    "mint",
                    "chain",
                    "windows",
                    "priceChange"
                  ]
                },
                "example": {
                  "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
                  "chain": "solana",
                  "symbol": "MCAT",
                  "name": "Moon Cat",
                  "supply": 1000000000,
                  "totalTxCount": 412,
                  "windows": {
                    "m5": {
                      "buys": 22,
                      "sells": 9,
                      "buyVolumeUsd": 600,
                      "sellVolumeUsd": 240
                    },
                    "h1": {
                      "buys": 80,
                      "sells": 32,
                      "buyVolumeUsd": 2200,
                      "sellVolumeUsd": 900
                    },
                    "h4": {
                      "buys": 80,
                      "sells": 32,
                      "buyVolumeUsd": 2200,
                      "sellVolumeUsd": 900
                    },
                    "h24": null
                  },
                  "priceChange": {
                    "m5": 12.5,
                    "h1": 48.1,
                    "h4": 48.1,
                    "h24": null
                  },
                  "updatedAt": 1762001941
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#retrieve-symbol-stats"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/screener": {
      "get": {
        "operationId": "datafeed-http.list-screener",
        "summary": "List a screener view",
        "description": "Returns one page of a screener ranking across one or more chains.\n\nDefined in the web client as `useScreener` (100 items per page, refetched every 4 seconds), but the screener pages currently read the live socket `/screener/live` instead (see [Market datafeed](/realtime/datafeed/)). Screener features are only enabled for admins, behind a feature flag that is on by default in development.",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "chains",
            "in": "query",
            "required": true,
            "description": "Comma-separated datafeed chain slugs.",
            "schema": {
              "type": "string"
            },
            "example": "solana,bsc"
          },
          {
            "name": "view",
            "in": "query",
            "required": true,
            "description": "`new`, `trending`, `graduating`, `migrated`, `mcap`, or a discover ranking `<metric>_<window>` with metric `volume`, `txns`, `mcapchange`, `mcapchangepct` and window `m1`, `m5`, `m30`, `h1`, `h24`.",
            "schema": {
              "type": "string"
            },
            "example": "volume_h1"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The web client sends 100.",
            "schema": {
              "type": "integer"
            },
            "example": 100
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next` from the previous page.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "view": {
                      "type": "string",
                      "description": "Echoed view."
                    },
                    "chains": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Echoed chains."
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "`ScreenerItem` rows, best first."
                    },
                    "next": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor for the next page, `null` at the end."
                    }
                  },
                  "required": [
                    "view",
                    "chains",
                    "items"
                  ]
                },
                "example": {
                  "view": "new",
                  "chains": [
                    "solana"
                  ],
                  "items": [
                    {
                      "chain": "solana",
                      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
                      "score": 1761998400,
                      "name": "Moon Cat",
                      "symbol": "MCAT",
                      "image": null,
                      "mcapUsd": 12300,
                      "priceUsd": 0.0000123
                    }
                  ],
                  "next": "eyJvIjoxMDB9"
                }
              }
            }
          },
          "401": {
            "description": "Screener token missing, expired or rejected. The web client fetches a new token and retries once. Fetch a new screener token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#list-screener"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/wallet/{addr}/positions": {
      "get": {
        "operationId": "datafeed-http.list-wallet-positions",
        "summary": "List wallet positions",
        "description": "Returns a wallet's token positions with cost basis and PnL.\n\nUsed by the wallet explorer (behind a feature flag) with 50 items per page, sorted by value.",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "addr",
            "in": "path",
            "required": true,
            "description": "Wallet address.",
            "schema": {
              "type": "string"
            },
            "example": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Datafeed chain slug.",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Sort order. The web client sends `value`.",
            "schema": {
              "type": "string",
              "enum": [
                "value",
                "activity"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The web client sends 50.",
            "schema": {
              "type": "integer"
            },
            "example": 50
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "`next` from the previous page.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "addr": {
                      "type": "string",
                      "description": "Echoed wallet."
                    },
                    "chain": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Echoed chain."
                    },
                    "open": {
                      "type": "boolean",
                      "description": "Whether only open positions are listed."
                    },
                    "sort": {
                      "type": "string",
                      "enum": [
                        "value",
                        "activity"
                      ],
                      "description": "Applied sort."
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "`WalletPosition` rows."
                    },
                    "next": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Cursor for the next page."
                    },
                    "truncated": {
                      "type": "boolean",
                      "description": "The datafeed stopped before reading the wallet's full history."
                    }
                  },
                  "required": [
                    "addr",
                    "open",
                    "sort",
                    "items",
                    "truncated"
                  ]
                },
                "example": {
                  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
                  "chain": "solana",
                  "open": true,
                  "sort": "value",
                  "items": [
                    {
                      "chain": "solana",
                      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
                      "symbol": "MCAT",
                      "balance": 1250000,
                      "balanceSource": "onchain",
                      "valueUsd": 15.4,
                      "totalPnlUsd": 18.9,
                      "lastActivityAt": 1762000210
                    }
                  ],
                  "next": null,
                  "truncated": false
                }
              }
            }
          },
          "401": {
            "description": "Wallet token missing, expired or rejected. The web client fetches a new token and retries once. Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#list-wallet-positions"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/wallet/{addr}/trades": {
      "get": {
        "operationId": "datafeed-http.list-wallet-trades",
        "summary": "List wallet trades",
        "description": "Returns a wallet's swaps, newest first, optionally for one token.",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "addr",
            "in": "path",
            "required": true,
            "description": "Wallet address.",
            "schema": {
              "type": "string"
            },
            "example": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Datafeed chain slug.",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          },
          {
            "name": "mint",
            "in": "query",
            "required": false,
            "description": "Restrict to one token.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The web client sends 50.",
            "schema": {
              "type": "integer"
            },
            "example": 50
          },
          {
            "name": "before",
            "in": "query",
            "required": false,
            "description": "`next` from the previous page.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "addr": {
                      "type": "string",
                      "description": "Echoed wallet."
                    },
                    "chain": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Echoed chain."
                    },
                    "mint": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Echoed mint filter."
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "`WalletTrade` rows."
                    },
                    "next": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Value for `before` on the next page."
                    },
                    "truncated": {
                      "type": "boolean",
                      "description": "The datafeed stopped before reading the wallet's full history."
                    }
                  },
                  "required": [
                    "addr",
                    "items",
                    "truncated"
                  ]
                },
                "example": {
                  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
                  "chain": "solana",
                  "mint": null,
                  "items": [
                    {
                      "ts": 1762000210,
                      "chain": "solana",
                      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
                      "symbol": "MCAT",
                      "side": "sell",
                      "tokenAmount": 750000,
                      "volumeUsd": 21.9,
                      "signature": "5h8Fq3mTzW1rVvJ6Yk2pS9cX4bN7dL3eG8aH1jK6uM2nP5qR9sT4vW7xY2zA3bC6dE8fG1hJ4kL7mN9pQ2rS5tU",
                      "innerIndex": 0
                    }
                  ],
                  "next": "b3BhcXVlLWN1cnNvcg",
                  "truncated": false
                }
              }
            }
          },
          "401": {
            "description": "Wallet token missing, expired or rejected. The web client fetches a new token and retries once. Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#list-wallet-trades"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/wallet/{addr}/summary": {
      "get": {
        "operationId": "datafeed-http.retrieve-wallet-summary",
        "summary": "Retrieve a wallet summary",
        "description": "Returns a wallet's trading totals over 1, 7 and 30 days.",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "addr",
            "in": "path",
            "required": true,
            "description": "Wallet address.",
            "schema": {
              "type": "string"
            },
            "example": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Datafeed chain slug.",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "addr": {
                      "type": "string",
                      "description": "Echoed wallet."
                    },
                    "chain": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Echoed chain."
                    },
                    "windows": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "volumeUsd": {
                            "type": "number",
                            "description": "Total volume, USD."
                          },
                          "buyVolumeUsd": {
                            "type": "number",
                            "description": "Buy volume, USD."
                          },
                          "sellVolumeUsd": {
                            "type": "number",
                            "description": "Sell volume, USD."
                          },
                          "trades": {
                            "type": "integer",
                            "description": "Trade count."
                          },
                          "buys": {
                            "type": "integer",
                            "description": "Buy count."
                          },
                          "sells": {
                            "type": "integer",
                            "description": "Sell count."
                          },
                          "tokens": {
                            "type": "integer",
                            "description": "Distinct tokens traded."
                          },
                          "realizedPnlUsd": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Realized PnL, USD."
                          },
                          "realizedComplete": {
                            "type": "boolean",
                            "description": "Whether the realized PnL covers every trade in the window."
                          }
                        },
                        "required": [
                          "volumeUsd",
                          "buyVolumeUsd",
                          "sellVolumeUsd",
                          "trades",
                          "buys",
                          "sells",
                          "tokens",
                          "realizedComplete"
                        ],
                        "description": "Activity over one window, keyed `1d`, `7d` or `30d`."
                      },
                      "x-proxima-key": "window",
                      "description": "Keys `1d`, `7d`, `30d` (each optional)."
                    },
                    "mints": {
                      "type": "integer",
                      "description": "Distinct tokens the wallet ever traded."
                    },
                    "truncated": {
                      "type": "boolean",
                      "description": "The datafeed stopped before reading the wallet's full history."
                    }
                  },
                  "required": [
                    "addr",
                    "windows",
                    "mints",
                    "truncated"
                  ]
                },
                "example": {
                  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
                  "chain": "solana",
                  "windows": {
                    "1d": {
                      "volumeUsd": 40.3,
                      "buyVolumeUsd": 18.4,
                      "sellVolumeUsd": 21.9,
                      "trades": 3,
                      "buys": 2,
                      "sells": 1,
                      "tokens": 1,
                      "realizedPnlUsd": 15,
                      "realizedComplete": true
                    }
                  },
                  "mints": 14,
                  "truncated": false
                }
              }
            }
          },
          "401": {
            "description": "Wallet token missing, expired or rejected. The web client fetches a new token and retries once. Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#retrieve-wallet-summary"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/wallet/{addr}/balances": {
      "get": {
        "operationId": "datafeed-http.retrieve-wallet-balances",
        "summary": "Retrieve wallet balances",
        "description": "Returns the tokens a Solana wallet holds on chain, priced where possible.\n\nSolana only: the web client always sends `chain=solana` and polls every 15 seconds. A token with no price has `valueUsd: null`, never `0`.",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "addr",
            "in": "path",
            "required": true,
            "description": "Solana wallet address.",
            "schema": {
              "type": "string"
            },
            "example": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
          },
          {
            "name": "chain",
            "in": "query",
            "required": true,
            "description": "Always `solana`.",
            "schema": {
              "type": "string",
              "enum": [
                "solana"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "addr": {
                      "type": "string",
                      "description": "Echoed wallet."
                    },
                    "chain": {
                      "type": "string",
                      "enum": [
                        "solana"
                      ],
                      "description": "Always `solana`."
                    },
                    "slot": {
                      "type": "integer",
                      "description": "Slot the balances were read at."
                    },
                    "readAt": {
                      "type": "integer",
                      "description": "Read time, unix seconds."
                    },
                    "live": {
                      "type": "boolean",
                      "description": "Whether the datafeed follows this wallet live."
                    },
                    "fresh": {
                      "type": "boolean",
                      "description": "Whether the book is up to date."
                    },
                    "native": {
                      "type": "object",
                      "description": "`{ lamports: string, balance, priceUsd, valueUsd }` for SOL."
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "mint": {
                            "type": "string",
                            "description": "Token mint."
                          },
                          "name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Token name."
                          },
                          "symbol": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Ticker."
                          },
                          "image": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Image URL."
                          },
                          "program": {
                            "type": "string",
                            "description": "Token program."
                          },
                          "decimals": {
                            "type": "integer",
                            "description": "Mint decimals."
                          },
                          "amount": {
                            "type": "string",
                            "description": "Raw amount in base units."
                          },
                          "balance": {
                            "type": "number",
                            "description": "UI amount."
                          },
                          "accounts": {
                            "type": "integer",
                            "description": "Token accounts summed."
                          },
                          "priceUsd": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Price, USD."
                          },
                          "priceSource": {
                            "anyOf": [
                              {
                                "type": "string",
                                "enum": [
                                  "screener",
                                  "swap",
                                  "native"
                                ]
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Where the price came from."
                          },
                          "priceAt": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Price time."
                          },
                          "valueUsd": {
                            "anyOf": [
                              {
                                "type": "number"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Value, USD; `null` when unpriced."
                          }
                        },
                        "required": [
                          "mint",
                          "program",
                          "decimals",
                          "amount",
                          "balance",
                          "accounts"
                        ]
                      },
                      "description": "One row per mint, every token account of that mint summed."
                    },
                    "totalValueUsd": {
                      "type": "number",
                      "description": "Sum of priced values, USD."
                    },
                    "unpriced": {
                      "type": "integer",
                      "description": "Number of tokens without a price."
                    },
                    "truncated": {
                      "type": "boolean",
                      "description": "The list was cut short (the web client labels it \"largest 1,000\")."
                    }
                  },
                  "required": [
                    "addr",
                    "chain",
                    "slot",
                    "readAt",
                    "live",
                    "fresh",
                    "native",
                    "items",
                    "totalValueUsd",
                    "unpriced",
                    "truncated"
                  ]
                },
                "example": {
                  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
                  "chain": "solana",
                  "slot": 377412908,
                  "readAt": 1762001941,
                  "live": true,
                  "fresh": true,
                  "native": {
                    "lamports": "2500000000",
                    "balance": 2.5,
                    "priceUsd": 187.42,
                    "valueUsd": 468.55
                  },
                  "items": [
                    {
                      "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
                      "name": "Moon Cat",
                      "symbol": "MCAT",
                      "image": null,
                      "program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
                      "decimals": 6,
                      "amount": "1250000000000",
                      "balance": 1250000,
                      "accounts": 1,
                      "priceUsd": 0.0000123,
                      "priceSource": "screener",
                      "priceAt": 1762001941,
                      "valueUsd": 15.4
                    }
                  ],
                  "totalValueUsd": 483.95,
                  "unpriced": 0,
                  "truncated": false
                }
              }
            }
          },
          "401": {
            "description": "Wallet token missing, expired or rejected. The web client fetches a new token and retries once. Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#retrieve-wallet-balances"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/wallet/{addr}/daily": {
      "get": {
        "operationId": "datafeed-http.list-wallet-daily",
        "summary": "List a wallet's daily activity",
        "description": "Returns one row per UTC day the wallet traded, newest first.",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "addr",
            "in": "path",
            "required": true,
            "description": "Wallet address.",
            "schema": {
              "type": "string"
            },
            "example": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Datafeed chain slug.",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "description": "Span in days. The web client offers 7, 30 (default) and 90.",
            "schema": {
              "type": "integer"
            },
            "example": 30
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "addr": {
                      "type": "string",
                      "description": "Echoed wallet."
                    },
                    "chain": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Echoed chain."
                    },
                    "days": {
                      "type": "integer",
                      "description": "Echoed span."
                    },
                    "available": {
                      "type": "boolean",
                      "description": "`false` where the charts database keeps no daily data yet."
                    },
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "day": {
                            "type": "string",
                            "description": "UTC day."
                          },
                          "chains": {
                            "type": "array",
                            "items": {
                              "type": "string"
                            },
                            "description": "Chains traded that day."
                          },
                          "trades": {
                            "type": "integer",
                            "description": "Trade count."
                          },
                          "buys": {
                            "type": "integer",
                            "description": "Buy count."
                          },
                          "sells": {
                            "type": "integer",
                            "description": "Sell count."
                          },
                          "tokens": {
                            "type": "integer",
                            "description": "Distinct tokens."
                          },
                          "volumeUsd": {
                            "type": "number",
                            "description": "Volume, USD."
                          },
                          "buyUsd": {
                            "type": "number",
                            "description": "Bought, USD."
                          },
                          "sellUsd": {
                            "type": "number",
                            "description": "Sold, USD."
                          },
                          "realizedPnlUsd": {
                            "type": "number",
                            "description": "Realized PnL, USD."
                          },
                          "realizedComplete": {
                            "type": "boolean",
                            "description": "Whether the PnL covers every trade of the day."
                          }
                        },
                        "required": [
                          "day",
                          "chains",
                          "trades",
                          "buys",
                          "sells",
                          "tokens",
                          "volumeUsd",
                          "buyUsd",
                          "sellUsd",
                          "realizedPnlUsd",
                          "realizedComplete"
                        ]
                      },
                      "description": "Days, newest first."
                    }
                  },
                  "required": [
                    "addr",
                    "days",
                    "available",
                    "items"
                  ]
                },
                "example": {
                  "addr": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
                  "chain": "solana",
                  "days": 30,
                  "available": true,
                  "items": [
                    {
                      "day": "2026-11-01",
                      "chains": [
                        "solana"
                      ],
                      "trades": 3,
                      "buys": 2,
                      "sells": 1,
                      "tokens": 1,
                      "volumeUsd": 40.3,
                      "buyUsd": 18.4,
                      "sellUsd": 21.9,
                      "realizedPnlUsd": 15,
                      "realizedComplete": true
                    }
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Wallet token missing, expired or rejected. The web client fetches a new token and retries once. Fetch a new wallet token with [Create an unscoped datafeed token](/reference/charts/#create-unscoped-token) and retry once.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#list-wallet-daily"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/img/{chain}/{mint}": {
      "get": {
        "operationId": "datafeed-http.retrieve-token-image",
        "summary": "Retrieve a token image",
        "description": "Returns a coin's thumbnail, sized for list rows.\n\nLoaded directly in an `<img>` tag, without credentials. With `ph=0` the datafeed answers an error when it has no image; without `ph` it answers a letter avatar. The screener's `useTokenImage` first requests `ph=0`, falls back to the letter avatar on error, and probes again after 10 and 30 seconds with `r=1` and `r=2` (`r` only changes the browser cache key).",
        "tags": [
          "Datafeed HTTP"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "path",
            "required": true,
            "description": "Datafeed chain slug.",
            "schema": {
              "type": "string"
            },
            "example": "solana"
          },
          {
            "name": "mint",
            "in": "path",
            "required": true,
            "description": "Token address.",
            "schema": {
              "type": "string"
            },
            "example": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
          },
          {
            "name": "s",
            "in": "query",
            "required": true,
            "description": "Size in pixels.",
            "schema": {
              "type": "integer",
              "enum": [
                64,
                128
              ],
              "default": "64"
            }
          },
          {
            "name": "ph",
            "in": "query",
            "required": false,
            "description": "`0` disables the letter-avatar placeholder.",
            "schema": {
              "type": "string",
              "enum": [
                "0"
              ]
            }
          },
          {
            "name": "r",
            "in": "query",
            "required": false,
            "description": "Retry counter; cache-buster only.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The image bytes.",
            "content": {
              "image/*": {
                "example": "<binary>"
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "beta",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#retrieve-token-image"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/telemetry": {
      "post": {
        "operationId": "datafeed-http.post-telemetry",
        "summary": "Send datafeed telemetry",
        "description": "Uploads client-side latency samples for the datafeed socket.\n\nOnly a sample of sessions report: the decision is drawn once per tab with a probability of 5% by default and kept in `sessionStorage` under `pxa_telemetry`. Sampled tabs flush every 30 seconds and when the page becomes hidden, with `navigator.sendBeacon` (so the body goes out as `text/plain`), falling back to `fetch` with `keepalive`. At most 500 values per metric are kept between flushes.\n\nThe URL is always derived from the datafeed socket URL. Metrics sent: `ws_decode_ms` (protobuf decode time), `rpc_rtt_ms` (RPC round trip), `push_gap_ms` (time between two pushes), `push_latency_ms` (server emit to client receive, corrected by an estimated clock offset from `serverEmitMs`).",
        "tags": [
          "Datafeed HTTP"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "metrics": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string",
                          "enum": [
                            "ws_decode_ms",
                            "rpc_rtt_ms",
                            "push_gap_ms",
                            "push_latency_ms"
                          ],
                          "description": "Metric name."
                        },
                        "values": {
                          "type": "array",
                          "items": {
                            "type": "number"
                          },
                          "description": "Non-negative samples in milliseconds."
                        }
                      },
                      "required": [
                        "name",
                        "values"
                      ]
                    },
                    "description": "One entry per metric with samples."
                  }
                },
                "required": [
                  "metrics"
                ]
              },
              "example": {
                "metrics": [
                  {
                    "name": "rpc_rtt_ms",
                    "values": [
                      41.2,
                      38.7,
                      55
                    ]
                  },
                  {
                    "name": "push_gap_ms",
                    "values": [
                      212,
                      980,
                      403
                    ]
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The web client ignores the response.",
            "content": {
              "application/json": {
                "example": null
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "unsafe",
          "note": "Each call records its samples again, so a retry can count them twice. The web app never retries."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/datafeed-http/#post-telemetry"
        },
        "servers": [
          {
            "url": "https://datafeed.proxima.tools"
          }
        ]
      }
    },
    "/status-page-api/overview/{status_page_id}": {
      "post": {
        "operationId": "status-page.retrieve-status-overview",
        "summary": "Retrieve the status overview",
        "description": "Returns monitors, groups, incidents, maintenance windows and announcements of the status page.\n\nThis is OneUptime's public status-page API, not a Proxima route. The web client sends an empty JSON object with `cache: no-store` and maps the result to its own model in `src/lib/statusPage/parse.ts`. Values are wrapped in OneUptime's typed objects (`{ \"_type\": \"DateTime\", \"value\": ... }`, `{ \"_type\": \"Color\", \"value\": ... }`). Only the fields below are read; OneUptime may send more. Any non-2xx status is thrown as \"Status page request failed (<status>)\".",
        "tags": [
          "Status & health"
        ],
        "parameters": [
          {
            "name": "status_page_id",
            "in": "path",
            "required": true,
            "description": "The Proxima status page ID (a UUID, hard-coded in `src/config/statusPage.ts`).",
            "schema": {
              "type": "string"
            },
            "example": "3f6c2a1e-8b7d-4c5e-9a0f-1b2c3d4e5f60"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "overallStatus": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Overall monitor status: `_id`, `name`, `color`, `isOperationalState`, `priority`."
                    },
                    "monitorStatuses": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "All monitor status definitions (same shape as `overallStatus`)."
                    },
                    "statusPageResources": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Monitors shown on the page: `_id`, `displayName`, `displayDescription`, `order`, `monitorId`, `monitorGroupId`, `statusPageGroupId`, `statusPageGroup`, `monitor.currentMonitorStatusId`."
                    },
                    "resourceGroups": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Groups: `_id`, `name`, `description`, `order`, `isExpandedByDefault`."
                    },
                    "monitorStatusTimelines": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Status changes: `monitorId`, `monitorStatus`, `startsAt`, `endsAt`, `createdAt`."
                    },
                    "monitorGroupCurrentStatuses": {
                      "type": "object",
                      "description": "Map of monitor group ID to current monitor status ID."
                    },
                    "activeIncidents": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Open incidents: `_id`, `title`, `description`, `createdAt`, `declaredAt`, `incidentSeverity`, `currentIncidentState`, `monitors`."
                    },
                    "incidentPublicNotes": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Public notes: `incidentId`, `note`, `postedAt`."
                    },
                    "scheduledMaintenanceEvents": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Maintenance windows: `_id`, `title`, `description`, `startsAt`, `endsAt`, `createdAt`, `currentScheduledMaintenanceState`, `monitors`."
                    },
                    "activeAnnouncements": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Announcements: `_id`, `title`, `description`, `createdAt`, `showAnnouncementAt`, `endAnnouncementAt`."
                    }
                  }
                },
                "example": {
                  "overallStatus": {
                    "_id": "0b9c8d7e-6f5a-4b3c-2d1e-0f9a8b7c6d5e",
                    "name": "Operational",
                    "color": {
                      "_type": "Color",
                      "value": "#10b981"
                    },
                    "isOperationalState": true,
                    "priority": 1
                  },
                  "statusPageResources": [
                    {
                      "_id": "6a1f2e3d-4c5b-4a69-8877-665544332211",
                      "displayName": "Datafeed",
                      "displayDescription": "Charts and live trades",
                      "order": 2,
                      "monitorId": {
                        "_type": "ObjectID",
                        "value": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f"
                      },
                      "statusPageGroupId": {
                        "_type": "ObjectID",
                        "value": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f70"
                      },
                      "monitor": {
                        "_id": "c1d2e3f4-a5b6-4c7d-8e9f-0a1b2c3d4e5f",
                        "currentMonitorStatusId": {
                          "_type": "ObjectID",
                          "value": "0b9c8d7e-6f5a-4b3c-2d1e-0f9a8b7c6d5e"
                        }
                      }
                    }
                  ],
                  "activeIncidents": [],
                  "scheduledMaintenanceEvents": [],
                  "activeAnnouncements": []
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Read-only despite the POST method."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/status-page/#retrieve-status-overview"
        },
        "servers": [
          {
            "url": "https://status.proxima.tools"
          }
        ]
      }
    },
    "/evm/dexscreener/create-order": {
      "post": {
        "operationId": "external-integrations.create-dexscreener-order",
        "summary": "Create a DexScreener order",
        "description": "Submits a token profile update to DexScreener and returns a payment link.\n\nSent from the \"Update DexScreener\" modal of a live launch. The web client opens the returned `paymentLink` in a new tab.\n\nUnlike the REST client, this call sends the session JWT **without** the `Bearer ` prefix (`Authorization: <JWT>`); the API's auth middleware accepts both forms. Any non-2xx is shown as \"Failed to update token on Dex Screener\". The host is the main API.",
        "tags": [
          "External integrations"
        ],
        "parameters": [
          {
            "name": "X-Sent-At",
            "in": "header",
            "required": false,
            "description": "Client send time in epoch milliseconds.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "tokenImage": {
                    "type": "string",
                    "format": "binary",
                    "description": "Square token image (the modal crops to 1:1)."
                  },
                  "tokenHeader": {
                    "type": "string",
                    "format": "binary",
                    "description": "Header banner image."
                  },
                  "data": {
                    "type": "string",
                    "description": "JSON-encoded profile."
                  }
                },
                "required": [
                  "tokenImage",
                  "data"
                ]
              },
              "example": {
                "tokenImage": "<token.png>",
                "data": "{\"chainId\":\"solana\",\"tokenAddress\":\"7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU\",\"description\":\"The cat that went to the moon.\",\"socials\":[{\"type\":\"x\",\"url\":\"https://x.com/mooncat\"}],\"websites\":[{\"label\":\"Website\",\"url\":\"https://mooncat.example\"}]}"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "paymentLink": {
                      "type": "string",
                      "description": "URL where the user pays for the DexScreener order."
                    }
                  },
                  "required": [
                    "paymentLink"
                  ]
                },
                "example": {
                  "paymentLink": "https://checkout.example.com/pay/9f8e7d6c-5b4a-4321-8765-0fedcba98765"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "bearer",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "unsafe",
          "note": "Each call creates a new order with its own payment link, and no endpoint lists existing orders. Retry only when the first call surely did not reach the server."
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/external-integrations/#create-dexscreener-order"
        },
        "servers": [
          {
            "url": "https://api-mig.proxima.tools"
          }
        ]
      }
    },
    "/": {
      "get": {
        "operationId": "external-integrations.search-charities",
        "summary": "Search charities",
        "description": "Searches the pump.fun charity directory by name.\n\nCalled from the charity picker when a creator assigns a fee share to a charity. Any non-2xx is thrown as \"pump.fun charity search failed\".",
        "tags": [
          "External integrations"
        ],
        "parameters": [
          {
            "name": "term",
            "in": "query",
            "required": true,
            "description": "Search text.",
            "schema": {
              "type": "string"
            },
            "example": "water"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum results.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "Accept",
            "in": "header",
            "required": false,
            "description": "`application/json`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Sent-At",
            "in": "header",
            "required": false,
            "description": "Client send time in epoch milliseconds.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "pageKey": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Pagination key. The web client does not page."
                    },
                    "response": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Matching charities (see Retrieve a charity)."
                    }
                  },
                  "required": [
                    "response"
                  ]
                },
                "example": {
                  "pageKey": null,
                  "response": [
                    {
                      "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
                      "name": "Clean Water Fund",
                      "slug": "clean-water-fund",
                      "logo": "https://charities.example.org/logo.png",
                      "website": "https://cleanwater.example.org",
                      "country": "US",
                      "isVerified": true,
                      "isEnabled": true
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/external-integrations/#search-charities"
        },
        "servers": [
          {
            "url": "https://charities.proxima.tools"
          }
        ]
      }
    },
    "/charities/{charity_id}": {
      "get": {
        "operationId": "external-integrations.retrieve-charity",
        "summary": "Retrieve a charity",
        "description": "Returns one charity from the pump.fun directory.\n\nUsed to resolve charity names on creator fee shares that only carry a `charity_id`. Names are cached in memory for the session.",
        "tags": [
          "External integrations"
        ],
        "parameters": [
          {
            "name": "charity_id",
            "in": "path",
            "required": true,
            "description": "Charity ID.",
            "schema": {
              "type": "string"
            },
            "example": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e"
          },
          {
            "name": "Accept",
            "in": "header",
            "required": false,
            "description": "`application/json`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-Sent-At",
            "in": "header",
            "required": false,
            "description": "Client send time in epoch milliseconds.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "description": "Charity ID."
                    },
                    "name": {
                      "type": "string",
                      "description": "Display name."
                    },
                    "slug": {
                      "type": "string",
                      "description": "URL slug."
                    },
                    "logo": {
                      "type": "string",
                      "description": "Logo URL."
                    },
                    "website": {
                      "type": "string",
                      "description": "Website URL."
                    },
                    "address": {
                      "type": "string",
                      "description": "Street address."
                    },
                    "city": {
                      "type": "string",
                      "description": "City."
                    },
                    "state": {
                      "type": "string",
                      "description": "State or region."
                    },
                    "country": {
                      "type": "string",
                      "description": "Country."
                    },
                    "zipCode": {
                      "type": "string",
                      "description": "Postal code."
                    },
                    "taxId": {
                      "type": "string",
                      "description": "Tax identifier."
                    },
                    "isVerified": {
                      "type": "boolean",
                      "description": "Verified by the directory."
                    },
                    "isEnabled": {
                      "type": "boolean",
                      "description": "Accepting donations."
                    },
                    "socials": {
                      "type": "object",
                      "description": "Optional `twitter`, `facebook`, `instagram`, `linkedin`, `youtube`, `blog` URLs."
                    }
                  },
                  "required": [
                    "id",
                    "name"
                  ]
                },
                "example": {
                  "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
                  "name": "Clean Water Fund",
                  "slug": "clean-water-fund",
                  "logo": "https://charities.example.org/logo.png",
                  "website": "https://cleanwater.example.org",
                  "city": "Austin",
                  "state": "TX",
                  "country": "US",
                  "isVerified": true,
                  "isEnabled": true,
                  "socials": {
                    "twitter": "https://x.com/cleanwaterfund"
                  }
                }
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/external-integrations/#retrieve-charity"
        },
        "servers": [
          {
            "url": "https://charities.proxima.tools"
          }
        ]
      }
    },
    "/{source}/{path}": {
      "get": {
        "operationId": "image-proxy.retrieve-proxied-image",
        "summary": "Retrieve a proxied image",
        "description": "Returns an image from one of the supported origins.\n\nUsed as an `<img>` source across the app and fetched as a blob by `downloadImage()` (image croppers, PnL card export). `downloadImage()` rejects responses smaller than 200 bytes as broken images.",
        "tags": [
          "Image proxy"
        ],
        "parameters": [
          {
            "name": "source",
            "in": "path",
            "required": true,
            "description": "Origin the image is fetched from (see the table above).",
            "schema": {
              "type": "string",
              "enum": [
                "proxima",
                "uxento",
                "ipfs",
                "four",
                "anoncoin",
                "printr",
                "axiom"
              ]
            },
            "example": "ipfs"
          },
          {
            "name": "path",
            "in": "path",
            "required": true,
            "description": "Image ID or path on the origin; may contain `/`.",
            "schema": {
              "type": "string"
            },
            "example": "QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG"
          }
        ],
        "responses": {
          "200": {
            "description": "The image bytes.",
            "content": {
              "image/*": {
                "example": "<binary>"
              }
            }
          }
        },
        "security": [],
        "x-proxima-auth": "none",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/image-proxy/#retrieve-proxied-image"
        },
        "servers": [
          {
            "url": "https://img.proxima.tools"
          }
        ]
      }
    },
    "/admin/users": {
      "get": {
        "operationId": "admin-users.list-users",
        "summary": "List users",
        "description": "Returns a page of accounts with their fees, metrics and referral data.\n\nBacks the admin users table. The account modal reads a single account with `account_id` and `limit=1`, the referred-accounts view lists up to 500 accounts by `referrer_account_id`, and the referrer picker searches by `search`.",
        "tags": [
          "Users and licenses"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The API defaults to 100 and caps at 500.",
            "schema": {
              "type": "integer",
              "default": "100"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of rows to skip.",
            "schema": {
              "type": "integer",
              "default": "0"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Matches part of the username or license key.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "account_id",
            "in": "query",
            "required": false,
            "description": "Restricts the results to one account.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "referrer_account_id",
            "in": "query",
            "required": false,
            "description": "Restricts the results to the accounts this account referred.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts metrics to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "required": false,
            "description": "Sort column. The API refuses `sell_fee_rate`, `buy_fee_rate` and `cashback_rate`.",
            "schema": {
              "type": "string",
              "enum": [
                "created_at",
                "username",
                "license_key",
                "launch_count",
                "pnl_usd",
                "pnl_native",
                "volume_sold_usd",
                "volume_sold_native",
                "volume_bought_usd",
                "volume_bought_native",
                "fees_paid_usd",
                "fees_paid_native",
                "referral_paid_usd",
                "referral_paid_native",
                "referral_profit_usd",
                "referral_profit_native",
                "referral_rate",
                "referred_count",
                "referred_revenue_usd",
                "referred_revenue_native",
                "referred_net_revenue_usd",
                "display_name",
                "referrer_license_key",
                "tier",
                "fee_rate",
                "sell_fee_rate",
                "buy_fee_rate",
                "cashback_rate"
              ],
              "default": "created_at"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "Sort direction.",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ],
              "default": "desc"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "users": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Accounts on this page. See [Admin user](#object-admin-user)."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Total number of matching accounts."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Applied page size."
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Applied offset."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when the results span several chains, so native amounts are not in a single unit."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "users",
                    "total",
                    "limit",
                    "offset",
                    "units"
                  ]
                },
                "example": {
                  "users": [
                    {
                      "account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
                      "username": "demouser",
                      "display_name": "Demo User",
                      "avatar_url": null,
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "created_at": 1748196000,
                      "tier": "standard",
                      "fee_rate": 500,
                      "sell_fee_rate": 500,
                      "buy_fee_rate": 0,
                      "cashback_rate": 0,
                      "is_active": true,
                      "is_internal": false,
                      "launch_count": 42,
                      "pnl_usd": "18250000000",
                      "pnl_native": "96400000000",
                      "volume_sold_usd": "412000000000",
                      "volume_sold_native": "2210000000000",
                      "volume_bought_usd": "393750000000",
                      "volume_bought_native": "2113600000000",
                      "fees_paid_usd": "20600000000",
                      "fees_paid_native": "110500000000",
                      "referral_paid_usd": "3090000000",
                      "referral_paid_native": "16575000000",
                      "referral_profit_usd": "1200000000",
                      "referral_profit_native": "6400000000",
                      "referral_fee_rate_current": 1500,
                      "referrer_license_key": "AFFILIATE01-Qm4Tz8Lp2Xc7Vb9Nw",
                      "referrer_username": "affiliate01",
                      "referrer_account_id": "3d6201aa-c053-4969-af46-2ba4b92d54ac",
                      "referred_license_keys": [
                        "SAMPLEDEV-Hy6Rk1Ws9Jd3Fq8Lp"
                      ],
                      "referred_count": 1,
                      "referred_revenue_usd": "8000000000",
                      "referred_revenue_native": "42800000000",
                      "referred_net_revenue_usd": "6800000000"
                    }
                  ],
                  "total": 1,
                  "limit": 100,
                  "offset": 0,
                  "native_mixed": true,
                  "units": {
                    "usd": "micro_usd",
                    "native": "lamports",
                    "time": "unix_seconds"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `order_by` is not a sortable column. The API refuses `sell_fee_rate`, `buy_fee_rate` and `cashback_rate`. An `order` other than `asc` or `desc` answers `invalid order: <order>`. Sort on another `order_by` column, with `order` set to `asc` or `desc`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`order_by` is not a sortable column. The API refuses `sell_fee_rate`, `buy_fee_rate` and `cashback_rate`. An `order` other than `asc` or `desc` answers `invalid order: <order>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid order_by: <order_by>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#list-users"
        }
      }
    },
    "/admin/get-mints": {
      "get": {
        "operationId": "admin-users.list-licenses-with-launches",
        "summary": "List licenses with launches",
        "description": "Returns every license with its launches and revenue figures.\n\nLoaded on the legacy `/admin/v1` pages only, where the users and launches tables are built from it client-side.",
        "tags": [
          "Users and licenses"
        ],
        "responses": {
          "200": {
            "description": "Returns an array with one entry per license.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "license": {
                        "type": "object",
                        "properties": {
                          "license_key": {
                            "type": "string",
                            "description": "License key."
                          },
                          "username": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Username."
                          },
                          "account_id": {
                            "type": "string",
                            "description": "Stable account id."
                          },
                          "tier": {
                            "type": "string",
                            "description": "License tier."
                          },
                          "fee_rate": {
                            "type": "integer",
                            "description": "Sell fee, in basis points."
                          },
                          "buy_fee_rate": {
                            "type": "integer",
                            "description": "Buy fee, in basis points."
                          },
                          "cashback_rate": {
                            "type": "integer",
                            "description": "Cashback rate, in basis points."
                          },
                          "is_active": {
                            "type": "boolean",
                            "description": "Whether the key is active."
                          },
                          "created_at": {
                            "type": "string",
                            "description": "Creation time."
                          },
                          "total_pnl_usd": {
                            "type": "string",
                            "description": "Lifetime P&L, in micro-USD, as an integer string."
                          },
                          "gross_volume_usd": {
                            "type": "string",
                            "description": "Lifetime gross volume, in micro-USD, as an integer string."
                          },
                          "referral": {
                            "type": "object",
                            "description": "Referral position: `referral_fee_rate`, `referred_keys`, `referrer_key`, `referrer_username`, `referrer_account_id`, profits and codes."
                          }
                        },
                        "required": [
                          "license_key",
                          "tier",
                          "fee_rate",
                          "created_at",
                          "total_pnl_usd",
                          "gross_volume_usd",
                          "referral"
                        ],
                        "description": "The license, in the shape its owner reads from `GET /license/get-license-info`, with its key under `license_key` and admin-only fields added."
                      },
                      "mints": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "launch_id": {
                              "type": "integer",
                              "description": "Launch id."
                            },
                            "chain_id": {
                              "type": "string",
                              "description": "Proxima chain id."
                            },
                            "mint_pubkey": {
                              "anyOf": [
                                {
                                  "type": "string"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Token address."
                            },
                            "launch_platform": {
                              "type": "string",
                              "description": "Launchpad."
                            },
                            "launch_method": {
                              "type": "string",
                              "enum": [
                                "Mev",
                                "Stagger",
                                "Manual",
                                "Allowlist"
                              ],
                              "description": "Launch method."
                            },
                            "launch_status": {
                              "type": "string",
                              "description": "Launch status."
                            },
                            "holder_count": {
                              "anyOf": [
                                {
                                  "type": "integer"
                                },
                                {
                                  "type": "null"
                                }
                              ],
                              "description": "Token holder count."
                            },
                            "gross_revenue_usd": {
                              "type": "string",
                              "description": "Fees Proxima earned on the launch, in micro-USD, as an integer string."
                            },
                            "gross_revenue_native": {
                              "type": "string",
                              "description": "Same, in lamports or wei, as an integer string."
                            },
                            "referral_paid_usd": {
                              "type": "string",
                              "description": "Referral paid on the launch, in micro-USD, as an integer string."
                            },
                            "referral_unpaid_usd": {
                              "type": "string",
                              "description": "Referral still owed on the launch, in micro-USD, as an integer string."
                            },
                            "referral_unpaid_status": {
                              "type": "string",
                              "enum": [
                                "settled",
                                "settling",
                                "requires_reconciliation"
                              ],
                              "description": "`settling` while a queued sweep will still pay the unpaid referral."
                            },
                            "revenue_net_usd": {
                              "type": "string",
                              "description": "Revenue after referral, in micro-USD, as an integer string."
                            }
                          },
                          "required": [
                            "launch_id",
                            "chain_id",
                            "launch_platform",
                            "launch_method",
                            "launch_status",
                            "gross_revenue_usd",
                            "gross_revenue_native"
                          ]
                        },
                        "description": "The license's launches, in the shape of `GET /license/get-mints-info`, plus admin revenue fields."
                      },
                      "launch_count": {
                        "type": "integer",
                        "description": "Number of launches."
                      },
                      "referred_revenue_usd": {
                        "type": "string",
                        "description": "Fees paid by the licenses this one referred, in micro-USD, as an integer string."
                      },
                      "referred_net_revenue_usd": {
                        "type": "string",
                        "description": "Referees' fees minus the referral paid back to this license, in micro-USD, as an integer string."
                      }
                    },
                    "required": [
                      "license",
                      "mints"
                    ]
                  }
                },
                "example": [
                  {
                    "license": {
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "username": "demouser",
                      "account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
                      "tier": "standard",
                      "fee_rate": 500,
                      "buy_fee_rate": 0,
                      "cashback_rate": 0,
                      "is_active": true,
                      "created_at": "2026-05-25T18:00:00",
                      "total_pnl_usd": "18250000000",
                      "gross_volume_usd": "805750000000",
                      "referral": {
                        "is_referred": true,
                        "referral_fee_rate": 1500,
                        "referred_keys": [
                          "SAMPLEDEV-Hy6Rk1Ws9Jd3Fq8Lp"
                        ],
                        "referrer_key": "AFFILIATE01-Qm4Tz8Lp2Xc7Vb9Nw",
                        "referrer_username": "affiliate01",
                        "referrer_account_id": "3d6201aa-c053-4969-af46-2ba4b92d54ac"
                      }
                    },
                    "mints": [
                      {
                        "launch_id": 18234,
                        "chain_id": "sol",
                        "mint_pubkey": "Pp3T3fAScMGZUxEMhYc34Bju7BTD5kF1z36adQsuMjdF",
                        "launch_platform": "pumpfun",
                        "launch_method": "Mev",
                        "launch_status": "Finalized",
                        "holder_count": 211,
                        "gross_revenue_usd": "412000000",
                        "gross_revenue_native": "2210000000",
                        "referral_paid_usd": "61800000",
                        "referral_unpaid_usd": "0",
                        "referral_unpaid_status": "settled",
                        "revenue_net_usd": "350200000"
                      }
                    ],
                    "launch_count": 42,
                    "referred_revenue_usd": "8000000000",
                    "referred_net_revenue_usd": "6800000000"
                  }
                ]
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#list-licenses-with-launches"
        }
      }
    },
    "/admin/add-license": {
      "post": {
        "operationId": "admin-users.create-a-license",
        "summary": "Create a license",
        "description": "Creates an account with a new license key.\n\nThe admin form strips the username to letters and digits and enters rates as percentages, sent in basis points. No referral code is consumed. The key is the upper-cased username, a hyphen and 17 random alphanumeric characters.\n\nThe response is the only place the new key is returned; hand it to the account owner securely.\n\nThe API currently ignores `referrer`, `referral_fee_rate` and `fee_rate`: the account starts with no referrer and default rates. Set them afterwards with [Update a license](#update-a-license).",
        "tags": [
          "Users and licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string",
                    "description": "Username of the new account: 3–50 letters, digits or hyphens, starting and ending with a letter or digit."
                  },
                  "referrer": {
                    "type": "string",
                    "description": "Username of the referrer."
                  },
                  "referral_fee_rate": {
                    "type": "integer",
                    "description": "Rate the new account earns on its own referrals, in basis points."
                  },
                  "fee_rate": {
                    "type": "integer",
                    "description": "Sell fee, in basis points."
                  }
                },
                "required": [
                  "username"
                ]
              },
              "example": {
                "username": "newtrader",
                "referrer": "affiliate01",
                "referral_fee_rate": 1500,
                "fee_rate": 500
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "license_key": {
                      "type": "string",
                      "description": "The new license key."
                    }
                  },
                  "required": [
                    "license_key"
                  ]
                },
                "example": {
                  "license_key": "NEWTRADER-Zt7Qp2Lm9Xc4Vb8Nk"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The username is not 3–50 characters. Other format messages: `username must start and end with a letter or number`, `username must be letters, numbers, or hyphens`. Send a username of 3 to 50 letters, digits or inner hyphens.\n\n`bad_request`: Another account already has this username. Choose another username, or find the existing account with [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The username is not 3–50 characters. Other format messages: `username must start and end with a letter or number`, `username must be letters, numbers, or hyphens`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "username must be 3-50 chars"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Another account already has this username.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "username already exists"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A lost call may have created the account, and a repeat then fails with `username already exists`. Search for the username with [List users](/reference/admin-users/#list-users) to read its key."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#create-a-license"
        }
      }
    },
    "/admin/update-license": {
      "post": {
        "operationId": "admin-users.update-a-license",
        "summary": "Update a license",
        "description": "Changes an account's referrer, referral rate, fees or cashback rate.\n\nOnly the fields present change. The client sends `new_referrer_account_id` when the referrer was picked from the user list and `new_referrer` (a username) otherwise, never both; an empty `new_referrer` clears the referrer. Rates are basis points from 0 to 10000 and also accept decimal strings. Changing the referrer does not waive referral already accrued.\n\nThe API currently ignores `new_cashback_rate`.",
        "tags": [
          "Users and licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "account_id": {
                    "type": "string",
                    "description": "Target account id (see [Admin user](#object-admin-user))."
                  },
                  "new_referrer": {
                    "type": "string",
                    "description": "Referrer's username. Empty string clears the referrer."
                  },
                  "new_referrer_account_id": {
                    "type": "string",
                    "description": "Referrer's account id. Takes precedence over `new_referrer` in the client."
                  },
                  "new_referral_fee_rate": {
                    "type": "integer",
                    "description": "Rate this account earns on its referrals, in basis points."
                  },
                  "new_fee_rate": {
                    "type": "integer",
                    "description": "Sell fee, in basis points."
                  },
                  "new_buy_fee_rate": {
                    "type": "integer",
                    "description": "Buy fee, in basis points."
                  },
                  "new_cashback_rate": {
                    "type": "integer",
                    "description": "Share of what Proxima keeps on this account's launches, after referrals, paid back to it, in basis points."
                  }
                },
                "required": [
                  "account_id"
                ]
              },
              "example": {
                "account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
                "new_referrer_account_id": "3d6201aa-c053-4969-af46-2ba4b92d54ac",
                "new_fee_rate": 400,
                "new_cashback_rate": 1000
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "Successfully updated license key"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: No target account is given. Send the target's `account_id`.\n\n`bad_request`: `new_fee_rate` is above 10000. The other rates answer `Invalid new referral fee rate` and `Invalid new buy fee rate`. Send rates in basis points, from 0 to 10000.\n\n`bad_request`: The new referrer is the account itself or one of its own referrals. Choose a referrer outside the account's own referral tree.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "No target account is given.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "account_id, license_key or username is required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`new_fee_rate` is above 10000. The other rates answer `Invalid new referral fee rate` and `Invalid new buy fee rate`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Invalid new fee rate"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The new referrer is the account itself or one of its own referrals.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "that referrer would create a referral cycle"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this `account_id`. Take the `account_id` from [List users](/reference/admin-users/#list-users).\n\n`not_found`: `new_referrer_account_id` matches no account. An unknown `new_referrer` username answers `Referrer username not found`. Pick the referrer from [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this `account_id`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "License not found"
                    }
                  },
                  "not_found_2": {
                    "summary": "`new_referrer_account_id` matches no account. An unknown `new_referrer` username answers `Referrer username not found`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "Referrer account not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Only the fields present are written, so a repeat sets the same values."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#update-a-license"
        }
      }
    },
    "/admin/rotate-key": {
      "post": {
        "operationId": "admin-users.rotate-a-license-key",
        "summary": "Rotate a license key",
        "description": "Replaces an account's license key with a new one.\n\nThe license keeps its data under the new key. Started from the account modal after a confirmation.\n\nIrreversible: the previous key stops existing. Give the owner the new key.",
        "tags": [
          "Users and licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "account_id": {
                    "type": "string",
                    "description": "Target account id (see [Admin user](#object-admin-user))."
                  }
                },
                "required": [
                  "account_id"
                ]
              },
              "example": {
                "account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "new_key": {
                      "type": "string",
                      "description": "The new license key."
                    }
                  },
                  "required": [
                    "new_key"
                  ]
                },
                "example": {
                  "new_key": "DEMOUSER-Rw5Hn2Jc8Lq4Zt7Xm"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `account_id` is missing. Send the target's `account_id`.\n\n`bad_request`: The key belongs to the calling admin's own user. Have another admin rotate this key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`account_id` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "account_id or username is required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The key belongs to the calling admin's own user.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Cannot rotate your own key"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this `account_id`. Take the `account_id` from [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this `account_id`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "account not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call issues another key. Compare the account's `license_key` in [List users](/reference/admin-users/#list-users) (filtered by `account_id`) with the key you had before retrying."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#rotate-a-license-key"
        }
      }
    },
    "/admin/set-key-active": {
      "post": {
        "operationId": "admin-users.set-license-key-active",
        "summary": "Activate or deactivate a license key",
        "description": "Turns an account's license key on or off.",
        "tags": [
          "Users and licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "account_id": {
                    "type": "string",
                    "description": "Target account id (see [Admin user](#object-admin-user))."
                  },
                  "is_active": {
                    "type": "boolean",
                    "description": "`false` deactivates the key, `true` reactivates it."
                  }
                },
                "required": [
                  "account_id",
                  "is_active"
                ]
              },
              "example": {
                "account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
                "is_active": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true` on success."
                    },
                    "message": {
                      "type": "string",
                      "description": "Human-readable confirmation."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "License key deactivated"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `account_id` is missing. Send the target's `account_id`.\n\n`bad_request`: Deactivating a key that belongs to the calling admin's own user. Have another admin deactivate this key.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`account_id` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "account_id or username is required"
                    }
                  },
                  "bad_request_2": {
                    "summary": "Deactivating a key that belongs to the calling admin's own user.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "Cannot deactivate your own key"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this `account_id`. Take the `account_id` from [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this `account_id`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "account not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "The call sets a state, so a repeat changes nothing."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#set-license-key-active"
        }
      }
    },
    "/admin/users/licenses": {
      "get": {
        "operationId": "admin-users.list-account-licenses",
        "summary": "List an account's licenses",
        "description": "Returns every license owned by the user behind an account.\n\nShown in the *Licenses* tab of the update-account modal.",
        "tags": [
          "Users and licenses"
        ],
        "parameters": [
          {
            "name": "account_id",
            "in": "query",
            "required": true,
            "description": "Account id of any license the user owns.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "user_id": {
                      "type": "string",
                      "description": "Id of the owning user."
                    },
                    "licenses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string",
                            "description": "License key."
                          },
                          "account_id": {
                            "type": "string",
                            "description": "Account id."
                          },
                          "username": {
                            "type": "string",
                            "description": "Username."
                          },
                          "display_name": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Display name."
                          },
                          "tier": {
                            "type": "string",
                            "description": "License tier."
                          },
                          "is_active": {
                            "type": "boolean",
                            "description": "Whether the key is active."
                          },
                          "avatar_url": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Avatar URL."
                          },
                          "banner_url": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Banner URL."
                          },
                          "banner_theme": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Banner preset id."
                          }
                        },
                        "required": [
                          "key",
                          "username",
                          "tier",
                          "is_active"
                        ]
                      },
                      "description": "Licenses the user owns."
                    }
                  },
                  "required": [
                    "user_id",
                    "licenses"
                  ]
                },
                "example": {
                  "user_id": "30ef31c8-0d62-4ba0-ab8a-04056428b5c5",
                  "licenses": [
                    {
                      "key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "account_id": "de6b26fc-9e5a-4a6b-9c50-0c75bc6c1598",
                      "username": "demouser",
                      "display_name": "Demo User",
                      "tier": "standard",
                      "is_active": true,
                      "avatar_url": null,
                      "banner_url": null,
                      "banner_theme": null
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `account_id` is missing. Send `account_id`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`account_id` is missing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "username or account_id is required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this `account_id`. Take the `account_id` from [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this `account_id`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "account not found"
                    }
                  }
                }
              }
            }
          },
          "409": {
            "description": "`conflict`: The account is not attached to a user, so there is no license list to read. Read the account on its own with [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "conflict": {
                    "summary": "The account is not attached to a user, so there is no license list to read.",
                    "value": {
                      "ok": false,
                      "code": "conflict",
                      "message": "target account has no associated user"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#list-account-licenses"
        }
      }
    },
    "/admin/tokens/read": {
      "post": {
        "operationId": "admin-users.create-a-read-token",
        "summary": "Create a read token",
        "description": "Issues a read-only JWT for tools, bound to its own session.\n\nThe token carries the caller's user and current license but is refused on every method except `GET`. It gets a session of its own, listed under its label in *Settings → Sessions*, so revoking it there leaves the admin signed in. The admin *Tokens* page creates it.\n\nThe token is shown only in this response. Store it like a password and revoke its session when it is no longer needed.",
        "tags": [
          "Users and licenses"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ttl_seconds": {
                    "type": "integer",
                    "description": "Lifetime, in seconds, from 60 to 15552000 (180 days). Also accepts a numeric string.",
                    "default": "7776000"
                  },
                  "label": {
                    "type": "string",
                    "description": "Name shown in the session list, up to 60 characters. Trimmed."
                  }
                }
              },
              "example": {
                "ttl_seconds": 2592000,
                "label": "Metrics notebook"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "token": {
                      "type": "string",
                      "description": "The read-only JWT. Send it as `Authorization: Bearer <token>`."
                    },
                    "session_id": {
                      "type": "string",
                      "description": "Session the token belongs to."
                    },
                    "expires_in": {
                      "type": "integer",
                      "description": "Lifetime applied, in seconds."
                    },
                    "expires_at": {
                      "type": "integer",
                      "description": "Expiry, Unix seconds."
                    },
                    "label": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Label applied."
                    }
                  },
                  "required": [
                    "ok",
                    "token",
                    "session_id",
                    "expires_in",
                    "expires_at"
                  ]
                },
                "example": {
                  "ok": true,
                  "token": "eyJhbGciOiJIUzI1NiJ9.eyJleGFtcGxlIjp0cnVlfQ.c2lnbmF0dXJlLW5vdC1yZWFs",
                  "session_id": "ad1db068-74c6-4ff0-966f-82d2ee372b0d",
                  "expires_in": 2592000,
                  "expires_at": 1796173200,
                  "label": "Metrics notebook"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The caller's session has not been upgraded onto a license yet. Upgrade the session with [Upgrade a session token](/reference/authentication/#upgrade-token) first.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The caller's session has not been upgraded onto a license yet.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "upgrade onto a license before minting a read token"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "Each call opens another session, and a lost token cannot be shown again. Find the session with user agent `read-token: <label>` in [List sessions](/reference/authentication/#list-sessions) and end it with [Revoke a session](/reference/authentication/#revoke-session)."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-users/#create-a-read-token"
        }
      }
    },
    "/admin/launches": {
      "get": {
        "operationId": "admin-launches.list-launches",
        "summary": "List launches",
        "description": "Returns a filtered, sorted page of launches across all accounts.\n\nList filters take comma-separated values. Empty filters and `chain_id=all` are left out of the query string.",
        "tags": [
          "Admin launches"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The API defaults to 50 and caps at 200.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of rows to skip.",
            "schema": {
              "type": "integer",
              "default": "0"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Comma-separated chain ids, such as `sol,base`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "account_id",
            "in": "query",
            "required": false,
            "description": "Restricts the results to one owner account.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "referrer_account_id",
            "in": "query",
            "required": false,
            "description": "Restricts the results to launches of the accounts this account referred.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Free-text search.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "launch_status",
            "in": "query",
            "required": false,
            "description": "Comma-separated launch statuses.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "description": "Comma-separated launchpads.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "launch_method",
            "in": "query",
            "required": false,
            "description": "Comma-separated launch methods: `mev`, `block0`, `stagger`, `manual`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "is_imported",
            "in": "query",
            "required": false,
            "description": "Filters on imported tokens.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "scheduled_mode",
            "in": "query",
            "required": false,
            "description": "Filters on scheduled launches.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "archived",
            "in": "query",
            "required": false,
            "description": "Filters on archived launches.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "shared",
            "in": "query",
            "required": false,
            "description": "Filters on launches with a live sharing grant.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "launched_from",
            "in": "query",
            "required": false,
            "description": "Earliest launch time, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "launched_to",
            "in": "query",
            "required": false,
            "description": "Latest launch time, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "required": false,
            "description": "Sort column. The API refuses `owner_username`.",
            "schema": {
              "type": "string",
              "enum": [
                "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"
              ],
              "default": "launched_at"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "Sort direction.",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ],
              "default": "desc"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Launches on this page. See [Admin launch](#object-admin-launch)."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Total number of matching launches."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Applied page size."
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Applied offset."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when the results span several chains, so native amounts are not in a single unit."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "items",
                    "total",
                    "limit",
                    "offset",
                    "units"
                  ]
                },
                "example": {
                  "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"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `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`.\n\n`bad_request`: 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.\n\n`bad_request`: `launched_from` or `launched_to` is too large to be read as a date. Send the time in Unix seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`order_by` is not a sortable column; the API refuses `owner_username`. An `order` other than `asc` or `desc` answers `invalid order: <order>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid order_by: <order_by>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "A `chain_id`, `launch_status`, `platform` or `launch_method` value is unknown. The message lists the accepted values.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid <field>: <value> (accepted: <values>)"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`launched_from` or `launched_to` is too large to be read as a date.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<field> is not a unix-seconds timestamp: <value>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this `account_id`. Take the `account_id` from [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this `account_id`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "account not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-launches/#list-launches"
        }
      }
    },
    "/admin/launches/{username}": {
      "get": {
        "operationId": "admin-launches.list-launches-for-a-user",
        "summary": "List a user's launches",
        "description": "Returns a page of one user's launches.\n\nNot called by the current web app.",
        "tags": [
          "Admin launches"
        ],
        "parameters": [
          {
            "name": "username",
            "in": "path",
            "required": true,
            "description": "Username of the owner.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The API defaults to 50 and caps at 200.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of rows to skip.",
            "schema": {
              "type": "integer",
              "default": "0"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Comma-separated chain ids, such as `sol,base`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Free-text search.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "launch_status",
            "in": "query",
            "required": false,
            "description": "Comma-separated launch statuses.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "description": "Comma-separated launchpads.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "launch_method",
            "in": "query",
            "required": false,
            "description": "Comma-separated launch methods: `mev`, `block0`, `stagger`, `manual`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "is_imported",
            "in": "query",
            "required": false,
            "description": "Filters on imported tokens.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "scheduled_mode",
            "in": "query",
            "required": false,
            "description": "Filters on scheduled launches.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "archived",
            "in": "query",
            "required": false,
            "description": "Filters on archived launches.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "shared",
            "in": "query",
            "required": false,
            "description": "Filters on launches with a live sharing grant.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "launched_from",
            "in": "query",
            "required": false,
            "description": "Earliest launch time, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "launched_to",
            "in": "query",
            "required": false,
            "description": "Latest launch time, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "order_by",
            "in": "query",
            "required": false,
            "description": "Sort column. The API refuses `owner_username`.",
            "schema": {
              "type": "string",
              "enum": [
                "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"
              ],
              "default": "launched_at"
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "Sort direction.",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ],
              "default": "desc"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Launches on this page. See [Admin launch](#object-admin-launch)."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Total number of matching launches."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Applied page size."
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Applied offset."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when the results span several chains, so native amounts are not in a single unit."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "items",
                    "total",
                    "limit",
                    "offset",
                    "units"
                  ]
                },
                "example": {
                  "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"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `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`.\n\n`bad_request`: 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.\n\n`bad_request`: `launched_from` or `launched_to` is too large to be read as a date. Send the time in Unix seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`order_by` is not a sortable column; the API refuses `owner_username`. An `order` other than `asc` or `desc` answers `invalid order: <order>`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid order_by: <order_by>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "A `chain_id`, `launch_status`, `platform` or `launch_method` value is unknown. The message lists the accepted values.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid <field>: <value> (accepted: <values>)"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`launched_from` or `launched_to` is too large to be read as a date.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<field> is not a unix-seconds timestamp: <value>"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this username. Use a username returned by [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this username.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "unknown username: <username>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-launches/#list-launches-for-a-user"
        }
      }
    },
    "/admin/get-launch-info/{launch_id}": {
      "get": {
        "operationId": "admin-launches.retrieve-launch-info",
        "summary": "Retrieve a launch",
        "description": "Returns the full configuration and wallets of any account's launch.\n\nSame 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.\n\nThe web app treats a body with `ok: false` as no launch.",
        "tags": [
          "Admin launches"
        ],
        "parameters": [
          {
            "name": "launch_id",
            "in": "path",
            "required": true,
            "description": "Launch id.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Returns a launch info object. The main fields are listed below.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "chain_id": {
                      "type": "string",
                      "description": "Proxima chain id."
                    },
                    "launch_method": {
                      "type": "string",
                      "enum": [
                        "Mev",
                        "Stagger",
                        "Manual",
                        "Allowlist"
                      ],
                      "description": "Launch method."
                    },
                    "funding_type": {
                      "type": "string",
                      "enum": [
                        "Classic",
                        "Cex"
                      ],
                      "description": "How the wallets were funded."
                    },
                    "is_graduated": {
                      "type": "boolean",
                      "description": "Whether the token left its bonding curve."
                    },
                    "creator_fees": {
                      "type": "integer",
                      "description": "Uncollected creator fees, in base units of the native or quote token. See [Collect creator fees](/reference/launch-fees/#collect-fees)."
                    },
                    "buy_delay": {
                      "type": "integer",
                      "description": "Delay between holder buys, in milliseconds."
                    },
                    "dev": {
                      "anyOf": [
                        {
                          "type": "object"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Dev wallet."
                    },
                    "funder": {
                      "type": "object",
                      "description": "Funder wallet."
                    },
                    "holder": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Holder wallets."
                    },
                    "front_mev": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Front MEV wallets."
                    },
                    "back_mev": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Back MEV wallets."
                    },
                    "temp_holder": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Temporary holder wallets."
                    },
                    "pnl_native": {
                      "type": "string",
                      "description": "P&L, in lamports or wei, as an integer string."
                    },
                    "pnl_usd": {
                      "type": "string",
                      "description": "P&L, in micro-USD, as an integer string."
                    },
                    "gross_volume_native": {
                      "type": "string",
                      "description": "Gross volume, in lamports or wei, as an integer string."
                    },
                    "gross_volume_usd": {
                      "type": "string",
                      "description": "Gross volume, in micro-USD, as an integer string."
                    },
                    "extra_rewards_native": {
                      "type": "string",
                      "description": "Extra rewards in native base units, as a string."
                    },
                    "extra_rewards_usd": {
                      "type": "string",
                      "description": "Extra rewards, in micro-USD, as an integer string."
                    },
                    "mm_pnl_native": {
                      "type": "string",
                      "description": "Market-making profit and loss in native base units, as a string."
                    },
                    "mm_pnl_usd": {
                      "type": "string",
                      "description": "Market-making profit and loss, in micro-USD, as an integer string."
                    }
                  },
                  "required": [
                    "chain_id",
                    "launch_method",
                    "is_graduated",
                    "funder",
                    "holder",
                    "front_mev",
                    "back_mev",
                    "temp_holder",
                    "pnl_native",
                    "pnl_usd",
                    "gross_volume_native",
                    "gross_volume_usd"
                  ]
                },
                "example": {
                  "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"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `launch_id` is not a valid launch id. Use a launch id returned by [List launches](/reference/admin-launches/#list-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`launch_id` is not a valid launch id.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid launch id format"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No launch has this id. Use a launch id returned by [List launches](/reference/admin-launches/#list-launches).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No launch has this id.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "launch not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-launches/#retrieve-launch-info"
        }
      }
    },
    "/admin/referral-codes/list": {
      "get": {
        "operationId": "admin-referrals.list-referral-codes",
        "summary": "List referral codes",
        "description": "Returns a filtered page of referral codes.",
        "tags": [
          "Admin referrals"
        ],
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Code status. The client leaves it out for all statuses.",
            "schema": {
              "type": "string",
              "enum": [
                "active",
                "revoked",
                "exhausted",
                "expired"
              ]
            }
          },
          {
            "name": "owner",
            "in": "query",
            "required": false,
            "description": "Owner's username.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "is_admin",
            "in": "query",
            "required": false,
            "description": "`true` lists only admin codes, `false` leaves them out.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Part of the code, case-insensitive.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "owner_search",
            "in": "query",
            "required": false,
            "description": "Part of the owner's username or license key, case-insensitive.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The API defaults to 50 and caps at 500.",
            "schema": {
              "type": "integer",
              "default": "50"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of rows to skip.",
            "schema": {
              "type": "integer",
              "default": "0"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "codes": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Codes on this page. See [Referral code](#object-referral-code)."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Total number of matching codes."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Applied page size."
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Applied offset."
                    }
                  },
                  "required": [
                    "codes",
                    "total",
                    "limit",
                    "offset"
                  ]
                },
                "example": {
                  "codes": [
                    {
                      "code": "spring-promo",
                      "is_admin": true,
                      "is_primary": false,
                      "status": "active",
                      "use_limit": 50,
                      "uses_count": 12,
                      "remaining_uses": 38,
                      "expires_at": "2026-12-31T23:59:59",
                      "label": "Spring promo",
                      "created_at": "2026-10-01T09:00:00",
                      "owner_license_key": null
                    }
                  ],
                  "total": 1,
                  "limit": 50,
                  "offset": 0
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: Unknown `status`. Send `active`, `revoked`, `exhausted` or `expired`, or leave `status` out.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "Unknown `status`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid status: <status>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#list-referral-codes"
        }
      }
    },
    "/admin/referral-codes/{code}/uses": {
      "get": {
        "operationId": "admin-referrals.retrieve-referral-code-uses",
        "summary": "List a referral code's uses",
        "description": "Returns the signups made with a code, newest first.",
        "tags": [
          "Admin referrals"
        ],
        "parameters": [
          {
            "name": "code",
            "in": "path",
            "required": true,
            "description": "The code.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string",
                      "description": "The code."
                    },
                    "uses": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "consumed_by": {
                            "type": "string",
                            "description": "License key created with the code."
                          },
                          "consumed_at": {
                            "type": "string",
                            "description": "Signup time, UTC."
                          }
                        },
                        "required": [
                          "consumed_by",
                          "consumed_at"
                        ]
                      },
                      "description": "Signups, newest first."
                    }
                  },
                  "required": [
                    "code",
                    "uses"
                  ]
                },
                "example": {
                  "code": "spring-promo",
                  "uses": [
                    {
                      "consumed_by": "SAMPLEDEV-Hy6Rk1Ws9Jd3Fq8Lp",
                      "consumed_at": "2026-10-14 09:12:33"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#retrieve-referral-code-uses"
        }
      }
    },
    "/admin/referral-codes/create": {
      "post": {
        "operationId": "admin-referrals.create-an-admin-referral-code",
        "summary": "Create an admin referral code",
        "description": "Creates an admin code, which lets people sign up without a referrer.",
        "tags": [
          "Admin referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "Custom code. Omit it for a random one."
                  },
                  "use_limit": {
                    "type": "integer",
                    "description": "Number of signups allowed, 1 to 10000. Omitted means single-use."
                  },
                  "use_limit_unlimited": {
                    "type": "boolean",
                    "description": "`true` for unlimited uses. Overrides `use_limit`."
                  },
                  "label": {
                    "type": "string",
                    "description": "Admin note, up to 20 characters."
                  },
                  "expires_at": {
                    "type": "string",
                    "description": "Expiry, as a UTC date-time without offset (`YYYY-MM-DDTHH:MM:SS`)."
                  }
                }
              },
              "example": {
                "code": "spring-promo",
                "use_limit": 50,
                "label": "Spring promo",
                "expires_at": "2026-12-31T23:59:59"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "code": {
                      "type": "string",
                      "description": "The code created."
                    },
                    "use_limit": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Allowed signups. `null` means unlimited."
                    }
                  },
                  "required": [
                    "ok",
                    "code"
                  ]
                },
                "example": {
                  "ok": true,
                  "code": "spring-promo",
                  "use_limit": 50
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The custom code has a character outside `a-z`, `0-9`, `-` and `_`. Other format messages: `referral code must be 3-32 chars`, `that referral code is reserved`. Send 3 to 32 lowercase letters, digits, `-` or `_`, and avoid reserved words.\n\n`bad_request`: The custom code already exists. Choose another code, or leave `code` out for a random one.\n\n`bad_request`: `label` is longer than 20 characters. Shorten `label` to 20 characters.\n\n`bad_request`: `use_limit` is outside 1 to 10000. Send a `use_limit` from 1 to 10000, or `use_limit_unlimited: true`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The custom code has a character outside `a-z`, `0-9`, `-` and `_`. Other format messages: `referral code must be 3-32 chars`, `that referral code is reserved`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "referral code must be a-z, 0-9, hyphen or underscore"
                    }
                  },
                  "bad_request_2": {
                    "summary": "The custom code already exists.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "code already in use"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`label` is longer than 20 characters.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "label must be <= 20 chars"
                    }
                  },
                  "bad_request_4": {
                    "summary": "`use_limit` is outside 1 to 10000.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "use_limit must be 1-10000 or unlimited"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "With a custom `code`, a repeat fails with `code already in use`. A random code is created anew on each call, so look for it with [List referral codes](/reference/admin-referrals/#list-referral-codes) (`is_admin=true`) first."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#create-an-admin-referral-code"
        }
      }
    },
    "/admin/referral-codes/grant": {
      "post": {
        "operationId": "admin-referrals.grant-referral-codes",
        "summary": "Grant referral codes",
        "description": "Issues extra referral codes to a user.\n\nGrants a batch of random single-use codes, custom codes, or both. Granted codes attach that user as referrer.",
        "tags": [
          "Admin referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string",
                    "description": "User who receives the codes."
                  },
                  "single_use_count": {
                    "type": "integer",
                    "description": "Number of random single-use codes, up to 100."
                  },
                  "custom": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "description": "Custom code. Omit it for a random one."
                        },
                        "use_limit": {
                          "type": "integer",
                          "description": "Number of signups allowed, 1 to 10000. Omitted means single-use."
                        },
                        "use_limit_unlimited": {
                          "type": "boolean",
                          "description": "`true` for unlimited uses. Overrides `use_limit`."
                        },
                        "label": {
                          "type": "string",
                          "description": "Admin note, up to 20 characters."
                        },
                        "expires_at": {
                          "type": "string",
                          "description": "Expiry, as a UTC date-time without offset (`YYYY-MM-DDTHH:MM:SS`)."
                        }
                      }
                    },
                    "description": "Custom codes."
                  }
                },
                "required": [
                  "username"
                ]
              },
              "example": {
                "username": "affiliate01",
                "single_use_count": 5,
                "custom": [
                  {
                    "code": "affiliate-vip",
                    "use_limit_unlimited": true,
                    "label": "VIP"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "username": {
                      "type": "string",
                      "description": "User who received the codes."
                    },
                    "issued": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Codes issued."
                    }
                  },
                  "required": [
                    "ok",
                    "username",
                    "issued"
                  ]
                },
                "example": {
                  "ok": true,
                  "username": "affiliate01",
                  "issued": [
                    "k7m2qz",
                    "p9x4vt",
                    "h3n8wd",
                    "r5c1jy",
                    "b6t0lf",
                    "affiliate-vip"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `single_use_count` is 0 and `custom` is empty. Set `single_use_count` above 0 or add a `custom` entry.\n\n`bad_request`: `single_use_count` is above 100. Grant at most 100 single-use codes per call.\n\n`bad_request`: A custom code is malformed. Other messages for a custom entry: `referral code must be 3-32 chars`, `that referral code is reserved`, `label must be <= 20 chars`, `use_limit must be 1-10000 or unlimited`. Nothing is granted. Give each custom entry a valid code, a label of up to 20 characters and a `use_limit` from 1 to 10000.\n\n`bad_request`: A custom code already exists. Nothing is granted: the batch is all or nothing. Choose another custom code, or leave `code` out of the entry for a random one.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`single_use_count` is 0 and `custom` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "nothing to grant"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`single_use_count` is above 100.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "single_use_count too large (max 100)"
                    }
                  },
                  "bad_request_3": {
                    "summary": "A custom code is malformed. Other messages for a custom entry: `referral code must be 3-32 chars`, `that referral code is reserved`, `label must be <= 20 chars`, `use_limit must be 1-10000 or unlimited`. Nothing is granted.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "referral code must be a-z, 0-9, hyphen or underscore"
                    }
                  },
                  "bad_request_4": {
                    "summary": "A custom code already exists. Nothing is granted: the batch is all or nothing.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "code already in use"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this username. Use a username returned by [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this username.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "username not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A lost call may have issued the codes, and a repeat issues new random ones. Look for the user's codes with [List referral codes](/reference/admin-referrals/#list-referral-codes) (`owner`) before retrying."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#grant-referral-codes"
        }
      }
    },
    "/admin/referral-codes/update": {
      "post": {
        "operationId": "admin-referrals.update-a-referral-code",
        "summary": "Update a referral code",
        "description": "Changes a code's label, expiry, use limit or active state.\n\nOmitted fields stay unchanged; `null` clears `label` or `expires_at` and makes `use_limit` unlimited. `is_active: true` reactivates a revoked code.",
        "tags": [
          "Admin referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "The code."
                  },
                  "label": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Admin note, up to 20 characters."
                  },
                  "expires_at": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Expiry, as a UTC date-time without offset."
                  },
                  "use_limit": {
                    "anyOf": [
                      {
                        "type": "integer"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Allowed signups, 1 to 10000. `null` means unlimited."
                  },
                  "is_active": {
                    "type": "boolean",
                    "description": "`false` revokes the code, `true` reactivates it."
                  }
                },
                "required": [
                  "code"
                ]
              },
              "example": {
                "code": "spring-promo",
                "use_limit": 100,
                "expires_at": null
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    }
                  },
                  "required": [
                    "ok"
                  ]
                },
                "example": {
                  "ok": true
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: The body changes no field. Send at least one of `label`, `expires_at`, `use_limit` or `is_active`.\n\n`bad_request`: `use_limit` is outside 1 to 10000. A `label` over 20 characters answers `label must be <= 20 chars`. Send a `use_limit` from 1 to 10000, or `null` for unlimited, and a label of up to 20 characters.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "The body changes no field.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "nothing to update"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`use_limit` is outside 1 to 10000. A `label` over 20 characters answers `label must be <= 20 chars`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "use_limit must be 1-10000 or unlimited"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The code does not exist. Use a code returned by [List referral codes](/reference/admin-referrals/#list-referral-codes).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The code does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "code not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "The call sets values, so a repeat changes nothing."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#update-a-referral-code"
        }
      }
    },
    "/admin/referral-codes/revoke": {
      "post": {
        "operationId": "admin-referrals.revoke-a-referral-code",
        "summary": "Revoke a referral code",
        "description": "Deactivates a code so it can no longer be used.\n\nThe code and its use history stay. Reactivate it with [Update a referral code](#update-a-referral-code).",
        "tags": [
          "Admin referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "The code."
                  }
                },
                "required": [
                  "code"
                ]
              },
              "example": {
                "code": "spring-promo"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "code": {
                      "type": "string",
                      "description": "The code revoked."
                    }
                  },
                  "required": [
                    "ok",
                    "code"
                  ]
                },
                "example": {
                  "ok": true,
                  "code": "spring-promo"
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The code does not exist. Use a code returned by [List referral codes](/reference/admin-referrals/#list-referral-codes).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The code does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "code not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Revoking a revoked code succeeds again."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#revoke-a-referral-code"
        }
      }
    },
    "/admin/referral-codes/delete": {
      "post": {
        "operationId": "admin-referrals.delete-a-referral-code",
        "summary": "Delete a referral code",
        "description": "Deletes a code and its use history, freeing its name.\n\nAccounts that signed up with the code keep their referrer. Deleting a primary code issues its owner a new random primary code.\n\nIrreversible: the use history is deleted with the code.",
        "tags": [
          "Admin referrals"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string",
                    "description": "The code."
                  }
                },
                "required": [
                  "code"
                ]
              },
              "example": {
                "code": "spring-promo"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "Always `true`."
                    },
                    "code": {
                      "type": "string",
                      "description": "The code deleted."
                    },
                    "replacement_code": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "New primary code issued to the owner when the deleted code was their primary."
                    }
                  },
                  "required": [
                    "ok",
                    "code"
                  ]
                },
                "example": {
                  "ok": true,
                  "code": "spring-promo",
                  "replacement_code": null
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `code` is empty. Send the code to delete.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`code` is empty.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "code is required"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: The code does not exist. Use a code returned by [List referral codes](/reference/admin-referrals/#list-referral-codes).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "The code does not exist.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "code not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "Once the code is gone, a repeat answers `404`."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#delete-a-referral-code"
        }
      }
    },
    "/admin/users/{account_id}/referral-series": {
      "get": {
        "operationId": "admin-referrals.retrieve-account-referral-series",
        "summary": "Retrieve an account's referral series",
        "description": "Returns an account's referral downline and revenue over time, by level.\n\nThe admin view of the series an account reads for itself on its referral page.",
        "tags": [
          "Admin referrals"
        ],
        "parameters": [
          {
            "name": "account_id",
            "in": "path",
            "required": true,
            "description": "Account id.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "Bucket size.",
            "schema": {
              "type": "string",
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "granularity": {
                      "type": "string",
                      "enum": [
                        "hour",
                        "day",
                        "week",
                        "month"
                      ],
                      "description": "Bucket size applied."
                    },
                    "from": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Window start applied, Unix seconds."
                    },
                    "to": {
                      "anyOf": [
                        {
                          "type": "integer"
                        },
                        {
                          "type": "null"
                        }
                      ],
                      "description": "Window end applied, Unix seconds."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "bucket_start": {
                            "type": "integer",
                            "description": "Bucket start, Unix seconds."
                          },
                          "new_referred": {
                            "type": "integer",
                            "description": "New accounts at level 1."
                          },
                          "referral_revenue_usd": {
                            "type": "string",
                            "description": "Sum of `revenue_usd_by_level`, in micro-USD, as an integer string."
                          },
                          "users_by_level": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            },
                            "description": "Downline size per level: `level`, `users`."
                          },
                          "revenue_usd_by_level": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            },
                            "description": "Referral revenue per level: `level`, `usd` (micro-USD string)."
                          }
                        },
                        "required": [
                          "bucket_start",
                          "new_referred",
                          "referral_revenue_usd",
                          "users_by_level",
                          "revenue_usd_by_level"
                        ]
                      },
                      "description": "One entry per bucket."
                    }
                  },
                  "required": [
                    "granularity",
                    "buckets"
                  ]
                },
                "example": {
                  "granularity": "day",
                  "from": 1791763200,
                  "to": 1792368000,
                  "buckets": [
                    {
                      "bucket_start": 1791763200,
                      "new_referred": 2,
                      "referral_revenue_usd": "18400000",
                      "users_by_level": [
                        {
                          "level": 1,
                          "users": 9
                        },
                        {
                          "level": 2,
                          "users": 3
                        }
                      ],
                      "revenue_usd_by_level": [
                        {
                          "level": 1,
                          "usd": "15200000"
                        },
                        {
                          "level": 2,
                          "usd": "3200000"
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `granularity` is not `hour`, `day`, `week` or `month`. Send `granularity` as `hour`, `day`, `week` or `month`.\n\n`bad_request`: `from` is later than `to`. A bound that cannot be read as a date answers `invalid from` or `invalid to`. Send a `from` earlier than `to`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`granularity` is not `hour`, `day`, `week` or `month`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid granularity: <granularity>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`from` is later than `to`. A bound that cannot be read as a date answers `invalid from` or `invalid to`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "from is after to"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "`not_found`: No account has this `account_id`. Take the `account_id` from [List users](/reference/admin-users/#list-users).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "not_found": {
                    "summary": "No account has this `account_id`.",
                    "value": {
                      "ok": false,
                      "code": "not_found",
                      "message": "account not found"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#retrieve-account-referral-series"
        }
      }
    },
    "/admin/referral/overview": {
      "get": {
        "operationId": "admin-referrals.retrieve-referral-overview",
        "summary": "Retrieve the referral overview",
        "description": "Returns every account's referrer link and daily launch and referral activity.\n\nThe raw rows the admin referral overview builds its trees and totals from.",
        "tags": [
          "Admin referrals"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts activity to one chain.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of `gross` and `referral`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied."
                    },
                    "users": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "license_key": {
                            "type": "string",
                            "description": "License key."
                          },
                          "username": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Username."
                          },
                          "referrer_key": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Referrer's license key."
                          },
                          "is_internal": {
                            "type": "boolean",
                            "description": "Internal account."
                          },
                          "created_at": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Creation time, Unix seconds."
                          }
                        },
                        "required": [
                          "license_key",
                          "is_internal"
                        ]
                      },
                      "description": "Accounts."
                    },
                    "activity": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "license_key": {
                            "type": "string",
                            "description": "License key."
                          },
                          "chain_id": {
                            "type": "string",
                            "description": "Chain id."
                          },
                          "bucket": {
                            "type": "integer",
                            "description": "Day start in UTC+1, Unix seconds."
                          },
                          "launches": {
                            "type": "integer",
                            "description": "Launches that day."
                          },
                          "gross": {
                            "type": "string",
                            "description": "Fees paid, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          },
                          "referral": {
                            "type": "string",
                            "description": "Referral generated, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          }
                        },
                        "required": [
                          "license_key",
                          "chain_id",
                          "bucket",
                          "launches",
                          "gross",
                          "referral"
                        ]
                      },
                      "description": "Activity per account, chain and day."
                    }
                  },
                  "required": [
                    "currency",
                    "users",
                    "activity"
                  ]
                },
                "example": {
                  "currency": "usd",
                  "users": [
                    {
                      "license_key": "AFFILIATE01-Qm4Tz8Lp2Xc7Vb9Nw",
                      "username": "affiliate01",
                      "referrer_key": null,
                      "is_internal": false,
                      "created_at": 1748196000
                    },
                    {
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "username": "demouser",
                      "referrer_key": "AFFILIATE01-Qm4Tz8Lp2Xc7Vb9Nw",
                      "is_internal": false,
                      "created_at": 1752000000
                    }
                  ],
                  "activity": [
                    {
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "chain_id": "sol",
                      "bucket": 1792018800,
                      "launches": 3,
                      "gross": "1236000000",
                      "referral": "185400000"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-referrals/#retrieve-referral-overview"
        }
      }
    },
    "/admin/dashboard": {
      "get": {
        "operationId": "admin-analytics.retrieve-event-dashboard",
        "summary": "Retrieve the event dashboard",
        "description": "Returns platform event totals, grouped by the dimensions you choose.\n\nBacks the admin metrics page. Events include `trade.buy`, `trade.sell`, `funding`, `cex_funding`, `withdraw`, `creator_fee`, `cashback`, `referral_payout`, `gross_revenue`, `fee_sweep`, `launch.create` and `launch.deploy`.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "since",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "until",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "event_type",
            "in": "query",
            "required": false,
            "description": "Restricts to one event type, such as `trade.buy`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "source",
            "in": "query",
            "required": false,
            "description": "Restricts to one event source.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "group_by",
            "in": "query",
            "required": false,
            "description": "Comma-separated dimensions: `day`, `chain`, `event_type`, `source`, `platform`, `quote_mint`.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "from": {
                      "type": "integer",
                      "description": "Window start applied, Unix seconds."
                    },
                    "to": {
                      "type": "integer",
                      "description": "Window end applied, Unix seconds."
                    },
                    "group_by": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Dimensions applied."
                    },
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "day": {
                            "type": "string",
                            "description": "Day, when grouped by `day`."
                          },
                          "chain_id": {
                            "type": "string",
                            "description": "Chain, when grouped by `chain`."
                          },
                          "event_type": {
                            "type": "string",
                            "description": "Event type, when grouped by `event_type`."
                          },
                          "source": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Source, when grouped by `source`."
                          },
                          "platform": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Launchpad, when grouped by `platform`."
                          },
                          "quote_mint": {
                            "anyOf": [
                              {
                                "type": "string"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Quote token, when grouped by `quote_mint`."
                          },
                          "amount_native": {
                            "type": "string",
                            "description": "Native amount, in lamports or wei, as an integer string."
                          },
                          "amount_quote": {
                            "type": "string",
                            "description": "Quote token amount, as an integer string."
                          },
                          "amount_usd": {
                            "type": "string",
                            "description": "USD amount, in micro-USD, as an integer string."
                          },
                          "amount_token": {
                            "type": "string",
                            "description": "Token amount, as an integer string."
                          },
                          "fee_native": {
                            "type": "string",
                            "description": "Fees, in lamports or wei, as an integer string."
                          },
                          "fee_usd": {
                            "type": "string",
                            "description": "Fees, in micro-USD, as an integer string."
                          },
                          "event_count": {
                            "type": "integer",
                            "description": "Number of events."
                          },
                          "count_sum": {
                            "type": "integer",
                            "description": "Sum of the events' counts."
                          }
                        }
                      },
                      "description": "One row per group. Only the grouped dimensions are present."
                    }
                  },
                  "required": [
                    "from",
                    "to",
                    "group_by",
                    "rows"
                  ]
                },
                "example": {
                  "from": 1792281600,
                  "to": 1792368000,
                  "group_by": [
                    "day",
                    "event_type"
                  ],
                  "rows": [
                    {
                      "day": "2026-10-16",
                      "event_type": "trade.buy",
                      "amount_native": "812400000000",
                      "amount_usd": "151520000000",
                      "fee_native": "0",
                      "fee_usd": "0",
                      "event_count": 4180,
                      "count_sum": 4180
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: A `group_by` dimension is unknown. Group by `day`, `chain`, `event_type`, `source`, `platform` or `quote_mint`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "A `group_by` dimension is unknown.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid group_by dimension: <dimension>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-event-dashboard"
        }
      }
    },
    "/admin/dashboard/summary": {
      "get": {
        "operationId": "admin-analytics.retrieve-dashboard-summary",
        "summary": "Retrieve the dashboard summary",
        "description": "Returns headline revenue, P&L, volume, launch and user totals.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "revenue_gross": {
                      "type": "string",
                      "description": "Fees paid to Proxima, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "revenue_net": {
                      "type": "string",
                      "description": "Fees after referral, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "referral_paid": {
                      "type": "string",
                      "description": "Referral paid, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "users_pnl": {
                      "type": "string",
                      "description": "Users' combined launch P&L, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "total_profit": {
                      "type": "string",
                      "description": "Sum of positive P&L, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "total_loss": {
                      "type": "string",
                      "description": "Sum of negative P&L, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "total_sold": {
                      "type": "string",
                      "description": "Volume sold, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "total_bought": {
                      "type": "string",
                      "description": "Volume bought, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                    },
                    "total_launches": {
                      "type": "integer",
                      "description": "Launches in the window."
                    },
                    "active_users": {
                      "type": "integer",
                      "description": "Users with a launch in the window."
                    },
                    "total_users": {
                      "type": "integer",
                      "description": "All users."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when native amounts span several chains."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "revenue_gross",
                    "revenue_net",
                    "referral_paid",
                    "users_pnl",
                    "total_profit",
                    "total_loss",
                    "total_sold",
                    "total_bought",
                    "total_launches",
                    "active_users",
                    "total_users",
                    "currency",
                    "native_mixed",
                    "units"
                  ]
                },
                "example": {
                  "revenue_gross": "86400000000",
                  "revenue_net": "73440000000",
                  "referral_paid": "12960000000",
                  "users_pnl": "102300000000",
                  "total_profit": "148900000000",
                  "total_loss": "-46600000000",
                  "total_sold": "1912000000000",
                  "total_bought": "1809700000000",
                  "total_launches": 1284,
                  "active_users": 211,
                  "total_users": 1630,
                  "currency": "usd",
                  "native_mixed": false,
                  "units": {
                    "usd": "micro_usd",
                    "native": "lamports",
                    "time": "unix_seconds"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-dashboard-summary"
        }
      }
    },
    "/admin/dashboard/series": {
      "get": {
        "operationId": "admin-analytics.retrieve-dashboard-series",
        "summary": "Retrieve the dashboard series",
        "description": "Returns launches, users, P&L and revenue per time bucket, split by launchpad.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "Bucket size. The API refuses `hour`.",
            "schema": {
              "type": "string",
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "default": "day"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "bucket_start": {
                            "type": "integer",
                            "description": "Bucket start, Unix seconds."
                          },
                          "by_platform": {
                            "type": "object",
                            "description": "Stats per launchpad id: `launch_count`, `active_users`, `pnl`, `revenue_gross`, `revenue_net`."
                          },
                          "totals": {
                            "type": "object",
                            "description": "Same stats across launchpads."
                          },
                          "new_users": {
                            "type": "integer",
                            "description": "Accounts created in the bucket."
                          },
                          "total_users": {
                            "type": "integer",
                            "description": "Accounts at the end of the bucket."
                          }
                        },
                        "required": [
                          "bucket_start",
                          "by_platform",
                          "totals",
                          "new_users",
                          "total_users"
                        ]
                      },
                      "description": "One entry per bucket."
                    },
                    "granularity": {
                      "type": "string",
                      "enum": [
                        "hour",
                        "day",
                        "week",
                        "month"
                      ],
                      "description": "Bucket size applied."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when native amounts span several chains."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "buckets",
                    "granularity",
                    "currency",
                    "native_mixed",
                    "units"
                  ]
                },
                "example": {
                  "buckets": [
                    {
                      "bucket_start": 1792281600,
                      "by_platform": {
                        "pumpfun": {
                          "launch_count": 31,
                          "active_users": 12,
                          "pnl": "9100000000",
                          "revenue_gross": "6200000000",
                          "revenue_net": "5270000000"
                        }
                      },
                      "totals": {
                        "launch_count": 31,
                        "active_users": 12,
                        "pnl": "9100000000",
                        "revenue_gross": "6200000000",
                        "revenue_net": "5270000000"
                      },
                      "new_users": 4,
                      "total_users": 1630
                    }
                  ],
                  "granularity": "day",
                  "currency": "usd",
                  "native_mixed": false,
                  "units": {
                    "usd": "micro_usd",
                    "native": "lamports",
                    "time": "unix_seconds"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `granularity` is not `day`, `week` or `month`. The API refuses `hour`, which the dashboard sends from its *By Hour* view. Send `granularity` as `day`, `week` or `month`.\n\n`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`granularity` is not `day`, `week` or `month`. The API refuses `hour`, which the dashboard sends from its *By Hour* view.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid granularity: <granularity>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-dashboard-series"
        }
      }
    },
    "/admin/dashboard/users": {
      "get": {
        "operationId": "admin-analytics.list-dashboard-users",
        "summary": "List dashboard users",
        "description": "Returns each account's launches, revenue and P&L over the window.\n\nNot called by the current web app.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The API defaults to 500 and caps at 2000.",
            "schema": {
              "type": "integer",
              "default": "500"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of rows to skip.",
            "schema": {
              "type": "integer",
              "default": "0"
            }
          },
          {
            "name": "include_inactive",
            "in": "query",
            "required": false,
            "description": "Includes accounts with no launch in the window.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "users": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Accounts. See [Dashboard user](#object-dashboard-user)."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Applied page size."
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Applied offset."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when native amounts span several chains."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "users",
                    "limit",
                    "offset",
                    "currency",
                    "native_mixed",
                    "units"
                  ]
                },
                "example": {
                  "users": [
                    {
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "username": "demouser",
                      "launch_count": 42,
                      "revenue_gross": "20600000000",
                      "revenue_net": "17510000000",
                      "pnl": "18250000000"
                    }
                  ],
                  "limit": 500,
                  "offset": 0,
                  "currency": "usd",
                  "native_mixed": false,
                  "units": {
                    "usd": "micro_usd",
                    "native": "lamports",
                    "time": "unix_seconds"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#list-dashboard-users"
        }
      }
    },
    "/admin/dashboard/users-over-time": {
      "get": {
        "operationId": "admin-analytics.retrieve-users-over-time",
        "summary": "Retrieve top users over time",
        "description": "Returns revenue and launches per bucket for the top accounts, with the rest grouped.\n\nThe top accounts are ranked over the whole window, so the same accounts appear in every bucket. The rest are summed under `others_key`.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "Bucket size. The API refuses `hour`.",
            "schema": {
              "type": "string",
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "default": "day"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "rank_by",
            "in": "query",
            "required": false,
            "description": "Ranking.",
            "schema": {
              "type": "string",
              "enum": [
                "revenue",
                "launches"
              ],
              "default": "revenue"
            }
          },
          {
            "name": "top_n",
            "in": "query",
            "required": false,
            "description": "Number of top accounts, 1 to 100.",
            "schema": {
              "type": "integer",
              "default": "10"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "top_users": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Top accounts: `license_key`, `username`."
                    },
                    "others_key": {
                      "type": "string",
                      "description": "Series key of the grouped remainder. Never a license key."
                    },
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "bucket_start": {
                            "type": "integer",
                            "description": "Bucket start, Unix seconds."
                          },
                          "series": {
                            "type": "object",
                            "description": "Per license key (and `others_key`): `revenue_gross`, `revenue_net`, `launches`."
                          }
                        },
                        "required": [
                          "bucket_start",
                          "series"
                        ]
                      },
                      "description": "One entry per bucket."
                    },
                    "granularity": {
                      "type": "string",
                      "enum": [
                        "hour",
                        "day",
                        "week",
                        "month"
                      ],
                      "description": "Bucket size applied."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "top_users",
                    "others_key",
                    "buckets",
                    "granularity",
                    "currency",
                    "units"
                  ]
                },
                "example": {
                  "top_users": [
                    {
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "username": "demouser"
                    }
                  ],
                  "others_key": "__others__",
                  "buckets": [
                    {
                      "bucket_start": 1792281600,
                      "series": {
                        "DEMOUSER-k3Jd8QwZp2LmX7vRt": {
                          "revenue_gross": "412000000",
                          "revenue_net": "350200000",
                          "launches": 3
                        },
                        "__others__": {
                          "revenue_gross": "2860000000",
                          "revenue_net": "2431000000",
                          "launches": 41
                        }
                      }
                    }
                  ],
                  "granularity": "day",
                  "currency": "usd",
                  "units": {
                    "usd": "micro_usd",
                    "native": "lamports",
                    "time": "unix_seconds"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `granularity` is not `day`, `week` or `month`. The API refuses `hour`, which the dashboard sends from its *By Hour* view. Send `granularity` as `day`, `week` or `month`.\n\n`bad_request`: `rank_by` is not `revenue` or `launches`. Send `rank_by=revenue` or `rank_by=launches`.\n\n`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`granularity` is not `day`, `week` or `month`. The API refuses `hour`, which the dashboard sends from its *By Hour* view.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid granularity: <granularity>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`rank_by` is not `revenue` or `launches`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid rank_by: <rank_by>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-users-over-time"
        }
      }
    },
    "/admin/dashboard/heatmap": {
      "get": {
        "operationId": "admin-analytics.retrieve-activity-heatmap",
        "summary": "Retrieve the activity heatmap",
        "description": "Returns launches, revenue and P&L per weekday and hour.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "cells": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "weekday": {
                            "type": "integer",
                            "description": "Day of the week, 0 (Monday) to 6 (Sunday)."
                          },
                          "hour": {
                            "type": "integer",
                            "description": "Hour, 0 to 23."
                          },
                          "launch_count": {
                            "type": "integer",
                            "description": "Launches."
                          },
                          "revenue_gross": {
                            "type": "string",
                            "description": "Fees paid, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          },
                          "pnl": {
                            "type": "string",
                            "description": "Launch P&L, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          }
                        },
                        "required": [
                          "weekday",
                          "hour",
                          "launch_count",
                          "revenue_gross",
                          "pnl"
                        ]
                      },
                      "description": "One cell per weekday and hour."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when native amounts span several chains."
                    },
                    "units": {
                      "type": "object",
                      "properties": {
                        "usd": {
                          "type": "string",
                          "description": "Unit of the USD amounts."
                        },
                        "native": {
                          "type": "string",
                          "description": "Unit of the native amounts."
                        },
                        "time": {
                          "type": "string",
                          "description": "Unit of the timestamps."
                        }
                      },
                      "required": [
                        "usd",
                        "native",
                        "time"
                      ],
                      "description": "Unit labels for the amounts in the response."
                    }
                  },
                  "required": [
                    "cells",
                    "currency",
                    "native_mixed",
                    "units"
                  ]
                },
                "example": {
                  "cells": [
                    {
                      "weekday": 2,
                      "hour": 15,
                      "launch_count": 18,
                      "revenue_gross": "1880000000",
                      "pnl": "2410000000"
                    }
                  ],
                  "currency": "usd",
                  "native_mixed": false,
                  "units": {
                    "usd": "micro_usd",
                    "native": "lamports",
                    "time": "unix_seconds"
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-activity-heatmap"
        }
      }
    },
    "/admin/dashboard/activity-distribution": {
      "get": {
        "operationId": "admin-analytics.retrieve-activity-distribution",
        "summary": "Retrieve the activity distribution",
        "description": "Returns how many users made each number of launches, with their revenue.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "rows": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "launch_count": {
                            "type": "integer",
                            "description": "Launches per user."
                          },
                          "user_count": {
                            "type": "integer",
                            "description": "Users with that many launches."
                          },
                          "revenue_gross": {
                            "type": "string",
                            "description": "Fees paid, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          },
                          "revenue_net": {
                            "type": "string",
                            "description": "Fees after referral, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          }
                        },
                        "required": [
                          "launch_count",
                          "user_count",
                          "revenue_gross",
                          "revenue_net"
                        ]
                      },
                      "description": "One row per distinct launch count, `0` included."
                    },
                    "total_users": {
                      "type": "integer",
                      "description": "Users counted."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when native amounts span several chains."
                    }
                  },
                  "required": [
                    "rows",
                    "total_users",
                    "currency",
                    "native_mixed"
                  ]
                },
                "example": {
                  "rows": [
                    {
                      "launch_count": 0,
                      "user_count": 1419,
                      "revenue_gross": "0",
                      "revenue_net": "0"
                    },
                    {
                      "launch_count": 1,
                      "user_count": 64,
                      "revenue_gross": "1920000000",
                      "revenue_net": "1632000000"
                    }
                  ],
                  "total_users": 1630,
                  "currency": "usd",
                  "native_mixed": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-activity-distribution"
        }
      }
    },
    "/admin/dashboard/top-users": {
      "get": {
        "operationId": "admin-analytics.retrieve-top-users",
        "summary": "Retrieve top users",
        "description": "Returns the top accounts by a metric, with everyone else summed.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "rank_by",
            "in": "query",
            "required": false,
            "description": "Ranking metric.",
            "schema": {
              "type": "string",
              "enum": [
                "launches",
                "revenue_gross",
                "revenue_net",
                "pnl"
              ]
            }
          },
          {
            "name": "top_n",
            "in": "query",
            "required": false,
            "description": "Number of top accounts.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "top": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Top accounts. See [Dashboard user](#object-dashboard-user)."
                    },
                    "others": {
                      "type": "object",
                      "properties": {
                        "user_count": {
                          "type": "integer",
                          "description": "Users."
                        },
                        "launch_count": {
                          "type": "integer",
                          "description": "Launches."
                        },
                        "revenue_gross": {
                          "type": "string",
                          "description": "Fees paid, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                        },
                        "revenue_net": {
                          "type": "string",
                          "description": "Fees after referral, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                        },
                        "pnl": {
                          "type": "string",
                          "description": "Launch P&L, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                        },
                        "pnl_abs": {
                          "type": "string",
                          "description": "Sum of absolute P&L, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                        }
                      },
                      "required": [
                        "user_count",
                        "launch_count",
                        "revenue_gross",
                        "revenue_net",
                        "pnl",
                        "pnl_abs"
                      ],
                      "description": "Everyone else, summed."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    },
                    "native_mixed": {
                      "type": "boolean",
                      "description": "`true` when native amounts span several chains."
                    }
                  },
                  "required": [
                    "top",
                    "others",
                    "currency",
                    "native_mixed"
                  ]
                },
                "example": {
                  "top": [
                    {
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "username": "demouser",
                      "launch_count": 42,
                      "revenue_gross": "20600000000",
                      "revenue_net": "17510000000",
                      "pnl": "18250000000"
                    }
                  ],
                  "others": {
                    "user_count": 210,
                    "launch_count": 1242,
                    "revenue_gross": "65800000000",
                    "revenue_net": "55930000000",
                    "pnl": "84050000000",
                    "pnl_abs": "131200000000"
                  },
                  "currency": "usd",
                  "native_mixed": false
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `rank_by` is not a ranking metric. The API also accepts `revenue`. Send `rank_by` as `launches`, `revenue_gross`, `revenue_net` or `pnl`.\n\n`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`rank_by` is not a ranking metric. The API also accepts `revenue`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid rank_by: <rank_by>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-top-users"
        }
      }
    },
    "/admin/dashboard/launch-stats": {
      "get": {
        "operationId": "admin-analytics.retrieve-launch-stats",
        "summary": "Retrieve launch stats",
        "description": "Returns launch counts and per-launch metrics per period, optionally split by chain or launchpad.\n\nMetrics are `[sum, samples]` pairs: divide for the per-launch average, keep the sum for the total.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "start_at",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive. Filters on launch time.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "end_at",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "granularity",
            "in": "query",
            "required": false,
            "description": "Bucket size. The API refuses `hour`.",
            "schema": {
              "type": "string",
              "enum": [
                "hour",
                "day",
                "week",
                "month"
              ],
              "default": "day"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "split_by",
            "in": "query",
            "required": false,
            "description": "Split dimension.",
            "schema": {
              "type": "string",
              "enum": [
                "none",
                "chain",
                "launchpad"
              ]
            }
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "description": "Restricts to one launchpad.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "granularity": {
                      "type": "string",
                      "enum": [
                        "hour",
                        "day",
                        "week",
                        "month"
                      ],
                      "description": "Bucket size applied."
                    },
                    "split_by": {
                      "type": "string",
                      "enum": [
                        "none",
                        "chain",
                        "launchpad"
                      ],
                      "description": "Split applied."
                    },
                    "keys": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "description": "Split keys, most launches first. `all` when unsplit."
                    },
                    "periods": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "One entry per period: `period` (Unix seconds) and `cells` keyed by split key, or `null` when empty."
                    },
                    "totals": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "properties": {
                          "launches": {
                            "type": "integer",
                            "description": "Launches."
                          },
                          "counts": {
                            "type": "object",
                            "description": "Counts by tag, such as `method:mev`, `origin:imported`, `schedule:scheduled`, `mev_type:atomic`, `funding_type:cex`."
                          },
                          "metrics": {
                            "type": "object",
                            "description": "Keyed by launch method (`all` included), then metric name, to a `[sum, samples]` pair."
                          }
                        },
                        "required": [
                          "launches",
                          "counts",
                          "metrics"
                        ],
                        "description": "Totals for one split key from `keys`."
                      },
                      "x-proxima-key": "split_key",
                      "description": "Cells over the whole window, keyed by split key."
                    }
                  },
                  "required": [
                    "granularity",
                    "split_by",
                    "keys",
                    "periods",
                    "totals"
                  ]
                },
                "example": {
                  "granularity": "day",
                  "split_by": "none",
                  "keys": [
                    "all"
                  ],
                  "periods": [
                    {
                      "period": 1792281600,
                      "cells": {
                        "all": {
                          "launches": 44,
                          "counts": {
                            "method:mev": 30,
                            "origin:imported": 2
                          },
                          "metrics": {
                            "all": {
                              "active_holders": [
                                5280,
                                44
                              ]
                            }
                          }
                        }
                      }
                    }
                  ],
                  "totals": {
                    "all": {
                      "launches": 44,
                      "counts": {
                        "method:mev": 30,
                        "origin:imported": 2
                      },
                      "metrics": {
                        "all": {
                          "active_holders": [
                            5280,
                            44
                          ]
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `granularity` is not `day`, `week` or `month`. The API refuses `hour`. Send `granularity` as `day`, `week` or `month`.\n\n`bad_request`: `split_by` is not `none`, `chain` or `launchpad`. Send `split_by` as `none`, `chain` or `launchpad`.\n\n`bad_request`: The window spans 1500 buckets or more at this granularity. Shorten the window or use a coarser `granularity`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`granularity` is not `day`, `week` or `month`. The API refuses `hour`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid granularity: <granularity>"
                    }
                  },
                  "bad_request_2": {
                    "summary": "`split_by` is not `none`, `chain` or `launchpad`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid split_by: <split_by>"
                    }
                  },
                  "bad_request_3": {
                    "summary": "The window spans 1500 buckets or more at this granularity.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "range too long for this granularity"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-launch-stats"
        }
      }
    },
    "/admin/dashboard/tracker": {
      "get": {
        "operationId": "admin-analytics.retrieve-tracker-stats",
        "summary": "Retrieve wallet tracker stats",
        "description": "Returns wallet tracker adoption, for all users and for active users.\n\n`all` counts every non-internal user; `active` only those who launched at least once.",
        "tags": [
          "Analytics"
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "all": {
                      "type": "object",
                      "properties": {
                        "users": {
                          "type": "integer",
                          "description": "Users in the population."
                        },
                        "users_tracking": {
                          "type": "integer",
                          "description": "Users tracking at least one wallet."
                        },
                        "users_tracking_svm": {
                          "type": "integer",
                          "description": "Users tracking a Solana wallet."
                        },
                        "users_tracking_evm": {
                          "type": "integer",
                          "description": "Users tracking an EVM wallet."
                        },
                        "tracked_wallets": {
                          "type": "integer",
                          "description": "Tracked wallets."
                        },
                        "tracked_svm": {
                          "type": "integer",
                          "description": "Tracked Solana wallets."
                        },
                        "tracked_evm": {
                          "type": "integer",
                          "description": "Tracked EVM wallets."
                        },
                        "bookmarked": {
                          "type": "integer",
                          "description": "Bookmarked wallets."
                        },
                        "max_per_user": {
                          "type": "integer",
                          "description": "Most wallets tracked by one user."
                        },
                        "distribution": {
                          "type": "object",
                          "description": "Users per tracked-wallet count bucket (`0`, `1`, `2-5`, …)."
                        }
                      },
                      "required": [
                        "users",
                        "users_tracking",
                        "users_tracking_svm",
                        "users_tracking_evm",
                        "tracked_wallets",
                        "tracked_svm",
                        "tracked_evm",
                        "bookmarked",
                        "max_per_user",
                        "distribution"
                      ],
                      "description": "Every non-internal user."
                    },
                    "active": {
                      "type": "object",
                      "properties": {
                        "users": {
                          "type": "integer",
                          "description": "Users in the population."
                        },
                        "users_tracking": {
                          "type": "integer",
                          "description": "Users tracking at least one wallet."
                        },
                        "users_tracking_svm": {
                          "type": "integer",
                          "description": "Users tracking a Solana wallet."
                        },
                        "users_tracking_evm": {
                          "type": "integer",
                          "description": "Users tracking an EVM wallet."
                        },
                        "tracked_wallets": {
                          "type": "integer",
                          "description": "Tracked wallets."
                        },
                        "tracked_svm": {
                          "type": "integer",
                          "description": "Tracked Solana wallets."
                        },
                        "tracked_evm": {
                          "type": "integer",
                          "description": "Tracked EVM wallets."
                        },
                        "bookmarked": {
                          "type": "integer",
                          "description": "Bookmarked wallets."
                        },
                        "max_per_user": {
                          "type": "integer",
                          "description": "Most wallets tracked by one user."
                        },
                        "distribution": {
                          "type": "object",
                          "description": "Users per tracked-wallet count bucket (`0`, `1`, `2-5`, …)."
                        }
                      },
                      "required": [
                        "users",
                        "users_tracking",
                        "users_tracking_svm",
                        "users_tracking_evm",
                        "tracked_wallets",
                        "tracked_svm",
                        "tracked_evm",
                        "bookmarked",
                        "max_per_user",
                        "distribution"
                      ],
                      "description": "Users with at least one launch."
                    }
                  },
                  "required": [
                    "all",
                    "active"
                  ]
                },
                "example": {
                  "all": {
                    "users": 1630,
                    "users_tracking": 402,
                    "users_tracking_svm": 377,
                    "users_tracking_evm": 88,
                    "tracked_wallets": 5120,
                    "tracked_svm": 4610,
                    "tracked_evm": 510,
                    "bookmarked": 930,
                    "max_per_user": 250,
                    "distribution": {
                      "0": 1228,
                      "1": 96,
                      "2-5": 171
                    }
                  },
                  "active": {
                    "users": 211,
                    "users_tracking": 140,
                    "users_tracking_svm": 131,
                    "users_tracking_evm": 40,
                    "tracked_wallets": 2980,
                    "tracked_svm": 2700,
                    "tracked_evm": 280,
                    "bookmarked": 512,
                    "max_per_user": 250,
                    "distribution": {
                      "0": 71,
                      "1": 22,
                      "2-5": 60
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-tracker-stats"
        }
      }
    },
    "/admin/dashboard/wallets": {
      "get": {
        "operationId": "admin-analytics.retrieve-wallet-stats",
        "summary": "Retrieve wallet stats",
        "description": "Returns wallet, funding and folder counts, for all users and for active users.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "min_launches",
            "in": "query",
            "required": false,
            "description": "Launch threshold for the `*_min_launches` counts.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "all": {
                      "type": "object",
                      "properties": {
                        "users": {
                          "type": "integer",
                          "description": "Users in the population."
                        },
                        "scopes": {
                          "type": "object",
                          "description": "`sol` and `evm` cover every wallet; an EVM chain id holds the wallets funded or used there. Each scope has `users_with_wallets`, `wallets`, `marketplace`, `used_wallets`, `users_min_launches`, `wallets_min_launches`, `folder_links`, `funding` (by exchange slug, `wallet` or `unfunded`) and `launch_buckets`."
                        },
                        "folders": {
                          "type": "object",
                          "description": "Per scope: `users_with_folders`, `folders`, `archived`."
                        }
                      },
                      "required": [
                        "users",
                        "scopes",
                        "folders"
                      ],
                      "description": "Every non-internal user."
                    },
                    "active": {
                      "type": "object",
                      "properties": {
                        "users": {
                          "type": "integer",
                          "description": "Users in the population."
                        },
                        "scopes": {
                          "type": "object",
                          "description": "`sol` and `evm` cover every wallet; an EVM chain id holds the wallets funded or used there. Each scope has `users_with_wallets`, `wallets`, `marketplace`, `used_wallets`, `users_min_launches`, `wallets_min_launches`, `folder_links`, `funding` (by exchange slug, `wallet` or `unfunded`) and `launch_buckets`."
                        },
                        "folders": {
                          "type": "object",
                          "description": "Per scope: `users_with_folders`, `folders`, `archived`."
                        }
                      },
                      "required": [
                        "users",
                        "scopes",
                        "folders"
                      ],
                      "description": "Users with at least one launch."
                    },
                    "min_launches": {
                      "type": "integer",
                      "description": "Threshold applied."
                    }
                  },
                  "required": [
                    "all",
                    "active",
                    "min_launches"
                  ]
                },
                "example": {
                  "all": {
                    "users": 1630,
                    "scopes": {
                      "sol": {
                        "users_with_wallets": 980,
                        "wallets": 48200,
                        "marketplace": 3100,
                        "used_wallets": 31400,
                        "users_min_launches": 140,
                        "wallets_min_launches": 22800,
                        "folder_links": 9100,
                        "funding": {
                          "wallet": 27000,
                          "unfunded": 16900,
                          "binance": 4300
                        },
                        "launch_buckets": {
                          "0": 16800,
                          "1": 9200,
                          "2-5": 14100
                        }
                      }
                    },
                    "folders": {
                      "sol": {
                        "users_with_folders": 410,
                        "folders": 2240,
                        "archived": 380
                      }
                    }
                  },
                  "active": {
                    "users": 211,
                    "scopes": {
                      "sol": {
                        "users_with_wallets": 205,
                        "wallets": 30100,
                        "marketplace": 2400,
                        "used_wallets": 26900,
                        "users_min_launches": 140,
                        "wallets_min_launches": 22800,
                        "folder_links": 7600,
                        "funding": {
                          "wallet": 19800,
                          "unfunded": 7400,
                          "binance": 2900
                        },
                        "launch_buckets": {
                          "0": 3200,
                          "1": 7400,
                          "2-5": 12500
                        }
                      }
                    },
                    "folders": {
                      "sol": {
                        "users_with_folders": 180,
                        "folders": 1310,
                        "archived": 240
                      }
                    }
                  },
                  "min_launches": 5
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-wallet-stats"
        }
      }
    },
    "/admin/sharing/stats": {
      "get": {
        "operationId": "admin-analytics.retrieve-sharing-stats",
        "summary": "Retrieve sharing stats",
        "description": "Returns launch-sharing grants, invites, delegated actions and top sharers.\n\n`active_*` counts are the state right now; the other counts are inside the window.",
        "tags": [
          "Analytics"
        ],
        "parameters": [
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Window start, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Window end, Unix seconds, inclusive.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "window": {
                      "type": "object",
                      "description": "Window applied: `from`, `to` (nullable), `series_from`, `series_to`."
                    },
                    "summary": {
                      "type": "object",
                      "description": "`active_grants`, `active_shared_launches`, `active_sharers`, `active_members`, `active_reshares`, `grants_created`, `grants_revoked`, `launches_shared`, `sharers`, `members`, `live_launches`."
                    },
                    "invites": {
                      "type": "object",
                      "description": "Per invite kind (`link`, `direct`, `request`): `pending`, `accepted`, `declined`, `revoked`, `total`."
                    },
                    "actions": {
                      "type": "object",
                      "description": "Delegated calls: `total`, `accepted`, `refused`, `unsettled`, `actors`."
                    },
                    "top_sharers": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Licenses sharing the most: `license_key`, `profile`, `launches`, `grants`, `members`, `active_grants`, `last_at`."
                    },
                    "top_members": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Licenses receiving the most: `license_key`, `profile`, `launches`, `owners`, `active_grants`, `actions`, `last_at`."
                    },
                    "recurring_pairs": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Owner and member pairs that share repeatedly: `owner`, `member`, `launches`, `last_at`."
                    },
                    "recurring_teams": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Owners sharing with the same members repeatedly: `owner`, `members`, `launches`, `last_at`."
                    },
                    "permissions": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Per operation: `operation`, `high_risk`, `granted` (in the window), `active` (live), `calls`, `accepted`, `refused`."
                    },
                    "series": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Per bucket: `bucket_start`, `grants`, `revokes`, `actions`."
                    }
                  },
                  "required": [
                    "window",
                    "summary",
                    "invites",
                    "actions",
                    "top_sharers",
                    "top_members",
                    "recurring_pairs",
                    "recurring_teams",
                    "permissions",
                    "series"
                  ]
                },
                "example": {
                  "window": {
                    "from": 1791763200,
                    "to": 1792368000,
                    "series_from": 1791763200,
                    "series_to": 1792368000
                  },
                  "summary": {
                    "active_grants": 84,
                    "active_shared_launches": 51,
                    "active_sharers": 33,
                    "active_members": 47,
                    "active_reshares": 6,
                    "grants_created": 19,
                    "grants_revoked": 4,
                    "launches_shared": 15,
                    "sharers": 11,
                    "members": 16,
                    "live_launches": 9
                  },
                  "invites": {
                    "link": {
                      "pending": 3,
                      "accepted": 12,
                      "declined": 1,
                      "revoked": 2,
                      "total": 18
                    }
                  },
                  "actions": {
                    "total": 640,
                    "accepted": 611,
                    "refused": 29,
                    "unsettled": 0,
                    "actors": 21
                  },
                  "top_sharers": [
                    {
                      "license_key": "DEMOUSER-k3Jd8QwZp2LmX7vRt",
                      "profile": {
                        "username": "demouser",
                        "display_name": "Demo User",
                        "avatar_url": null
                      },
                      "launches": 6,
                      "grants": 9,
                      "members": 4,
                      "active_grants": 7,
                      "last_at": 1792350000
                    }
                  ],
                  "top_members": [
                    {
                      "license_key": "SAMPLEDEV-Hy6Rk1Ws9Jd3Fq8Lp",
                      "profile": {
                        "username": "sampledev",
                        "display_name": null,
                        "avatar_url": null
                      },
                      "launches": 5,
                      "owners": 2,
                      "active_grants": 5,
                      "actions": 140,
                      "last_at": 1792351000
                    }
                  ],
                  "recurring_pairs": [],
                  "recurring_teams": [],
                  "permissions": [
                    {
                      "operation": "sell",
                      "high_risk": false,
                      "granted": 17,
                      "active": 80,
                      "calls": 402,
                      "accepted": 395,
                      "refused": 7
                    }
                  ],
                  "series": [
                    {
                      "bucket_start": 1792281600,
                      "grants": 3,
                      "revokes": 1,
                      "actions": 96
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `from` or `to` is too large to be read as a date. Send the window bounds in Unix seconds.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`from` or `to` is too large to be read as a date.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "<field> is not a unix-seconds timestamp: <value>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-analytics/#retrieve-sharing-stats"
        }
      }
    },
    "/admin/dashboard/time-to-launch": {
      "get": {
        "operationId": "admin-retention.retrieve-time-to-launch",
        "summary": "Retrieve time to launch",
        "description": "Returns how many users reached each launch-count milestone, by days since signup.",
        "tags": [
          "Retention"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "milestones",
            "in": "query",
            "required": false,
            "description": "Comma-separated launch counts, such as `1,5,10`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "max_days",
            "in": "query",
            "required": false,
            "description": "Days after signup to cover.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "max_days": {
                      "type": "integer",
                      "description": "Days covered."
                    },
                    "total_users": {
                      "type": "integer",
                      "description": "Users counted."
                    },
                    "active_users": {
                      "type": "integer",
                      "description": "Users with at least one launch."
                    },
                    "milestones": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "milestone": {
                            "type": "integer",
                            "description": "Launch count."
                          },
                          "reached": {
                            "type": "integer",
                            "description": "Users who ever reached it."
                          },
                          "cumulative": {
                            "type": "array",
                            "items": {
                              "type": "integer"
                            },
                            "description": "Index is days after signup; value is users who had reached it by then."
                          }
                        },
                        "required": [
                          "milestone",
                          "reached",
                          "cumulative"
                        ]
                      },
                      "description": "One entry per milestone."
                    }
                  },
                  "required": [
                    "max_days",
                    "total_users",
                    "active_users",
                    "milestones"
                  ]
                },
                "example": {
                  "max_days": 30,
                  "total_users": 1630,
                  "active_users": 211,
                  "milestones": [
                    {
                      "milestone": 1,
                      "reached": 211,
                      "cumulative": [
                        58,
                        97,
                        121,
                        140
                      ]
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `milestones` is not a comma-separated list of launch counts. More than 20 milestones answers `at most 20 milestones`. Send up to 20 comma-separated launch counts, such as `1,5,10`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`milestones` is not a comma-separated list of launch counts. More than 20 milestones answers `at most 20 milestones`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid milestones: <milestones>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-retention/#retrieve-time-to-launch"
        }
      }
    },
    "/admin/dashboard/churn": {
      "get": {
        "operationId": "admin-retention.retrieve-churn",
        "summary": "Retrieve churn",
        "description": "Returns users grouped by days since their last launch.",
        "tags": [
          "Retention"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "buckets": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": {
                            "type": "string",
                            "description": "Bucket label."
                          },
                          "min_days": {
                            "type": "integer",
                            "description": "Lower bound, in days."
                          },
                          "max_days": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Upper bound, in days. `null` for the last bucket."
                          },
                          "user_count": {
                            "type": "integer",
                            "description": "Users in the bucket."
                          }
                        },
                        "required": [
                          "label",
                          "min_days",
                          "user_count"
                        ]
                      },
                      "description": "Inactivity buckets."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    }
                  },
                  "required": [
                    "buckets",
                    "currency"
                  ]
                },
                "example": {
                  "buckets": [
                    {
                      "label": "1-7d",
                      "min_days": 1,
                      "max_days": 7,
                      "user_count": 48
                    },
                    {
                      "label": "90d+",
                      "min_days": 90,
                      "max_days": null,
                      "user_count": 61
                    }
                  ],
                  "currency": "usd"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-retention/#retrieve-churn"
        }
      }
    },
    "/admin/dashboard/churn/users": {
      "get": {
        "operationId": "admin-retention.list-churned-users",
        "summary": "List churned users",
        "description": "Returns the users in an inactivity range, with their last launch.",
        "tags": [
          "Retention"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "min_days",
            "in": "query",
            "required": true,
            "description": "Minimum days since the last launch.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "max_days",
            "in": "query",
            "required": false,
            "description": "Maximum days since the last launch.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of rows to skip.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "required": false,
            "description": "Sort key.",
            "schema": {
              "type": "string",
              "enum": [
                "username",
                "inactive",
                "launches",
                "revenue",
                "pnl"
              ]
            }
          },
          {
            "name": "order",
            "in": "query",
            "required": false,
            "description": "Sort direction. `desc` is biggest first.",
            "schema": {
              "type": "string",
              "enum": [
                "asc",
                "desc"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "users": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "license_key": {
                            "type": "string",
                            "description": "License key."
                          },
                          "username": {
                            "type": "string",
                            "description": "Username."
                          },
                          "days_since_last_launch": {
                            "type": "integer",
                            "description": "Days since the last launch."
                          },
                          "total_launches": {
                            "type": "integer",
                            "description": "Lifetime launches."
                          },
                          "total_revenue_gross": {
                            "type": "string",
                            "description": "Lifetime fees paid, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          },
                          "total_pnl": {
                            "type": "string",
                            "description": "Lifetime launch P&L, in the requested `currency` (micro-USD, or lamports or wei), as an integer string."
                          },
                          "last_launch": {
                            "type": "object",
                            "description": "Last launch: `name`, `symbol`, `image_url`, `launched_at` (Unix seconds), `revenue_gross`, `pnl`."
                          }
                        },
                        "required": [
                          "license_key",
                          "username",
                          "days_since_last_launch",
                          "total_launches",
                          "total_revenue_gross",
                          "total_pnl",
                          "last_launch"
                        ]
                      },
                      "description": "Users."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Total matching users."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Applied page size."
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Applied offset."
                    },
                    "currency": {
                      "type": "string",
                      "enum": [
                        "usd",
                        "native"
                      ],
                      "description": "Unit applied to the money amounts."
                    }
                  },
                  "required": [
                    "users",
                    "total",
                    "limit",
                    "offset",
                    "currency"
                  ]
                },
                "example": {
                  "users": [
                    {
                      "license_key": "SAMPLEDEV-Hy6Rk1Ws9Jd3Fq8Lp",
                      "username": "sampledev",
                      "days_since_last_launch": 12,
                      "total_launches": 9,
                      "total_revenue_gross": "1840000000",
                      "total_pnl": "-120000000",
                      "last_launch": {
                        "name": "Sample Token",
                        "symbol": "SMPL",
                        "image_url": null,
                        "launched_at": 1791380400,
                        "revenue_gross": "210000000",
                        "pnl": "45000000"
                      }
                    }
                  ],
                  "total": 48,
                  "limit": 50,
                  "offset": 0,
                  "currency": "usd"
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `currency` is not `usd` or `native`. Send `currency=usd` or `currency=native`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`currency` is not `usd` or `native`.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid currency: <currency>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-retention/#list-churned-users"
        }
      }
    },
    "/admin/dashboard/cohorts": {
      "get": {
        "operationId": "admin-retention.retrieve-cohorts",
        "summary": "Retrieve signup cohorts",
        "description": "Returns retention per monthly signup cohort.",
        "tags": [
          "Retention"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "hide_inactive",
            "in": "query",
            "required": false,
            "description": "Leaves out users who never launched.",
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "windows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Retention windows: `label`, `start_days`, `end_days` (days after signup)."
                    },
                    "cohorts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "cohort": {
                            "type": "string",
                            "description": "Signup month, `YYYY-MM` (UTC)."
                          },
                          "start_at": {
                            "type": "integer",
                            "description": "Month start, Unix seconds."
                          },
                          "user_count": {
                            "type": "integer",
                            "description": "Users in the cohort."
                          },
                          "retention": {
                            "type": "array",
                            "items": {
                              "type": "object"
                            },
                            "description": "Per window, in the order of `windows`: `eligible`, `active`."
                          }
                        },
                        "required": [
                          "cohort",
                          "start_at",
                          "user_count",
                          "retention"
                        ]
                      },
                      "description": "One entry per signup month."
                    }
                  },
                  "required": [
                    "windows",
                    "cohorts"
                  ]
                },
                "example": {
                  "windows": [
                    {
                      "label": "D1",
                      "start_days": 0,
                      "end_days": 1
                    },
                    {
                      "label": "D7",
                      "start_days": 1,
                      "end_days": 7
                    }
                  ],
                  "cohorts": [
                    {
                      "cohort": "2026-09",
                      "start_at": 1788220800,
                      "user_count": 132,
                      "retention": [
                        {
                          "eligible": 132,
                          "active": 41
                        },
                        {
                          "eligible": 132,
                          "active": 29
                        }
                      ]
                    }
                  ]
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-retention/#retrieve-cohorts"
        }
      }
    },
    "/admin/dashboard/cohorts/users": {
      "get": {
        "operationId": "admin-retention.list-cohort-users",
        "summary": "List a cohort's users",
        "description": "Returns the users of one signup cohort with their launches per window.",
        "tags": [
          "Retention"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "hide_inactive",
            "in": "query",
            "required": false,
            "description": "Leaves out users who never launched.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "cohort",
            "in": "query",
            "required": true,
            "description": "Signup month, `YYYY-MM`.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Page size. The web app asks for 2000.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "required": false,
            "description": "Number of rows to skip.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "windows": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Retention windows: `label`, `start_days`, `end_days` (days after signup)."
                    },
                    "users": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "license_key": {
                            "type": "string",
                            "description": "License key."
                          },
                          "username": {
                            "type": "string",
                            "description": "Username."
                          },
                          "created_at": {
                            "type": "integer",
                            "description": "Signup time, Unix seconds."
                          },
                          "total_launches": {
                            "type": "integer",
                            "description": "Lifetime launches."
                          },
                          "last_launch_at": {
                            "anyOf": [
                              {
                                "type": "integer"
                              },
                              {
                                "type": "null"
                              }
                            ],
                            "description": "Last launch time, Unix seconds."
                          },
                          "launches": {
                            "type": "array",
                            "items": {
                              "type": "integer"
                            },
                            "description": "Launches per window, in the order of `windows`."
                          }
                        },
                        "required": [
                          "license_key",
                          "username",
                          "created_at",
                          "total_launches",
                          "launches"
                        ]
                      },
                      "description": "Users."
                    },
                    "total": {
                      "type": "integer",
                      "description": "Total users in the cohort."
                    },
                    "limit": {
                      "type": "integer",
                      "description": "Applied page size."
                    },
                    "offset": {
                      "type": "integer",
                      "description": "Applied offset."
                    }
                  },
                  "required": [
                    "windows",
                    "users",
                    "total",
                    "limit",
                    "offset"
                  ]
                },
                "example": {
                  "windows": [
                    {
                      "label": "D1",
                      "start_days": 0,
                      "end_days": 1
                    },
                    {
                      "label": "D7",
                      "start_days": 1,
                      "end_days": 7
                    }
                  ],
                  "users": [
                    {
                      "license_key": "SAMPLEDEV-Hy6Rk1Ws9Jd3Fq8Lp",
                      "username": "sampledev",
                      "created_at": 1788500000,
                      "total_launches": 9,
                      "last_launch_at": 1791380400,
                      "launches": [
                        2,
                        3
                      ]
                    }
                  ],
                  "total": 132,
                  "limit": 2000,
                  "offset": 0
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `cohort` is not a month in `YYYY-MM` form. Send `cohort` as `YYYY-MM`, such as `2026-09`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`cohort` is not a month in `YYYY-MM` form.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid cohort: <cohort>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-retention/#list-cohort-users"
        }
      }
    },
    "/admin/dashboard/stickiness": {
      "get": {
        "operationId": "admin-retention.retrieve-stickiness",
        "summary": "Retrieve stickiness",
        "description": "Returns active users per short period against active users per longer period.\n\nFor example `numerator=day` and `denominator=month` gives daily over monthly active users.",
        "tags": [
          "Retention"
        ],
        "parameters": [
          {
            "name": "chain_id",
            "in": "query",
            "required": false,
            "description": "Restricts to one chain. `all` is not sent.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "eth",
                "bsc",
                "base",
                "robinhood",
                "monad",
                "arc",
                "xlayer"
              ]
            }
          },
          {
            "name": "currency",
            "in": "query",
            "required": false,
            "description": "Unit of the money amounts. The web app offers `native` only with a `chain_id`.",
            "schema": {
              "type": "string",
              "enum": [
                "usd",
                "native"
              ],
              "default": "usd"
            }
          },
          {
            "name": "include_archived",
            "in": "query",
            "required": false,
            "description": "Counts archived launches.",
            "schema": {
              "type": "boolean",
              "default": "true"
            }
          },
          {
            "name": "count_group_members",
            "in": "query",
            "required": false,
            "description": "Counts launches that belong to a launch group.",
            "schema": {
              "type": "boolean",
              "default": "false"
            }
          },
          {
            "name": "utc_offset",
            "in": "query",
            "required": false,
            "description": "Offset from UTC, in hours, for bucket boundaries. The web app leaves it out for UTC+1.",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "numerator",
            "in": "query",
            "required": false,
            "description": "Short period.",
            "schema": {
              "type": "string",
              "enum": [
                "day",
                "week",
                "month",
                "year",
                "all"
              ]
            }
          },
          {
            "name": "denominator",
            "in": "query",
            "required": false,
            "description": "Long period.",
            "schema": {
              "type": "string",
              "enum": [
                "day",
                "week",
                "month",
                "year",
                "all"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "numerator": {
                      "type": "string",
                      "enum": [
                        "day",
                        "week",
                        "month",
                        "year",
                        "all"
                      ],
                      "description": "Short period applied."
                    },
                    "denominator": {
                      "type": "string",
                      "enum": [
                        "day",
                        "week",
                        "month",
                        "year",
                        "all"
                      ],
                      "description": "Long period applied."
                    },
                    "points": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "period_start": {
                            "type": "integer",
                            "description": "Short period start, Unix seconds."
                          },
                          "active_users": {
                            "type": "integer",
                            "description": "Users with a launch in the short period."
                          },
                          "denominator_period_start": {
                            "type": "integer",
                            "description": "Enclosing long period start, Unix seconds."
                          },
                          "denominator_active_users": {
                            "type": "integer",
                            "description": "Users with a launch in the long period."
                          }
                        },
                        "required": [
                          "period_start",
                          "active_users",
                          "denominator_period_start",
                          "denominator_active_users"
                        ]
                      },
                      "description": "One point per short period."
                    }
                  },
                  "required": [
                    "numerator",
                    "denominator",
                    "points"
                  ]
                },
                "example": {
                  "numerator": "day",
                  "denominator": "month",
                  "points": [
                    {
                      "period_start": 1792281600,
                      "active_users": 38,
                      "denominator_period_start": 1790812800,
                      "denominator_active_users": 164
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "`bad_request`: `numerator` or `denominator` is not a known period. Send `day`, `week`, `month`, `year` or `all`.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "bad_request": {
                    "summary": "`numerator` or `denominator` is not a known period.",
                    "value": {
                      "ok": false,
                      "code": "bad_request",
                      "message": "invalid period: <period>"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "`too_many_requests`: All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries). Retry with exponential backoff.\n\n`too_many_requests`: The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none. Retry with exponential backoff, and narrow the query, for example to one `chain_id`, if it keeps failing.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "too_many_requests": {
                    "summary": "All analytics slots stayed busy for 45 seconds: the API runs at most three analytics computations at once. The web app retries with exponential backoff (2 s doubling, capped at 30 s, up to 8 retries).",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are busy, retry in a minute"
                    }
                  },
                  "too_many_requests_2": {
                    "summary": "The aggregate ran past the 60-second analytics limit and was stopped. The API serves its last answer for the same query instead when it has one from the past hour, so this means it has none.",
                    "value": {
                      "ok": false,
                      "code": "too_many_requests",
                      "message": "analytics are computing, retry in a minute"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-retention/#retrieve-stickiness"
        }
      }
    },
    "/admin/sinks": {
      "get": {
        "operationId": "admin-sinks.list-sinks",
        "summary": "List sinks",
        "description": "Returns one chain's sinks with live on-chain balances, newest first.",
        "tags": [
          "Fee sinks"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Chain.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "bsc",
                "eth",
                "base",
                "robinhood"
              ],
              "default": "sol"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filters on status. Use `retired` to see closed sinks.",
            "schema": {
              "type": "string",
              "enum": [
                "funding",
                "active",
                "draining",
                "retired"
              ]
            }
          },
          {
            "name": "asset",
            "in": "query",
            "required": false,
            "description": "Filters on asset.",
            "schema": {
              "type": "string",
              "enum": [
                "native",
                "usdc",
                "usd1"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "sinks": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      },
                      "description": "Sinks. See [Sink](#object-sink)."
                    }
                  },
                  "required": [
                    "sinks"
                  ]
                },
                "example": {
                  "sinks": [
                    {
                      "id": 42,
                      "chain_id": "sol",
                      "asset": "usdc",
                      "address": "Fgi2HMYCFt7Hu4ZR7fmiHNxQQvqVDgPx8WUz23zE33Xc",
                      "status": "active",
                      "total_received_usd": 1840000000,
                      "husher_order_id": null,
                      "drain_token": null,
                      "drain_network": null,
                      "opened_at": 1791900000,
                      "activated_at": 1791900120,
                      "retired_at": null,
                      "native_balance": "2039280",
                      "token_balance": "1840000000"
                    }
                  ]
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": true,
        "x-proxima-retry": {
          "policy": "safe"
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-sinks/#list-sinks"
        }
      }
    },
    "/admin/sinks/run-sweep": {
      "post": {
        "operationId": "admin-sinks.run-a-fee-sweep",
        "summary": "Run a fee sweep",
        "description": "Starts a fee sweep on a chain now.\n\nA sweep collects fees into the sinks and pays referrers. It runs in the background: the response only confirms it started, and failures are not reported back.\n\nMoves funds: fees are collected and referral payouts are sent.",
        "tags": [
          "Fee sinks"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Chain.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "bsc",
                "eth",
                "base",
                "robinhood"
              ],
              "default": "sol"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when accepted."
                    },
                    "triggered": {
                      "type": "string",
                      "description": "Job started: `fee_sweep` or `sink_rotation`."
                    },
                    "chain": {
                      "type": "string",
                      "description": "The `chain` query value, `sol` when omitted."
                    }
                  },
                  "required": [
                    "ok",
                    "chain"
                  ]
                },
                "example": {
                  "ok": true,
                  "triggered": "fee_sweep",
                  "chain": "sol"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A sweep already running makes the new one skip, and a later run only collects what is still pending."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-sinks/#run-a-fee-sweep"
        }
      }
    },
    "/admin/sinks/run-rotation": {
      "post": {
        "operationId": "admin-sinks.run-a-sink-rotation",
        "summary": "Run a sink rotation",
        "description": "Starts a sink rotation on a chain now.\n\nA rotation maintains the sink pool and drains sinks. It runs in the background: the response only confirms it started.\n\nMoves funds: sinks may be drained.",
        "tags": [
          "Fee sinks"
        ],
        "parameters": [
          {
            "name": "chain",
            "in": "query",
            "required": false,
            "description": "Chain.",
            "schema": {
              "type": "string",
              "enum": [
                "sol",
                "bsc",
                "eth",
                "base",
                "robinhood"
              ],
              "default": "sol"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when accepted."
                    },
                    "triggered": {
                      "type": "string",
                      "description": "Job started: `fee_sweep` or `sink_rotation`."
                    },
                    "chain": {
                      "type": "string",
                      "description": "The `chain` query value, `sol` when omitted."
                    }
                  },
                  "required": [
                    "ok",
                    "chain"
                  ]
                },
                "example": {
                  "ok": true,
                  "triggered": "sink_rotation",
                  "chain": "sol"
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "safe",
          "note": "A rotation already running makes the new one skip, and a later run only acts on sinks that still need it."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-sinks/#run-a-sink-rotation"
        }
      }
    },
    "/admin/sinks/{sink_id}/close": {
      "post": {
        "operationId": "admin-sinks.close-a-sink",
        "summary": "Close a sink",
        "description": "Drains an active sink to the treasury and retires it.\n\nThe sink moves to `draining` at once and to `retired` once the drain settles. The sink's own chain is used.\n\nMoves funds and cannot be undone: the sink stops receiving fees.",
        "tags": [
          "Fee sinks"
        ],
        "parameters": [
          {
            "name": "sink_id",
            "in": "path",
            "required": true,
            "description": "Sink id.",
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "ok": {
                      "type": "boolean",
                      "description": "`true` when accepted."
                    },
                    "message": {
                      "type": "string",
                      "description": "Outcome, such as `drain initiated for usdc sink 42`."
                    }
                  },
                  "required": [
                    "ok",
                    "message"
                  ]
                },
                "example": {
                  "ok": true,
                  "message": "drain initiated for usdc sink 42"
                }
              }
            }
          },
          "422": {
            "description": "`unprocessable`: No sink has this id. Use a sink id returned by [List sinks](/reference/admin-sinks/#list-sinks).\n\n`unprocessable`: A sink rotation is running and holds the sinks. Retry in a few seconds.\n\n`unprocessable`: The sink is not `active`: it is still funding, already draining, or retired. Check the sink's `status` with [List sinks](/reference/admin-sinks/#list-sinks); only an `active` sink can be closed.\n\n`unprocessable`: The drain could not start, for example `husher not configured`. The message is the reason, and the sink stays `active`. Fix the cause in the message, then retry.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                },
                "examples": {
                  "unprocessable": {
                    "summary": "No sink has this id.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "sink not found"
                    }
                  },
                  "unprocessable_2": {
                    "summary": "A sink rotation is running and holds the sinks.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "rotation in progress, retry shortly"
                    }
                  },
                  "unprocessable_3": {
                    "summary": "The sink is not `active`: it is still funding, already draining, or retired.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "sink <sink_id> is '<status>'; only active sinks can be drained"
                    }
                  },
                  "unprocessable_4": {
                    "summary": "The drain could not start, for example `husher not configured`. The message is the reason, and the sink stays `active`.",
                    "value": {
                      "ok": false,
                      "code": "unprocessable",
                      "message": "<reason>"
                    }
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "x-proxima-auth": "admin",
        "x-proxima-read-only-token": false,
        "x-proxima-retry": {
          "policy": "check",
          "note": "A lost call may have started the drain. Read the sink with [List sinks](/reference/admin-sinks/#list-sinks): `draining` or `retired` means it did."
        },
        "x-proxima-stability": "internal",
        "externalDocs": {
          "url": "https://api-docs.proxima.tools/reference/admin-sinks/#close-a-sink"
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT",
        "description": "Upgraded session token from POST /auth/exchange or POST /auth/upgrade."
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "ok",
          "message"
        ],
        "properties": {
          "ok": {
            "const": false
          },
          "code": {
            "type": "string",
            "description": "Machine-readable error code."
          },
          "message": {
            "type": "string",
            "description": "Human-readable explanation."
          }
        },
        "additionalProperties": true
      }
    }
  }
}