{
  "openapi": "3.1.0",
  "info": {
    "title": "Fronex Mobile & Financial API",
    "version": "2.3.0",
    "description": "Native mobile apps use scoped expiring bearer tokens; browser clients use the HttpOnly web session and explicit CSRF protection. Backend-only integrations additionally require provisioned HMAC credentials. Live external market observations include source identity, server/source timestamps, candles and book snapshots, and never credit a wallet or create executable exchange liquidity. Ethereum/BSC/Solana runtime is installed; actual issuance requires funded gas payers and verified finality. FRX has one canonical Solana genesis and a 30% platform creation-fee discount; gas is excluded."
  },
  "servers": [
    {
      "url": "https://fronex.io/api/v2"
    },
    {
      "url": "https://staging.fronex.io/api/v2"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Opaque 12-hour Laravel Sanctum mobile token."
      }
    },
    "schemas": {
      "Register": {
        "type": "object",
        "required": [
          "email",
          "password",
          "password_confirmation",
          "agree"
        ],
        "properties": {
          "firstname": {
            "type": "string",
            "maxLength": 40
          },
          "lastname": {
            "type": "string",
            "maxLength": 40
          },
          "username": {
            "type": "string",
            "minLength": 3,
            "maxLength": 40,
            "pattern": "^[A-Za-z0-9_-]+$"
          },
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 40
          },
          "password": {
            "type": "string",
            "minLength": 12,
            "format": "password"
          },
          "password_confirmation": {
            "type": "string",
            "format": "password"
          },
          "agree": {
            "type": "boolean",
            "const": true
          }
        }
      },
      "Login": {
        "type": "object",
        "required": [
          "email",
          "password"
        ],
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "maxLength": 40
          },
          "password": {
            "type": "string",
            "format": "password"
          },
          "otp": {
            "type": "string",
            "pattern": "^[0-9]{6}$"
          }
        }
      },
      "Profile": {
        "type": "object",
        "required": [
          "country_code",
          "country_name",
          "address",
          "city",
          "zip"
        ],
        "properties": {
          "country_code": {
            "type": "string"
          },
          "country_name": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "state": {
            "type": "string"
          },
          "zip": {
            "type": "string"
          },
          "mobile": {
            "type": "string"
          },
          "dial_code": {
            "type": "string"
          },
          "password_confirmation": {
            "type": "string"
          },
          "otp": {
            "type": "string"
          }
        }
      },
      "Phone": {
        "type": "object",
        "required": [
          "mobile",
          "dial_code",
          "password_confirmation"
        ],
        "properties": {
          "mobile": {
            "type": "string",
            "pattern": "^[0-9]{6,15}$"
          },
          "dial_code": {
            "type": "string",
            "pattern": "^[1-9][0-9]{0,3}$"
          },
          "password_confirmation": {
            "type": "string",
            "format": "password"
          },
          "otp": {
            "type": "string",
            "pattern": "^[0-9]{6}$"
          }
        }
      },
      "Order": {
        "type": "object",
        "required": [
          "client_order_id",
          "side",
          "price",
          "quantity"
        ],
        "properties": {
          "client_order_id": {
            "type": "string",
            "maxLength": 64,
            "description": "Stable logical operation ID. Reuse on an ambiguous retry."
          },
          "side": {
            "enum": [
              "buy",
              "sell"
            ]
          },
          "type": {
            "enum": [
              "limit",
              "market"
            ],
            "default": "limit"
          },
          "time_in_force": {
            "enum": [
              "GTC",
              "IOC",
              "FOK"
            ]
          },
          "price": {
            "type": "string",
            "pattern": "^[0-9]+(\\.[0-9]{1,8})?$",
            "description": "Market orders require this cap for buys or floor for sells."
          },
          "quantity": {
            "type": "string",
            "pattern": "^[0-9]+(\\.[0-9]{1,8})?$"
          }
        }
      },
      "Transfer": {
        "type": "object",
        "required": [
          "client_reference",
          "recipient_id",
          "asset_id",
          "amount"
        ],
        "properties": {
          "client_reference": {
            "type": "string",
            "maxLength": 64
          },
          "recipient_id": {
            "type": "integer"
          },
          "asset_id": {
            "type": "integer"
          },
          "amount": {
            "type": "string"
          }
        }
      },
      "Kyc": {
        "type": "object",
        "required": [
          "level",
          "identity"
        ],
        "properties": {
          "level": {
            "type": "integer",
            "minimum": 1,
            "maximum": 3
          },
          "identity": {
            "type": "object",
            "required": [
              "full_name",
              "date_of_birth",
              "country",
              "address"
            ],
            "properties": {
              "full_name": {
                "type": "string"
              },
              "date_of_birth": {
                "type": "string",
                "format": "date"
              },
              "country": {
                "type": "string",
                "minLength": 2,
                "maxLength": 2
              },
              "address": {
                "type": "string"
              }
            }
          }
        }
      },
      "Document": {
        "type": "object",
        "required": [
          "kind",
          "base64"
        ],
        "properties": {
          "kind": {
            "enum": [
              "identity_front",
              "identity_back",
              "selfie",
              "address_proof",
              "source_of_funds"
            ]
          },
          "base64": {
            "type": "string",
            "contentEncoding": "base64",
            "maxLength": 11184812
          }
        }
      },
      "Payment": {
        "type": "object",
        "required": [
          "client_reference",
          "asset_id",
          "amount",
          "direction",
          "provider",
          "method"
        ],
        "properties": {
          "client_reference": {
            "type": "string",
            "maxLength": 64
          },
          "asset_id": {
            "type": "integer"
          },
          "amount": {
            "type": "string",
            "description": "Fiat decimal string at configured asset precision."
          },
          "direction": {
            "enum": [
              "deposit",
              "withdrawal"
            ]
          },
          "provider": {
            "enum": [
              "stripe",
              "paypal",
              "bank"
            ]
          },
          "method": {
            "enum": [
              "card",
              "apple_pay",
              "google_pay",
              "paypal",
              "bank_transfer"
            ]
          },
          "destination": {
            "type": "object",
            "properties": {
              "email": {
                "type": "string"
              },
              "iban": {
                "type": "string"
              },
              "bic": {
                "type": "string"
              },
              "account_name": {
                "type": "string"
              },
              "bank_name": {
                "type": "string"
              }
            }
          }
        }
      },
      "Card": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "type": {
            "enum": [
              "virtual",
              "physical"
            ]
          },
          "delivery_address": {
            "type": "object",
            "properties": {
              "line1": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "postcode": {
                "type": "string"
              },
              "country": {
                "type": "string"
              }
            }
          }
        },
        "description": "Records a review application only. Issuance is unavailable without an issuer."
      }
    }
  },
  "paths": {
    "/auth/register": {
      "post": {
        "summary": "Create an account; email ownership must be verified",
        "operationId": "post_auth_register",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Register"
              }
            }
          }
        }
      }
    },
    "/auth/login": {
      "post": {
        "summary": "Password and optional configured TOTP login",
        "operationId": "post_auth_login",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Login"
              }
            }
          }
        }
      }
    },
    "/auth/verify-email": {
      "post": {
        "summary": "Consume a delivered six-digit registration email code",
        "security": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "email",
                  "code"
                ],
                "properties": {
                  "email": {
                    "type": "string",
                    "format": "email"
                  },
                  "code": {
                    "type": "string",
                    "pattern": "^[0-9]{6}$"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Email verified; code consumed atomically."
          },
          "422": {
            "description": "Wrong, expired or consumed code. Five failed attempts invalidate the challenge."
          },
          "429": {
            "description": "Verification attempt limit reached."
          }
        }
      }
    },
    "/capabilities": {
      "get": {
        "summary": "Public capabilities",
        "operationId": "get_capabilities",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/assets": {
      "get": {
        "summary": "Public assets",
        "operationId": "get_assets",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/markets": {
      "get": {
        "summary": "Public markets",
        "operationId": "get_markets",
        "security": [],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "description": "Database-backed crypto, stock, FX and metal-futures catalog. price/change/high/volume retain actual Fronex execution semantics. Optional reference object supplies independently source-labelled observations for display, with source_time/server_time, volume_unit, change_period, market_status and executable=false. Delayed/session observations never enable trading or credit wallets."
      }
    },
    "/markets/{symbol}/book": {
      "get": {
        "summary": "Committed price-level snapshot",
        "operationId": "get_markets__symbol__book",
        "security": [],
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/markets/{symbol}/executions": {
      "get": {
        "summary": "Recent real executions",
        "operationId": "get_markets__symbol__executions",
        "security": [],
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/markets/{symbol}/candles": {
      "get": {
        "summary": "Executed-price OHLCV; empty buckets are not fabricated",
        "operationId": "get_markets__symbol__candles",
        "security": [],
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "interval",
            "in": "query",
            "required": true,
            "schema": {
              "enum": [
                "1m",
                "5m",
                "15m",
                "1h",
                "1d"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/me": {
      "get": {
        "summary": "Own account and onboarding status",
        "operationId": "get_me",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      },
      "post": {
        "summary": "Complete own profile",
        "operationId": "post_me",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Profile"
              }
            }
          }
        }
      }
    },
    "/auth/logout": {
      "post": {
        "summary": "Revoke current token, its signing keys and active stream leases",
        "operationId": "post_auth_logout",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/auth/resend-email": {
      "post": {
        "summary": "Request a verification email",
        "operationId": "post_auth_resend_email",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/auth/phone": {
      "post": {
        "summary": "Set phone with fresh password and configured TOTP confirmation",
        "operationId": "post_auth_phone",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Phone"
              }
            }
          }
        }
      }
    },
    "/auth/phone/send": {
      "post": {
        "summary": "Request a purpose-bound SMS challenge",
        "operationId": "post_auth_phone_send",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/auth/phone/verify": {
      "post": {
        "summary": "Consume phone challenge; expiry and attempt limits apply",
        "operationId": "post_auth_phone_verify",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "code"
                ],
                "properties": {
                  "code": {
                    "type": "string",
                    "pattern": "^[0-9]{6}$"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/keys": {
      "get": {
        "summary": "List own key metadata; no secrets",
        "operationId": "get_keys",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      },
      "post": {
        "summary": "Retired frontend signing-key issuance",
        "operationId": "post_keys",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "410": {
            "description": "Frontend signing-key issuance retired"
          }
        },
        "description": "Retired: signing credentials are issued only by the server CLI into a private server file.",
        "deprecated": true
      }
    },
    "/keys/{key}": {
      "delete": {
        "summary": "Revoke own key and invalidate stream leases",
        "operationId": "delete_keys__key_",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "key",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/wallet": {
      "get": {
        "summary": "Own wallet",
        "operationId": "get_wallet",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/wallet/entries": {
      "get": {
        "summary": "Own wallet/entries",
        "operationId": "get_wallet_entries",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/orders": {
      "get": {
        "summary": "Own orders",
        "operationId": "get_orders",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/verification": {
      "get": {
        "summary": "Own verification",
        "operationId": "get_verification",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/kyc": {
      "get": {
        "summary": "Own kyc",
        "operationId": "get_kyc",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      },
      "post": {
        "summary": "Create a verification draft",
        "operationId": "post_kyc",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Kyc"
              }
            }
          }
        }
      }
    },
    "/payments": {
      "get": {
        "summary": "Own payments",
        "operationId": "get_payments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      },
      "post": {
        "summary": "Create idempotent deposit or reserved withdrawal",
        "operationId": "post_payments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Payment"
              }
            }
          }
        }
      }
    },
    "/cards": {
      "get": {
        "summary": "Own cards",
        "operationId": "get_cards",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      },
      "post": {
        "summary": "Request issuer review, when applications enabled",
        "operationId": "post_cards",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Card"
              }
            }
          }
        }
      }
    },
    "/wallet/transfers": {
      "post": {
        "summary": "Atomic internal ledger transfer",
        "operationId": "post_wallet_transfers",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Transfer"
              }
            }
          }
        }
      }
    },
    "/orders/{symbol}": {
      "post": {
        "summary": "Price-protected limit or market order",
        "operationId": "post_orders__symbol_",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Order"
              }
            }
          }
        }
      }
    },
    "/orders/{order}/cancel": {
      "post": {
        "summary": "Cancel own remaining order and release locked balance",
        "operationId": "post_orders__order__cancel",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "order",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/socket-ticket": {
      "post": {
        "summary": "Issue single-use 45-second stream ticket",
        "operationId": "post_socket_ticket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/kyc/{submission}/documents": {
      "post": {
        "summary": "Upload signed JSON/base64 document; decrypted size at most 8 MiB",
        "operationId": "post_kyc__submission__documents",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "submission",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Document"
              }
            }
          }
        }
      }
    },
    "/kyc/{submission}/submit": {
      "post": {
        "summary": "Submit complete draft for administrator review",
        "operationId": "post_kyc__submission__submit",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "submission",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/kyc/{submission}/withdraw": {
      "post": {
        "summary": "Withdraw own draft or submitted application",
        "operationId": "post_kyc__submission__withdraw",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "submission",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/payments/{payment}/start": {
      "post": {
        "summary": "Create/retrieve processor payment intent or bank instructions",
        "operationId": "post_payments__payment__start",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "payment",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/payments/{payment}/capture": {
      "post": {
        "summary": "Request PayPal capture; verified webhook credits ledger",
        "operationId": "post_payments__payment__capture",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "payment",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/cards/{application}/cancel": {
      "post": {
        "summary": "Cancel own unreviewed application",
        "operationId": "post_cards__application__cancel",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "application",
            "in": "path",
            "required": true,
            "schema": {
              "type": "integer"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful request; lists preserve Laravel pagination where applicable."
          },
          "201": {
            "description": "Resource created, for creation endpoints."
          },
          "204": {
            "description": "Completed without a response body, for cancellation/revocation."
          },
          "401": {
            "description": "Token/signature missing, expired or invalid."
          },
          "403": {
            "description": "Account verification, KYC or authorization required."
          },
          "409": {
            "description": "State/idempotency conflict or replayed nonce."
          },
          "422": {
            "description": "Validation or insufficient funds."
          },
          "429": {
            "description": "Rate limit exceeded."
          },
          "503": {
            "description": "Capability or configured provider unavailable."
          }
        }
      }
    },
    "/reference-quotes": {
      "get": {
        "summary": "Public external crypto reference prices",
        "description": "Read-only Binance public BTC/ETH/SOL prices, refreshed every 30 seconds. Separate from Fronex executions, candles, order books and ledger. May return status unavailable with an empty data list.",
        "security": [],
        "responses": {
          "200": {
            "description": "Source, freshness, status and indicative quotes (or explicitly unavailable)"
          }
        }
      }
    },
    "/frx/tokenomics": {
      "get": {
        "summary": "Fixed FRX supply policy; administrative baseline is not a live price",
        "security": [],
        "responses": {
          "200": {
            "description": "Successful JSON response"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Verification required"
          },
          "422": {
            "description": "Invalid input"
          },
          "503": {
            "description": "Required fee or fresh conversion rate unavailable"
          }
        }
      }
    },
    "/launchpad/projects": {
      "get": {
        "summary": "List only the authenticated creator?s drafts",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Successful JSON response"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Verification required"
          },
          "422": {
            "description": "Invalid input"
          },
          "503": {
            "description": "Required fee or fresh conversion rate unavailable"
          }
        }
      },
      "post": {
        "summary": "Save an idempotent three-chain token draft; no charge or broadcast",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "201": {
            "description": "Created or idempotently returned"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Verification required"
          },
          "422": {
            "description": "Invalid input"
          },
          "503": {
            "description": "Required fee or fresh conversion rate unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "network",
                  "name",
                  "symbol",
                  "decimals",
                  "supply",
                  "recipient",
                  "quote_symbol",
                  "client_reference"
                ],
                "properties": {
                  "network": {
                    "enum": [
                      "ethereum",
                      "bsc",
                      "solana"
                    ]
                  },
                  "name": {
                    "type": "string",
                    "maxLength": 80
                  },
                  "symbol": {
                    "type": "string",
                    "pattern": "^[A-Z][A-Z0-9]{1,11}$"
                  },
                  "decimals": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 8
                  },
                  "supply": {
                    "type": "string"
                  },
                  "recipient": {
                    "type": "string",
                    "description": "Public recipient address only"
                  },
                  "quote_symbol": {
                    "type": "string"
                  },
                  "client_reference": {
                    "type": "string",
                    "maxLength": 64
                  }
                }
              }
            }
          }
        }
      }
    },
    "/launchpad/quotes": {
      "post": {
        "summary": "Quote platform creation fee: 30% discount only for FRX; gas excluded; no charge",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "201": {
            "description": "Created or idempotently returned"
          },
          "401": {
            "description": "Authentication required"
          },
          "403": {
            "description": "Verification required"
          },
          "422": {
            "description": "Invalid input"
          },
          "503": {
            "description": "Required fee or fresh conversion rate unavailable"
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "network",
                  "payment_asset"
                ],
                "properties": {
                  "network": {
                    "enum": [
                      "ethereum",
                      "bsc",
                      "solana"
                    ]
                  },
                  "payment_asset": {
                    "enum": [
                      "FRX",
                      "USDT",
                      "ETH"
                    ]
                  }
                }
              }
            }
          }
        }
      }
    },
    "/launchpad/readiness": {
      "get": {
        "summary": "Actual chain adapter installation; no secrets or activation action",
        "security": [],
        "responses": {
          "200": {
            "description": "Network status, broadcasts disabled and operational requirements"
          }
        }
      }
    },
    "/market-data/{symbol}": {
      "get": {
        "summary": "Source-labelled external price, depth and candles",
        "security": [],
        "parameters": [
          {
            "name": "symbol",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "enum": [
                "BTC-USDT",
                "ETH-USDT",
                "SOL-USDT"
              ]
            }
          },
          {
            "name": "interval",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "1m",
                "5m",
                "15m",
                "1h",
                "1d"
              ],
              "default": "15m"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Fresh external_reference observation. executable=false; source_time and server_time are Unix milliseconds. Never substitute for a Fronex execution or spendable wallet balance."
          },
          "404": {
            "description": "No external mapping for this asset, including unissued FRX."
          },
          "503": {
            "description": "Fresh validated upstream data unavailable. No previous price or book is returned."
          }
        }
      }
    },
    "/launchpad/deployments": {
      "get": {
        "summary": "Own deployment operations only",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated own operations with status, transaction/address and fee state."
          },
          "401": {
            "description": "Scoped expiring bearer token required."
          }
        }
      }
    },
    "/launchpad/projects/{project}/estimate": {
      "post": {
        "summary": "Estimate gas for own saved draft",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Actual network gas estimate; funding or RPC problems do not reserve a platform fee."
          },
          "503": {
            "description": "Runtime, gas funding or RPC unavailable."
          }
        }
      }
    },
    "/launchpad/projects/{project}/deploy": {
      "post": {
        "summary": "Confirm mainnet deployment with a fresh own fee quote",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "project",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "quote_id",
                  "confirmed"
                ],
                "properties": {
                  "quote_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "confirmed": {
                    "const": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Durable operation accepted; fee reserved. Settlement follows verified finality."
          },
          "503": {
            "description": "Runtime, gas funding or RPC unavailable."
          }
        }
      }
    },
    "/launchpad/deployments/{deployment}/cancel": {
      "post": {
        "summary": "Cancel own operation only if never signed",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "deployment",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cancellation persisted and fee reservation released."
          },
          "409": {
            "description": "Signed or ambiguous operation cannot be cancelled; reconciliation required."
          }
        }
      }
    }
  }
}
