{"openapi":"3.1.0","info":{"title":"Vanta API","description":"REST surface over the [Vanta Network](https://github.com/taoshidev/vanta-network) and [Hyperscaled SDK](https://github.com/taoshidev/hyperscaled-sdk),\nexposing trading on two execution venues behind one consistent API.\n\n## Authentication\n\nEvery request carries a **partner API key** as a bearer token:\n\n```\nAuthorization: Bearer <partner_api_key>\n```\n\nMost endpoints also need a **`Trader-ID`** header identifying which trader the\ncall acts on. It is polymorphic by venue:\n\n| Venue | `Trader-ID` | Example |\n|-------|-------------|---------|\n| Hyperliquid (`/hyperscaled`) | HL wallet address | `0x1234…abcd` |\n| Vanta (`/vanta`) | integer subaccount id | `42` |\n\nRegistration endpoints take the partner key **only** — the trader/subaccount\ndoes not exist yet — so they omit `Trader-ID`.\n\n## The two venues\n\n- **Hyperliquid** (`*/hyperscaled`) routes through the SDK and signs on-chain.\n  Writes require an **enrolled session** (`POST /v1/sessions`) holding the\n  trader's signing key; reads need only the partner key + `Trader-ID`.\n- **Vanta** (`*/vanta`) is network-direct via the entity miner. No signing and\n  no enrollment — the miner custodies and executes. The entity miner exposes a\n  single order route, so the `/vanta` order variants (close, tp-sl, edit,\n  cancel) are convenience wrappers that all submit with a different\n  `execution_type`.\n\n## Getting started — a Vanta walkthrough\n\nRegister a subaccount, trade it, and read its positions. Examples target the\nstaging host; set `$KEY` to your partner API key.\n\n### 1. Register a Vanta subaccount\n\nNo `Trader-ID` — the subaccount doesn't exist yet. Send `asset_class` for a\nstandard subaccount, or `hl_address` (+ optional `payout_address`) for an\nHL-linked one.\n\n```bash\ncurl -X POST \"https://api.staging.vantanetwork.io/v1/register/vanta\" \\\n  -H \"Authorization: Bearer $KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"asset_class\": \"crypto\", \"account_size\": 25000}'\n```\n\n```json\n{ \"subaccount\": { \"subaccount_id\": 42, \"asset_class\": \"crypto\",\n                  \"account_size\": 25000.0 }, \"message\": \"Subaccount created\" }\n```\n\nThe returned **`subaccount_id`** (here `42`) is your `Trader-ID` for the order\ncalls below.\n\n### 2. Place an order\n\n`Trader-ID` is the integer `subaccount_id`. Provide exactly one of\n`leverage` / `value` / `quantity`. `execution_type` defaults to `MARKET`.\n\n```bash\ncurl -X POST \"https://api.staging.vantanetwork.io/v1/orders/vanta\" \\\n  -H \"Authorization: Bearer $KEY\" \\\n  -H \"Trader-ID: 42\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"trade_pair\": \"BTCUSDC\", \"order_type\": \"LONG\", \"leverage\": 0.1}'\n```\n\n```json\n{ \"success\": true, \"order_uuid\": \"f47ac10b-…\", \"processing_time\": 1.23 }\n```\n\n### 3. Close the position\n\nFlattens the open position for a pair (submits `execution_type=FLAT_ALL`):\n\n```bash\ncurl -X POST \"https://api.staging.vantanetwork.io/v1/orders/vanta/close\" \\\n  -H \"Authorization: Bearer $KEY\" \\\n  -H \"Trader-ID: 42\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"trade_pair\": \"BTCUSDC\"}'\n```\n\nRelated order management on the same subaccount: `POST /v1/orders/vanta/tp-sl`\n(attach take-profit/stop-loss), `POST /v1/orders/vanta/{order_uuid}/edit`\n(amend a resting order), `DELETE /v1/orders/vanta/{order_uuid}?trade_pair=…`\n(cancel), and `GET /v1/orders/vanta/{order_uuid}` (status).\n\n## Generating a client\n\nThe spec is served at **`/openapi.json`**. Generate a typed TypeScript client\nwith [`@hey-api/openapi-ts`](https://heyapi.dev):\n\n```bash\nnpx @hey-api/openapi-ts -i https://api.staging.vantanetwork.io/openapi.json -o ./client\n```\n","version":"0.1.0"},"paths":{"/v1/sessions":{"get":{"tags":["sessions"],"summary":"List enrolled traders for this partner","operationId":"list_sessions_v1_sessions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SessionInfo"},"type":"array","title":"Response List Sessions V1 Sessions Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["sessions"],"summary":"Enroll (or re-enroll) a trader","description":"Upsert credentials for `(partner_id, hl_wallet)`. Re-enrolling the same wallet replaces the stored key — useful for agent-key rotation. The private key is never returned in any response.","operationId":"enroll_session_v1_sessions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionEnrollRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/sessions/{hl_wallet}":{"get":{"tags":["sessions"],"summary":"Get enrollment status for one trader","operationId":"get_session_v1_sessions__hl_wallet__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"hl_wallet","in":"path","required":true,"schema":{"type":"string","description":"Trader's HL wallet address.","title":"Hl Wallet"},"description":"Trader's HL wallet address."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionInfo"}}}},"404":{"description":"Trader is not enrolled for this partner."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["sessions"],"summary":"Revoke a trader's enrollment","operationId":"delete_session_v1_sessions__hl_wallet__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"hl_wallet","in":"path","required":true,"schema":{"type":"string","description":"Trader's HL wallet address.","title":"Hl Wallet"},"description":"Trader's HL wallet address."}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Trader is not enrolled for this partner."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance":{"get":{"tags":["balance"],"summary":"Unified account info (both sides)","operationId":"get_balance_v1_balance_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountInfo"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/hl":{"get":{"tags":["balance"],"summary":"Native Hyperliquid balance only","operationId":"get_hl_balance_v1_balance_hl_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BalanceStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/spot":{"get":{"tags":["balance"],"summary":"Free spot USDC available to trade","operationId":"get_spot_balance_v1_balance_spot_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SpotBalance"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/balance/limits":{"get":{"tags":["balance"],"summary":"Leverage limits for this account","operationId":"get_limits_v1_balance_limits_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeverageLimits"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/positions/vanta":{"get":{"tags":["positions"],"summary":"List Vanta Positions","description":"Return open positions as tracked by the Vanta Network validator.","operationId":"list_vanta_positions_v1_positions_vanta_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Position"},"title":"Response List Vanta Positions V1 Positions Vanta Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/positions/hyperscaled":{"get":{"tags":["positions"],"summary":"List Hyperscaled Positions","description":"Return open positions as held on the Hyperliquid exchange.","operationId":"list_hyperscaled_positions_v1_positions_hyperscaled_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Position"},"title":"Response List Hyperscaled Positions V1 Positions Hyperscaled Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/hyperscaled":{"get":{"tags":["orders"],"summary":"List open orders (Hyperliquid)","operationId":"list_open_orders_v1_orders_hyperscaled_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Order"},"title":"Response List Open Orders V1 Orders Hyperscaled Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["orders"],"summary":"Submit an order (Hyperliquid)","operationId":"submit_order_v1_orders_hyperscaled_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitOrderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["orders"],"summary":"Cancel all open orders (Hyperliquid)","operationId":"cancel_all_orders_v1_orders_hyperscaled_delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/hyperscaled/close":{"post":{"tags":["orders"],"summary":"Market-close an open position (Hyperliquid)","operationId":"close_position_v1_orders_hyperscaled_close_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__routers__orders__ClosePositionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/hyperscaled/tp-sl":{"post":{"tags":["orders"],"summary":"Add or replace TP/SL on a position (Hyperliquid)","operationId":"set_tp_sl_v1_orders_hyperscaled_tp_sl_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__routers__orders__TpSlRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TpSlResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/hyperscaled/{order_id}":{"delete":{"tags":["orders"],"summary":"Cancel one order by ID (Hyperliquid)","operationId":"cancel_order_v1_orders_hyperscaled__order_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_id","in":"path","required":true,"schema":{"type":"string","description":"Hyperliquid order ID to cancel.","title":"Order Id"},"description":"Hyperliquid order ID to cancel."},{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/vanta":{"post":{"tags":["orders"],"summary":"Submit an order (Vanta network)","operationId":"submit_vanta_order_v1_orders_vanta_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__routers__orders__VantaSubmitOrderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaOrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/vanta/{order_uuid}":{"get":{"tags":["orders"],"summary":"Look up a Vanta order's status","operationId":"get_vanta_order_status_v1_orders_vanta__order_uuid__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_uuid","in":"path","required":true,"schema":{"type":"string","description":"Order UUID returned at submission.","title":"Order Uuid"},"description":"Order UUID returned at submission."},{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaOrderStatus"}}}},"404":{"description":"Order not found."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["orders"],"summary":"Cancel a resting order by UUID (Vanta network)","operationId":"cancel_vanta_order_v1_orders_vanta__order_uuid__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_uuid","in":"path","required":true,"schema":{"type":"string","description":"UUID of the resting order to cancel.","title":"Order Uuid"},"description":"UUID of the resting order to cancel."},{"name":"trade_pair","in":"query","required":true,"schema":{"type":"string","description":"Pair the order belongs to, e.g. BTC/USD","title":"Trade Pair"},"description":"Pair the order belongs to, e.g. BTC/USD"},{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaOrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/vanta/close":{"post":{"tags":["orders"],"summary":"Market-close an open position (Vanta network)","operationId":"close_vanta_position_v1_orders_vanta_close_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaClosePositionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaOrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/vanta/tp-sl":{"post":{"tags":["orders"],"summary":"Add or replace TP/SL on a position (Vanta network)","operationId":"set_vanta_tp_sl_v1_orders_vanta_tp_sl_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaTpSlRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaOrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/orders/vanta/{order_uuid}/edit":{"post":{"tags":["orders"],"summary":"Edit a resting order (Vanta network)","operationId":"edit_vanta_order_v1_orders_vanta__order_uuid__edit_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_uuid","in":"path","required":true,"schema":{"type":"string","description":"UUID of the resting order to edit.","title":"Order Uuid"},"description":"UUID of the resting order to edit."},{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaEditOrderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaOrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/history/positions":{"get":{"tags":["history"],"summary":"Closed positions (funded side)","operationId":"position_history_v1_history_positions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"from_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO-8601 UTC; inclusive lower bound.","title":"From Date"},"description":"ISO-8601 UTC; inclusive lower bound."},{"name":"to_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO-8601 UTC; inclusive upper bound.","title":"To Date"},"description":"ISO-8601 UTC; inclusive upper bound."},{"name":"pair","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by trading pair, e.g. BTC-USDC.","title":"Pair"},"description":"Filter by trading pair, e.g. BTC-USDC."},{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ClosedPosition"},"title":"Response Position History V1 History Positions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/history/orders":{"get":{"tags":["history"],"summary":"Historical filled orders","operationId":"order_history_v1_history_orders_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"from_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO-8601 UTC; inclusive lower bound.","title":"From Date"},"description":"ISO-8601 UTC; inclusive lower bound."},{"name":"to_date","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO-8601 UTC; inclusive upper bound.","title":"To Date"},"description":"ISO-8601 UTC; inclusive upper bound."},{"name":"pair","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by trading pair, e.g. BTC-USDC.","title":"Pair"},"description":"Filter by trading pair, e.g. BTC-USDC."},{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Order"},"title":"Response Order History V1 History Orders Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/register/hyperscaled":{"post":{"tags":["register"],"summary":"Purchase a funded account (Hyperliquid)","description":"Executes the full x402 payment + registration flow. v1 requires the partner to include a Base private key in the request body to sign the USDC payment. See the README for the open server-side-signer decision.","operationId":"purchase_v1_register_hyperscaled_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PurchaseRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/register/hyperscaled/status/{hl_address}":{"get":{"tags":["register"],"summary":"Check registration status for an HL wallet (Hyperliquid)","operationId":"check_status_v1_register_hyperscaled_status__hl_address__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"hl_address","in":"path","required":true,"schema":{"type":"string","description":"HL wallet address.","title":"Hl Address"},"description":"HL wallet address."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegistrationStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/register/vanta":{"post":{"tags":["register"],"summary":"Create a subaccount (Vanta network)","description":"Creates a Vanta subaccount under the partner's entity via the entity miner. Provide `asset_class` for a standard subaccount, or `hl_address` (optionally with `payout_address`) for an HL-linked one. Authenticates with the partner Bearer key only — no `Trader-ID`, since the subaccount does not exist yet.","operationId":"register_vanta_v1_register_vanta_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaRegisterRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VantaRegisterResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/rules":{"get":{"tags":["rules"],"summary":"List all rules for this trader's account","operationId":"list_rules_v1_rules_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Rule"},"title":"Response List Rules V1 Rules Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rules/pairs":{"get":{"tags":["rules"],"summary":"Supported trade pairs for this trader's account","operationId":"supported_pairs_v1_rules_pairs_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SupportedPairs"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rules/validate":{"post":{"tags":["rules"],"summary":"Validate a proposed trade against all applicable rules","operationId":"validate_trade_v1_rules_validate_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateTradeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TradeValidation"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/payouts":{"get":{"tags":["payouts"],"summary":"Historical payouts","operationId":"payout_history_v1_payouts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Payout"},"title":"Response Payout History V1 Payouts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/payouts/pending":{"get":{"tags":["payouts"],"summary":"Pending payout (next disbursement)","operationId":"pending_payout_v1_payouts_pending_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Trader-ID","in":"header","required":true,"schema":{"type":"string","description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints.","title":"Trader-Id"},"description":"Trader identity. A Hyperliquid wallet address (0x + 40 hex) for Hyperliquid endpoints, or an integer subaccount id for vanta endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payout"}}}},"204":{"description":"No pending payout."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/oauth/token":{"post":{"tags":["v2 oauth"],"summary":"OAuth2 client-credentials token endpoint","description":"Exchange a client_id + client_secret (issued during app registration) for a short-lived bearer access token. The token must be sent on every subsequent /v2/** request as `Authorization: Bearer <token>`.","operationId":"issue_token_v2_oauth_token_post","requestBody":{"content":{"application/x-www-form-urlencoded":{"schema":{"$ref":"#/components/schemas/Body_issue_token_v2_oauth_token_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/oauth/me":{"get":{"tags":["v2 oauth"],"summary":"Return the resolved app principal for the current bearer.","description":"Useful smoke test after Authorize — a 200 means your token is good.","operationId":"whoami_v2_oauth_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__oauth__AppMeResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/apps/me":{"get":{"tags":["v2 apps"],"summary":"Get the current app's profile","operationId":"me_v2_apps_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__apps__AppMeResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/apps/me/rotate-secret":{"post":{"tags":["v2 apps"],"summary":"Rotate the OAuth client secret","operationId":"rotate_v2_apps_me_rotate_secret_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateSecretResponse"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/app-requests":{"post":{"tags":["app requests"],"summary":"Request API access (self-service tenant onboarding)","operationId":"create_app_request_v2_app_requests_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__app_requests__CreateAppRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedAppRequestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/login":{"post":{"tags":["v2 admin"],"summary":"Admin login (password + TOTP)","operationId":"login_v2_admin_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminLoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/logout":{"post":{"tags":["v2 admin"],"summary":"Revoke the current admin session","operationId":"logout_v2_admin_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogoutResponse"}}}}}}},"/v2/admin/me":{"get":{"tags":["v2 admin"],"summary":"Current admin profile","operationId":"me_v2_admin_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdminMeResponse"}}}}}}},"/v2/admin/totp/enroll":{"post":{"tags":["v2 admin"],"summary":"Begin TOTP enrollment (returns secret + otpauth URI)","operationId":"totp_enroll_v2_admin_totp_enroll_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpEnrollResponse"}}}}}}},"/v2/admin/totp/confirm":{"post":{"tags":["v2 admin"],"summary":"Confirm TOTP enrollment with a code","operationId":"totp_confirm_v2_admin_totp_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__admin_auth__TotpConfirmRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpConfirmResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/apps":{"get":{"tags":["v2 admin"],"summary":"List all tenant apps","operationId":"list_apps_v2_admin_apps_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AppSummary"},"type":"array","title":"Response List Apps V2 Admin Apps Get"}}}}}},"post":{"tags":["v2 admin"],"summary":"Register a new tenant app","operationId":"create_app_v2_admin_apps_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__admin_apps__CreateAppRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatedAppResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/apps/{app_id}/disable":{"post":{"tags":["v2 admin"],"summary":"Disable a tenant app","operationId":"disable_app_v2_admin_apps__app_id__disable_post","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string","title":"App Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/apps/{app_id}/enable":{"post":{"tags":["v2 admin"],"summary":"Re-enable a tenant app","operationId":"enable_app_v2_admin_apps__app_id__enable_post","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string","title":"App Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/admin/apps/{app_id}/rotate-secret":{"post":{"tags":["v2 admin"],"summary":"Rotate a tenant's OAuth client secret","operationId":"rotate_secret_v2_admin_apps__app_id__rotate_secret_post","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string","title":"App Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RotateSecretResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/auth/signup":{"post":{"tags":["v2 auth"],"summary":"Create a new end-user under this app","description":"Creates a user (idempotent on `(app_id, email)`) and sends an email OTP. Call `POST /v2/auth/verify-email` next.","operationId":"signup_v2_auth_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/auth/verify-email":{"post":{"tags":["v2 auth"],"summary":"Verify email OTP; on success, returns a session token","operationId":"verify_email_v2_auth_verify_email_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifyEmailResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/auth/resend-otp":{"post":{"tags":["v2 auth"],"summary":"Resend the email verification OTP","operationId":"resend_otp_v2_auth_resend_otp_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResendOtpRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Resend Otp V2 Auth Resend Otp Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/auth/login":{"post":{"tags":["v2 auth"],"summary":"Email + password login","operationId":"login_v2_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/auth/sessions/revoke":{"post":{"tags":["v2 auth"],"summary":"Revoke a session token (logout)","operationId":"revoke_session_v2_auth_sessions_revoke_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RevokeSessionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LogoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/auth/me":{"get":{"tags":["v2 auth"],"summary":"Return the currently authenticated end-user","operationId":"me_v2_auth_me_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Me V2 Auth Me Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/auth/password-reset/request":{"post":{"tags":["v2 auth"],"summary":"Request a password-reset token (email send)","operationId":"request_reset_v2_auth_password_reset_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Request Reset V2 Auth Password Reset Request Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/auth/password-reset/confirm":{"post":{"tags":["v2 auth"],"summary":"Confirm a password reset with the emailed token","operationId":"confirm_reset_v2_auth_password_reset_confirm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PasswordResetConfirm"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"boolean"},"type":"object","title":"Response Confirm Reset V2 Auth Password Reset Confirm Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/auth/totp/enroll":{"post":{"tags":["v2 auth"],"summary":"Begin TOTP enrollment (returns shared secret + otpauth URI)","operationId":"totp_enroll_v2_auth_totp_enroll_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/TotpEnrollRequest"},{"type":"null"}],"title":" Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpEnrollResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/auth/totp/confirm":{"post":{"tags":["v2 auth"],"summary":"Confirm TOTP enrollment with a code from the authenticator app","operationId":"totp_confirm_v2_auth_totp_confirm_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__auth__TotpConfirmRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpConfirmResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/auth/totp/disable":{"post":{"tags":["v2 auth"],"summary":"Disable TOTP for this user","operationId":"totp_disable_v2_auth_totp_disable_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TotpConfirmResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/kyc/status":{"get":{"tags":["v2 kyc"],"summary":"Read current KYC status for the authenticated user","operationId":"status_v2_kyc_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KycStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/kyc/sumsub/token":{"post":{"tags":["v2 kyc"],"summary":"Get a Sumsub WebSDK access token for the authenticated user","operationId":"sumsub_token_v2_kyc_sumsub_token_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SumsubTokenResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/kyc/stripe-identity/session":{"post":{"tags":["v2 kyc"],"summary":"Create a Stripe Identity VerificationSession","operationId":"stripe_identity_session_v2_kyc_stripe_identity_session_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StripeIdentitySessionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payments/checkout":{"post":{"tags":["v2 payments"],"summary":"Create a Stripe PaymentIntent for a challenge fee","operationId":"create_checkout_v2_payments_checkout_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePaymentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payments/free":{"post":{"tags":["v2 payments"],"summary":"Provision a free-tier (zero-amount) prop account immediately","operationId":"create_free_prop_account_v2_payments_free_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ZeroAmountRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropAccountSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payments/prop-accounts":{"get":{"tags":["v2 payments"],"summary":"List the authenticated user's prop accounts","operationId":"list_prop_accounts_v2_payments_prop_accounts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PropAccountSummary"},"title":"Response List Prop Accounts V2 Payments Prop Accounts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payments/prop-accounts/{prop_account_id}":{"get":{"tags":["v2 payments"],"summary":"Read one prop account by id","operationId":"get_prop_account_v2_payments_prop_accounts__prop_account_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"prop_account_id","in":"path","required":true,"schema":{"type":"string","title":"Prop Account Id"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PropAccountSummary"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payments/{payment_id}":{"get":{"tags":["v2 payments"],"summary":"Retrieve a payment by id","operationId":"get_payment_v2_payments__payment_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"payment_id","in":"path","required":true,"schema":{"type":"string","title":"Payment Id"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Payment V2 Payments  Payment Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/connect/accounts":{"post":{"tags":["v2 connect"],"summary":"Create a Stripe Express account + onboarding link for the user","operationId":"create_account_v2_connect_accounts_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectAccountRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectAccountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 connect"],"summary":"List the user's Connect accounts","operationId":"list_accounts_v2_connect_accounts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ConnectAccountSummary"},"title":"Response List Accounts V2 Connect Accounts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/connect/accounts/{stripe_account_id}/onboarding-link":{"post":{"tags":["v2 connect"],"summary":"Refresh the onboarding link for an existing Connect account","operationId":"refresh_link_v2_connect_accounts__stripe_account_id__onboarding_link_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"stripe_account_id","in":"path","required":true,"schema":{"type":"string","title":"Stripe Account Id"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"string"},"title":"Response Refresh Link V2 Connect Accounts  Stripe Account Id  Onboarding Link Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payouts/request":{"post":{"tags":["v2 payouts"],"summary":"Request a payout (creates a pending row; admin/auto-submit triggers transfer)","operationId":"request_payout_v2_payouts_request_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestPayoutBody"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payouts/{payout_id}/submit":{"post":{"tags":["v2 payouts"],"summary":"Submit a pending payout to Stripe (admin / partner approval flow)","operationId":"submit_payout_v2_payouts__payout_id__submit_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"payout_id","in":"path","required":true,"schema":{"type":"string","title":"Payout Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payouts/estimate":{"get":{"tags":["v2 payouts"],"summary":"Estimated payout owed, computed from validator trading profit (read-only)","description":"Amount the trader has *earned* (HWM profit), not a user-entered request.\n\nDisbursement is a separate operator-driven step; this endpoint only reports\nwhat the validator says is owed for the user's subaccount.","operationId":"estimate_payout_v2_payouts_estimate_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutEstimateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/payouts":{"get":{"tags":["v2 payouts"],"summary":"List the user's payouts","operationId":"list_payouts_v2_payouts_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/PayoutResponse"},"title":"Response List Payouts V2 Payouts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/agreements/sign":{"post":{"tags":["v2 agreements"],"summary":"Sign an agreement (records audit row + sets user.agreement_signed)","operationId":"sign_v2_agreements_sign_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignAgreementRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/agreements/status":{"get":{"tags":["v2 agreements"],"summary":"Read the user's current agreement state","operationId":"status_v2_agreements_status_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgreementResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/agreements/audits":{"get":{"tags":["v2 agreements"],"summary":"List the user's signed agreements","operationId":"audits_v2_agreements_audits_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Audits V2 Agreements Audits Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/api-keys":{"post":{"tags":["v2 api keys"],"summary":"Mint a new API key","operationId":"create_key_v2_api_keys_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreatedResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 api keys"],"summary":"List the user's API keys","operationId":"list_keys_v2_api_keys_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ApiKeySummary"},"title":"Response List Keys V2 Api Keys Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/api-keys/{key_id}":{"delete":{"tags":["v2 api keys"],"summary":"Revoke an API key","operationId":"revoke_key_v2_api_keys__key_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Revoke Key V2 Api Keys  Key Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/lifecycle/sync/{prop_account_id}":{"post":{"tags":["v2 lifecycle"],"summary":"Sync a prop account's lifecycle status from the network","operationId":"sync_status_v2_lifecycle_sync__prop_account_id__post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"prop_account_id","in":"path","required":true,"schema":{"type":"string","title":"Prop Account Id"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LifecycleStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/notifications/send":{"post":{"tags":["v2 notifications"],"summary":"Send a notification (email + optional outbound webhook)","operationId":"send_v2_notifications_send_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendNotificationRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"integer"}]},"type":"object","title":"Response Send V2 Notifications Send Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/trading/orders":{"post":{"tags":["v2 trading"],"summary":"Submit an order on the authenticated user's subaccount","operationId":"submit_order_v2_trading_orders_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__trading__VantaSubmitOrderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 trading"],"summary":"Pending limit/stop orders for the user's prop account","operationId":"orders_v2_trading_orders_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Orders V2 Trading Orders Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/orders/close":{"post":{"tags":["v2 trading"],"summary":"Market-close one open position","operationId":"close_position_v2_trading_orders_close_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__trading__ClosePositionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/orders/bulk-close":{"post":{"tags":["v2 trading"],"summary":"Bulk-close multiple open positions (comma-joined position uuids)","operationId":"bulk_close_v2_trading_orders_bulk_close_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkClosePositionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/orders/tp-sl":{"post":{"tags":["v2 trading"],"summary":"Attach or replace TP/SL on a position","operationId":"set_tp_sl_v2_trading_orders_tp_sl_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/hyperscaled_api__v2__routers__trading__TpSlRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/orders/{order_uuid}/edit":{"post":{"tags":["v2 trading"],"summary":"Edit a resting order","operationId":"edit_order_v2_trading_orders__order_uuid__edit_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_uuid","in":"path","required":true,"schema":{"type":"string","title":"Order Uuid"}},{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditOrderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/orders/{order_uuid}":{"delete":{"tags":["v2 trading"],"summary":"Cancel a resting order","operationId":"cancel_order_v2_trading_orders__order_uuid__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_uuid","in":"path","required":true,"schema":{"type":"string","title":"Order Uuid"}},{"name":"trade_pair","in":"query","required":true,"schema":{"type":"string","title":"Trade Pair"}},{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrderResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["v2 trading"],"summary":"Look up an order's status","operationId":"order_status_v2_trading_orders__order_uuid__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"order_uuid","in":"path","required":true,"schema":{"type":"string","title":"Order Uuid"}},{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Order Status V2 Trading Orders  Order Uuid  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/positions":{"get":{"tags":["v2 trading"],"summary":"Open positions for the user's active prop account","operationId":"positions_v2_trading_positions_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response Positions V2 Trading Positions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/history":{"get":{"tags":["v2 trading"],"summary":"Closed positions (trade history)","operationId":"history_v2_trading_history_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response History V2 Trading History Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/balance":{"get":{"tags":["v2 trading"],"summary":"Account size & high-level balance metrics","operationId":"balance_v2_trading_balance_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Balance V2 Trading Balance Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/desk-poll":{"get":{"tags":["v2 trading"],"summary":"One-shot bundle for the trading terminal: positions + orders + history + balance","operationId":"desk_poll_v2_trading_desk_poll_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Desk Poll V2 Trading Desk Poll Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/trading/stream":{"get":{"tags":["v2 trading (realtime)"],"summary":"SSE stream of dashboard snapshots (positions/orders) every interval_ms","operationId":"stream_v2_trading_stream_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"interval_ms","in":"query","required":false,"schema":{"type":"integer","maximum":10000,"minimum":500,"default":2000,"title":"Interval Ms"}},{"name":"X-Prop-Account","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Prop-Account"}},{"name":"X-Session-Token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Session-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/webhooks/stripe":{"post":{"tags":["v2 webhooks (inbound)"],"summary":"Stripe webhook receiver","operationId":"stripe_webhook_v2_webhooks_stripe_post","parameters":[{"name":"Stripe-Signature","in":"header","required":true,"schema":{"type":"string","title":"Stripe-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Stripe Webhook V2 Webhooks Stripe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/webhooks/sumsub":{"post":{"tags":["v2 webhooks (inbound)"],"summary":"Sumsub webhook receiver","operationId":"sumsub_webhook_v2_webhooks_sumsub_post","parameters":[{"name":"x-payload-digest","in":"header","required":true,"schema":{"type":"string","title":"X-Payload-Digest"}},{"name":"x-payload-digest-alg","in":"header","required":false,"schema":{"type":"string","default":"HMAC_SHA256_HEX","title":"X-Payload-Digest-Alg"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Sumsub Webhook V2 Webhooks Sumsub Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/webhook-endpoints":{"get":{"tags":["v2 webhooks (outbound)"],"summary":"List registered endpoints","operationId":"list_endpoints_v2_webhook_endpoints_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndpointResponse"},"type":"array","title":"Response List Endpoints V2 Webhook Endpoints Get"}}}}},"security":[{"HTTPBearer":[]}]},"post":{"tags":["v2 webhooks (outbound)"],"summary":"Register a partner webhook URL","operationId":"create_endpoint_v2_webhook_endpoints_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEndpointRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndpointResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"HTTPBearer":[]}]}},"/v2/webhook-endpoints/{endpoint_id}":{"delete":{"tags":["v2 webhooks (outbound)"],"summary":"Delete (deactivate) an endpoint","operationId":"delete_endpoint_v2_webhook_endpoints__endpoint_id__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Endpoint Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{"type":"boolean"},"title":"Response Delete Endpoint V2 Webhook Endpoints  Endpoint Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v2/webhook-endpoints/{endpoint_id}/deliveries":{"get":{"tags":["v2 webhooks (outbound)"],"summary":"List recent delivery attempts for an endpoint","operationId":"list_deliveries_v2_webhook_endpoints__endpoint_id__deliveries_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"endpoint_id","in":"path","required":true,"schema":{"type":"string","title":"Endpoint Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeliveryResponse"},"title":"Response List Deliveries V2 Webhook Endpoints  Endpoint Id  Deliveries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/me":{"get":{"tags":["auth"],"summary":"Identify the authenticated partner","description":"Returns the `partner_id` for the supplied partner API key. Use it after Authorize to confirm your key works — a 200 with your id means success; a 401 means the key is unknown.","operationId":"me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Me V1 Me Get"}}}}},"security":[{"HTTPBearer":[]}]}},"/health":{"get":{"tags":["health"],"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}}},"components":{"schemas":{"AccountInfo":{"properties":{"status":{"type":"string","enum":["active","suspended","pending_kyc","breached"],"title":"Status"},"account_type":{"type":"string","enum":["challenge","funded"],"title":"Account Type","default":"funded"},"funded_account_size":{"type":"integer","title":"Funded Account Size"},"hl_wallet_address":{"type":"string","title":"Hl Wallet Address"},"payout_wallet_address":{"type":"string","title":"Payout Wallet Address"},"entity_miner":{"type":"string","title":"Entity Miner"},"current_drawdown":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Current Drawdown"},"max_drawdown_limit":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Max Drawdown Limit"},"eod_drawdown":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Eod Drawdown","default":"0"},"eod_drawdown_limit":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Eod Drawdown Limit","default":"0"},"total_realized_pnl":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Total Realized Pnl","default":"0"},"current_equity_ratio":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Current Equity Ratio","default":"1"},"account_balance":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Account Balance","default":"0"},"current_leverage":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Current Leverage","default":"0"},"max_portfolio_leverage":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Max Portfolio Leverage","default":"0"},"leverage_limits":{"$ref":"#/components/schemas/LeverageLimits"},"hl_balance":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Hl Balance"},"funded_balance":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Funded Balance"},"kyc_status":{"type":"string","enum":["not_started","pending","verified"],"title":"Kyc Status"}},"type":"object","required":["status","funded_account_size","hl_wallet_address","payout_wallet_address","entity_miner","current_drawdown","max_drawdown_limit","leverage_limits","hl_balance","funded_balance","kyc_status"],"title":"AccountInfo","description":"Full status and configuration for a funded account."},"AdminLoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"totp_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Totp Code"}},"type":"object","required":["email","password"],"title":"AdminLoginRequest"},"AdminLoginResponse":{"properties":{"admin_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Admin Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"},"session_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session Expires At"},"mfa_required":{"type":"boolean","title":"Mfa Required","default":false},"totp_enrolled":{"type":"boolean","title":"Totp Enrolled","default":false}},"type":"object","title":"AdminLoginResponse"},"AdminMeResponse":{"properties":{"admin_id":{"type":"string","title":"Admin Id"},"email":{"type":"string","title":"Email"},"is_superadmin":{"type":"boolean","title":"Is Superadmin"}},"type":"object","required":["admin_id","email","is_superadmin"],"title":"AdminMeResponse"},"AgreementResponse":{"properties":{"signed":{"type":"boolean","title":"Signed"},"signed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Signed At"},"agreement_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Agreement Version"}},"type":"object","required":["signed"],"title":"AgreementResponse"},"ApiKeyCreatedResponse":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"key_id":{"type":"string","title":"Key Id"},"key_secret":{"type":"string","title":"Key Secret","description":"Returned ONCE; partner must store it."},"prop_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prop Account Id"}},"type":"object","required":["id","label","key_id","key_secret"],"title":"ApiKeyCreatedResponse"},"ApiKeySummary":{"properties":{"id":{"type":"string","title":"Id"},"label":{"type":"string","title":"Label"},"key_id":{"type":"string","title":"Key Id"},"prop_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prop Account Id"},"last_used_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Used At"},"revoked_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Revoked At"}},"type":"object","required":["id","label","key_id"],"title":"ApiKeySummary"},"AppSummary":{"properties":{"app_id":{"type":"string","title":"App Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"entity_hotkey":{"type":"string","title":"Entity Hotkey"},"allowed_scopes":{"items":{"type":"string"},"type":"array","title":"Allowed Scopes"},"active":{"type":"boolean","title":"Active"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["app_id","slug","name","entity_hotkey","allowed_scopes","active","created_at"],"title":"AppSummary"},"BalanceStatus":{"properties":{"balance":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Balance"},"meets_minimum":{"type":"boolean","title":"Meets Minimum"},"minimum_required":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Minimum Required","default":"0.01"}},"type":"object","required":["balance","meets_minimum"],"title":"BalanceStatus","description":"Result of a Hyperliquid wallet balance check."},"Body_issue_token_v2_oauth_token_post":{"properties":{"grant_type":{"type":"string","title":"Grant Type"},"client_id":{"type":"string","title":"Client Id"},"client_secret":{"type":"string","title":"Client Secret"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"}},"type":"object","required":["grant_type","client_id","client_secret"],"title":"Body_issue_token_v2_oauth_token_post"},"BulkClosePositionsRequest":{"properties":{"position_uuids":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Position Uuids"}},"type":"object","required":["position_uuids"],"title":"BulkClosePositionsRequest"},"CancelResult":{"properties":{"detail":{"additionalProperties":true,"type":"object","title":"Detail"}},"type":"object","required":["detail"],"title":"CancelResult","description":"Result envelope for cancel operations — the SDK returns a raw dict."},"ClosedPosition":{"properties":{"symbol":{"type":"string","title":"Symbol"},"side":{"type":"string","enum":["long","short"],"title":"Side"},"size":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Size"},"position_value":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Position Value"},"entry_price":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Entry Price"},"mark_price":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Mark Price"},"liquidation_price":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Liquidation Price"},"unrealized_pnl":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unrealized Pnl"},"take_profit":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Stop Loss"},"open_time":{"type":"string","format":"date-time","title":"Open Time"},"realized_pnl":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Realized Pnl"},"close_time":{"type":"string","format":"date-time","title":"Close Time"}},"type":"object","required":["symbol","side","size","position_value","entry_price","unrealized_pnl","open_time","realized_pnl","close_time"],"title":"ClosedPosition","description":"A position that has been closed, with realized PnL."},"ConnectAccountResponse":{"properties":{"id":{"type":"string","title":"Id"},"stripe_account_id":{"type":"string","title":"Stripe Account Id"},"onboarding_url":{"type":"string","title":"Onboarding Url"},"status":{"type":"string","title":"Status"},"payouts_enabled":{"type":"boolean","title":"Payouts Enabled"},"charges_enabled":{"type":"boolean","title":"Charges Enabled"},"details_submitted":{"type":"boolean","title":"Details Submitted"},"bank_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bank Name"},"last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last4"}},"type":"object","required":["id","stripe_account_id","onboarding_url","status","payouts_enabled","charges_enabled","details_submitted"],"title":"ConnectAccountResponse"},"ConnectAccountSummary":{"properties":{"id":{"type":"string","title":"Id"},"stripe_account_id":{"type":"string","title":"Stripe Account Id"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"},"payouts_enabled":{"type":"boolean","title":"Payouts Enabled"},"charges_enabled":{"type":"boolean","title":"Charges Enabled"},"details_submitted":{"type":"boolean","title":"Details Submitted"},"bank_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bank Name"},"last4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last4"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"}},"type":"object","required":["id","stripe_account_id","status","payouts_enabled","charges_enabled","details_submitted"],"title":"ConnectAccountSummary"},"CreateApiKeyRequest":{"properties":{"label":{"type":"string","maxLength":255,"title":"Label"},"prop_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prop Account Id"}},"type":"object","required":["label"],"title":"CreateApiKeyRequest"},"CreateConnectAccountRequest":{"properties":{"country":{"type":"string","title":"Country","default":"US"}},"type":"object","title":"CreateConnectAccountRequest"},"CreateEndpointRequest":{"properties":{"url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"}},"type":"object","required":["url","events"],"title":"CreateEndpointRequest"},"CreatePaymentRequest":{"properties":{"tier_id":{"type":"string","title":"Tier Id"},"market":{"type":"string","enum":["crypto","forex","equities","commodities","all_markets"],"title":"Market"},"asset_class":{"type":"string","enum":["crypto","forex","equities","commodities","all_markets"],"title":"Asset Class"},"account_size":{"type":"number","exclusiveMinimum":0.0,"title":"Account Size"},"amount_cents":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount Cents"},"currency":{"type":"string","title":"Currency","default":"usd"},"coupon_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coupon Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["tier_id","market","asset_class","account_size","amount_cents"],"title":"CreatePaymentRequest"},"CreatedAppRequestResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"status":{"type":"string","title":"Status","default":"pending"},"message":{"type":"string","title":"Message","default":"Request received. We'll email you once it's reviewed."}},"type":"object","required":["request_id"],"title":"CreatedAppRequestResponse"},"CreatedAppResponse":{"properties":{"app_id":{"type":"string","title":"App Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"entity_hotkey":{"type":"string","title":"Entity Hotkey"},"client_id":{"type":"string","title":"Client Id"},"client_secret":{"type":"string","title":"Client Secret"},"note":{"type":"string","title":"Note","default":"Store client_secret now — it cannot be retrieved later."}},"type":"object","required":["app_id","slug","name","entity_hotkey","client_id","client_secret"],"title":"CreatedAppResponse"},"DeliveryResponse":{"properties":{"id":{"type":"string","title":"Id"},"endpoint_id":{"type":"string","title":"Endpoint Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","title":"Status"},"attempts":{"type":"integer","title":"Attempts"},"response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Status"},"last_attempt_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Attempt At"}},"type":"object","required":["id","endpoint_id","event_type","status","attempts"],"title":"DeliveryResponse"},"EditOrderRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair"},"order_type":{"type":"string","enum":["LONG","SHORT","FLAT"],"title":"Order Type"},"leverage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Leverage"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity"},"limit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Limit Price"},"stop_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Price"},"stop_condition":{"anyOf":[{"type":"string","enum":["GTE","LTE"]},{"type":"null"}],"title":"Stop Condition"},"take_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"},"bracket_orders":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Bracket Orders"}},"type":"object","required":["trade_pair","order_type"],"title":"EditOrderRequest"},"EndpointResponse":{"properties":{"id":{"type":"string","title":"Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"active":{"type":"boolean","title":"Active"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret"}},"type":"object","required":["id","url","events","active"],"title":"EndpointResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KycStatus":{"properties":{"user_id":{"type":"string","title":"User Id"},"kyc_provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyc Provider"},"kyc_status":{"type":"string","enum":["unverified","processing","needs_input","verified","failed"],"title":"Kyc Status"},"kyc_verified_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Kyc Verified At"},"kyc_failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kyc Failure Reason"}},"type":"object","required":["user_id","kyc_provider","kyc_status"],"title":"KycStatus"},"LeverageLimits":{"properties":{"account_level":{"type":"number","title":"Account Level"},"position_level":{"additionalProperties":{"type":"number"},"type":"object","title":"Position Level"},"max_position_per_pair_usd":{"type":"number","title":"Max Position Per Pair Usd","default":0.0},"max_portfolio_usd":{"type":"number","title":"Max Portfolio Usd","default":0.0},"pair_limit_ratio":{"type":"number","title":"Pair Limit Ratio","default":0.0},"portfolio_limit_ratio":{"type":"number","title":"Portfolio Limit Ratio","default":0.0}},"type":"object","required":["account_level","position_level"],"title":"LeverageLimits","description":"Leverage constraints at the account and per-pair level."},"LifecycleStatus":{"properties":{"prop_account_id":{"type":"string","title":"Prop Account Id"},"status":{"type":"string","title":"Status"},"subaccount_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Subaccount Id"},"synthetic_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Synthetic Hotkey"}},"type":"object","required":["prop_account_id","status"],"title":"LifecycleStatus"},"LoginRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","title":"Password"},"totp_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Totp Code"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"LoginResponse":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"},"session_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session Expires At"},"mfa_required":{"type":"boolean","title":"Mfa Required","default":false}},"type":"object","title":"LoginResponse"},"LogoutResponse":{"properties":{"revoked":{"type":"boolean","title":"Revoked"}},"type":"object","required":["revoked"],"title":"LogoutResponse"},"Order":{"properties":{"hl_order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hl Order Id"},"order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Id"},"pair":{"type":"string","title":"Pair"},"side":{"type":"string","enum":["long","short"],"title":"Side"},"size":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Size"},"filled_size":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Filled Size"},"weight":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Weight"},"order_type":{"type":"string","enum":["market","limit"],"title":"Order Type"},"status":{"type":"string","enum":["filled","partial","pending","cancelled","open"],"title":"Status"},"fill_price":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Fill Price"},"limit_price":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Limit Price"},"take_profit":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"},"tp_order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tp Order Id"},"sl_order_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sl Order Id"},"trigger_status":{"type":"string","enum":["not_requested","pending_parent_fill","placed","partial_failure","failed"],"title":"Trigger Status","default":"not_requested"},"trigger_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Trigger Error"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["pair","side","order_type","status","created_at"],"title":"Order","description":"A trade order placed or read through the Hyperscaled SDK.\n\nSupports both the write path (trade submission, where ``hl_order_id`` and\n``weight`` are populated) and the read path (portfolio queries,\nwhere ``order_id`` and ``limit_price`` are populated instead)."},"OrderResult":{"properties":{"success":{"type":"boolean","title":"Success"},"order_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Uuid"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"processing_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Processing Time"}},"type":"object","required":["success"],"title":"OrderResult"},"PasswordResetConfirm":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"token":{"type":"string","title":"Token"},"new_password":{"type":"string","maxLength":128,"minLength":8,"title":"New Password"}},"type":"object","required":["email","token","new_password"],"title":"PasswordResetConfirm"},"PasswordResetRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"PasswordResetRequest"},"PaymentResponse":{"properties":{"payment_id":{"type":"string","title":"Payment Id"},"stripe_payment_intent_id":{"type":"string","title":"Stripe Payment Intent Id"},"client_secret":{"type":"string","title":"Client Secret"},"amount_cents":{"type":"integer","title":"Amount Cents"},"currency":{"type":"string","title":"Currency"},"status":{"type":"string","title":"Status"}},"type":"object","required":["payment_id","stripe_payment_intent_id","client_secret","amount_cents","currency","status"],"title":"PaymentResponse"},"Payout":{"properties":{"date":{"type":"string","format":"date-time","title":"Date"},"amount":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Amount"},"token":{"type":"string","title":"Token"},"network":{"type":"string","title":"Network"},"tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Hash"},"status":{"type":"string","enum":["completed","pending","processing","failed"],"title":"Status"}},"type":"object","required":["date","amount","token","network","status"],"title":"Payout","description":"A payout record from a funded account."},"PayoutEstimateResponse":{"properties":{"amount_usd":{"type":"number","title":"Amount Usd"},"amount_cents":{"type":"integer","title":"Amount Cents"},"currency":{"type":"string","title":"Currency","default":"usd"},"available":{"type":"boolean","title":"Available"}},"type":"object","required":["amount_usd","amount_cents","available"],"title":"PayoutEstimateResponse"},"PayoutResponse":{"properties":{"id":{"type":"string","title":"Id"},"amount_cents":{"type":"integer","title":"Amount Cents"},"currency":{"type":"string","title":"Currency"},"status":{"type":"string","title":"Status"},"stripe_transfer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Transfer Id"},"failure_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Reason"},"requested_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Requested At"},"completed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Completed At"}},"type":"object","required":["id","amount_cents","currency","status"],"title":"PayoutResponse"},"Position":{"properties":{"symbol":{"type":"string","title":"Symbol"},"side":{"type":"string","enum":["long","short"],"title":"Side"},"size":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Size"},"position_value":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Position Value"},"entry_price":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Entry Price"},"mark_price":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Mark Price"},"liquidation_price":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Liquidation Price"},"unrealized_pnl":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Unrealized Pnl"},"take_profit":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Stop Loss"},"open_time":{"type":"string","format":"date-time","title":"Open Time"}},"type":"object","required":["symbol","side","size","position_value","entry_price","unrealized_pnl","open_time"],"title":"Position","description":"An open position on a funded account."},"PropAccountSummary":{"properties":{"id":{"type":"string","title":"Id"},"tier_id":{"type":"string","title":"Tier Id"},"asset_class":{"type":"string","title":"Asset Class"},"account_size":{"type":"number","title":"Account Size"},"status":{"type":"string","title":"Status"},"subaccount_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Subaccount Id"},"subaccount_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subaccount Uuid"},"synthetic_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Synthetic Hotkey"},"stripe_payment_intent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stripe Payment Intent Id"}},"type":"object","required":["id","tier_id","asset_class","account_size","status"],"title":"PropAccountSummary"},"PurchaseRequest":{"properties":{"miner_slug":{"type":"string","title":"Miner Slug","description":"Entity miner slug, e.g. 'vanta'."},"account_size":{"type":"integer","exclusiveMinimum":0.0,"title":"Account Size","description":"Account size in USD."},"hl_wallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","title":"Hl Wallet","description":"HL wallet that will receive the funded account."},"payout_wallet":{"anyOf":[{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},{"type":"null"}],"title":"Payout Wallet"},"email":{"type":"string","format":"email","title":"Email","description":"Email for registration receipts."},"base_private_key":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","title":"Base Private Key","description":"Base EVM private key used to sign the x402 USDC payment. v1 is partner-supplied; server-side signer is a future config."}},"type":"object","required":["miner_slug","account_size","hl_wallet","email","base_private_key"],"title":"PurchaseRequest"},"RegistrationStatus":{"properties":{"status":{"type":"string","title":"Status"},"hl_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hl Address"},"registration_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Id"},"funded_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Funded Account Id"},"account_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Account Size"},"estimated_time":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Estimated Time"},"tx_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tx Hash"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["status"],"title":"RegistrationStatus","description":"Status of a funded-account registration.\n\nUsed both for purchase results (SDK-008) and status polling (SDK-009).\nThe status endpoint returns ``{\"status\": ..., \"hl_address\": ...}``\nso fields like ``account_size`` are optional."},"RequestPayoutBody":{"properties":{"amount_cents":{"type":"integer","exclusiveMinimum":0.0,"title":"Amount Cents"},"prop_account_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prop Account Id"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["amount_cents"],"title":"RequestPayoutBody"},"ResendOtpRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"}},"type":"object","required":["email"],"title":"ResendOtpRequest"},"RevokeSessionRequest":{"properties":{"session_token":{"type":"string","title":"Session Token"}},"type":"object","required":["session_token"],"title":"RevokeSessionRequest"},"RotateSecretResponse":{"properties":{"client_secret":{"type":"string","title":"Client Secret"}},"type":"object","required":["client_secret"],"title":"RotateSecretResponse"},"Rule":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"category":{"type":"string","enum":["leverage","pairs","drawdown","exposure","order_frequency","payout"],"title":"Category"},"description":{"type":"string","title":"Description"},"current_value":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Value"},"limit":{"type":"string","title":"Limit"},"applies_to":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applies To"}},"type":"object","required":["rule_id","category","description","limit"],"title":"Rule","description":"A Vanta Network rule that governs funded-account behavior."},"RuleViolation":{"properties":{"rule":{"$ref":"#/components/schemas/Rule"},"actual_value":{"type":"string","title":"Actual Value"},"message":{"type":"string","title":"Message"}},"type":"object","required":["rule","actual_value","message"],"title":"RuleViolation","description":"A specific violation of a Vanta Network rule."},"SendNotificationRequest":{"properties":{"user_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Id"},"email":{"anyOf":[{"type":"string","format":"email"},{"type":"null"}],"title":"Email"},"subject":{"type":"string","title":"Subject"},"html":{"type":"string","title":"Html"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"fanout_event":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fanout Event"},"payload":{"additionalProperties":true,"type":"object","title":"Payload","default":{}}},"type":"object","required":["subject","html"],"title":"SendNotificationRequest"},"SessionEnrollRequest":{"properties":{"hl_wallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","title":"Hl Wallet","description":"Trader's Hyperliquid wallet address (0x + 40 hex chars)."},"hl_private_key":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","title":"Hl Private Key","description":"HL agent wallet private key (0x + 64 hex chars)."},"payout_wallet":{"anyOf":[{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},{"type":"null"}],"title":"Payout Wallet","description":"Optional payout wallet address."},"ttl_seconds":{"anyOf":[{"type":"integer","exclusiveMinimum":0.0},{"type":"null"}],"title":"Ttl Seconds","description":"Optional auto-expiry. Default is no expiry."}},"type":"object","required":["hl_wallet","hl_private_key"],"title":"SessionEnrollRequest","description":"Partner-supplied credentials for one trader.\n\n``hl_private_key`` must be a Hyperliquid **agent (API) wallet key** —\none that can trade but cannot withdraw funds. Using the master wallet\nkey here multiplies blast radius on leak."},"SessionInfo":{"properties":{"hl_wallet":{"type":"string","title":"Hl Wallet"},"payout_wallet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Payout Wallet"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Expires At"}},"type":"object","required":["hl_wallet","created_at"],"title":"SessionInfo","description":"Safe-to-return-over-the-wire view of a session.\n\nNever includes ``hl_private_key``. Used as ``response_model`` on the\nenrollment endpoints so the OpenAPI spec advertises the exact shape."},"SignAgreementRequest":{"properties":{"agreement_version":{"type":"string","title":"Agreement Version","description":"Document version the user is signing."},"signature_name":{"type":"string","title":"Signature Name","description":"Typed legal name."},"document_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Url"},"document_sha256":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Sha256"}},"type":"object","required":["agreement_version","signature_name"],"title":"SignAgreementRequest"},"SignupRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"password":{"type":"string","maxLength":128,"minLength":8,"title":"Password"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["email","password"],"title":"SignupRequest"},"SignupResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"email_verified":{"type":"boolean","title":"Email Verified"},"otp_sent":{"type":"boolean","title":"Otp Sent"}},"type":"object","required":["user_id","email","email_verified","otp_sent"],"title":"SignupResponse"},"SpotBalance":{"properties":{"available_spot_usdc":{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","title":"Available Spot Usdc"}},"type":"object","required":["available_spot_usdc"],"title":"SpotBalance","description":"Free spot USDC available to the trader (total minus held as perp margin)."},"StripeIdentitySessionResponse":{"properties":{"client_secret":{"type":"string","title":"Client Secret"},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url"},"session_id":{"type":"string","title":"Session Id"}},"type":"object","required":["client_secret","session_id"],"title":"StripeIdentitySessionResponse"},"SubmitOrderRequest":{"properties":{"pair":{"type":"string","title":"Pair","description":"Trading pair, e.g. BTC-USDC"},"side":{"type":"string","enum":["long","short"],"title":"Side"},"size":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Size","description":"Coin quantity, or USD notional if size_in_usd=true"},"order_type":{"type":"string","enum":["market","limit"],"title":"Order Type"},"price":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Price","description":"Required for limit orders"},"take_profit":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Stop Loss"},"size_in_usd":{"type":"boolean","title":"Size In Usd","description":"If true, `size` is a USD notional and is converted via the HL mid price.","default":false},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop","description":"Trailing-stop config; exactly one of `trailing_percent` (0,1) or `trailing_value` (positive)."},"leverage":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Leverage"},"is_cross":{"type":"boolean","title":"Is Cross","default":true}},"type":"object","required":["pair","side","size","order_type"],"title":"SubmitOrderRequest"},"SumsubTokenResponse":{"properties":{"token":{"type":"string","title":"Token"},"user_id":{"type":"string","title":"User Id"},"level_name":{"type":"string","title":"Level Name"},"applicant_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Applicant Id"}},"type":"object","required":["token","user_id","level_name"],"title":"SumsubTokenResponse"},"SupportedPairs":{"properties":{"pairs":{"items":{"type":"string"},"type":"array","title":"Pairs"}},"type":"object","required":["pairs"],"title":"SupportedPairs"},"TokenResponse":{"properties":{"access_token":{"type":"string","title":"Access Token"},"token_type":{"type":"string","title":"Token Type","default":"Bearer"},"expires_in":{"type":"integer","title":"Expires In"},"scope":{"type":"string","title":"Scope"}},"type":"object","required":["access_token","expires_in","scope"],"title":"TokenResponse"},"TotpConfirmResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"}},"type":"object","required":["enabled"],"title":"TotpConfirmResponse"},"TotpEnrollRequest":{"properties":{},"type":"object","title":"TotpEnrollRequest"},"TotpEnrollResponse":{"properties":{"secret":{"type":"string","title":"Secret"},"otpauth_uri":{"type":"string","title":"Otpauth Uri"}},"type":"object","required":["secret","otpauth_uri"],"title":"TotpEnrollResponse"},"TpSlResult":{"properties":{"detail":{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object","title":"Detail"}},"type":"object","required":["detail"],"title":"TpSlResult","description":"Result envelope for set_tp_sl — the SDK returns a dict of trigger order IDs."},"TradeValidation":{"properties":{"valid":{"type":"boolean","title":"Valid"},"violations":{"items":{"$ref":"#/components/schemas/RuleViolation"},"type":"array","title":"Violations"}},"type":"object","required":["valid","violations"],"title":"TradeValidation","description":"Result of validating a trade against all applicable rules."},"ValidateTradeRequest":{"properties":{"pair":{"type":"string","title":"Pair","description":"Trading pair, e.g. BTC-USDC"},"side":{"type":"string","enum":["long","short"],"title":"Side"},"size":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"}],"title":"Size","description":"Coin quantity, or USD if your check assumes USD."},"order_type":{"type":"string","enum":["market","limit"],"title":"Order Type"},"price":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Price","description":"Required for limit orders."}},"type":"object","required":["pair","side","size","order_type"],"title":"ValidateTradeRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VantaClosePositionRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair","description":"Network pair whose open position to flatten."}},"type":"object","required":["trade_pair"],"title":"VantaClosePositionRequest"},"VantaEditOrderRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair","description":"Network pair, e.g. BTC/USD"},"order_type":{"type":"string","enum":["LONG","SHORT","FLAT"],"title":"Order Type"},"leverage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Leverage","description":"At most one of leverage/value/quantity."},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","description":"USD notional value."},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity","description":"Base-currency units."},"limit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Limit Price","description":"New limit price."},"stop_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Price"},"stop_condition":{"anyOf":[{"type":"string","enum":["GTE","LTE"]},{"type":"null"}],"title":"Stop Condition"},"take_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"},"bracket_orders":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Bracket Orders"}},"type":"object","required":["trade_pair","order_type"],"title":"VantaEditOrderRequest","description":"Edit a resting order (execution_type=LIMIT_EDIT). The target is the path's\n``order_uuid``; fields carry the new values."},"VantaOrderResult":{"properties":{"success":{"type":"boolean","title":"Success"},"order_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Uuid"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"processing_time":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Processing Time"}},"type":"object","required":["success"],"title":"VantaOrderResult","description":"The entity miner's order-submission result (sanitized)."},"VantaOrderStatus":{"properties":{"order_uuid":{"type":"string","title":"Order Uuid"},"status":{"type":"string","title":"Status"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["order_uuid","status"],"title":"VantaOrderStatus"},"VantaRegisterRequest":{"properties":{"account_size":{"type":"number","exclusiveMinimum":0.0,"title":"Account Size","description":"Account size in USD."},"asset_class":{"anyOf":[{"type":"string","enum":["crypto","forex","equities","commodities","all_markets"]},{"type":"null"}],"title":"Asset Class","description":"Market scope for a standard subaccount. Required unless `hl_address` is given (which creates an HL-linked subaccount spanning all markets)."},"hl_address":{"anyOf":[{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},{"type":"null"}],"title":"Hl Address","description":"If set, creates an HL-linked subaccount whose Hyperliquid trades are mirrored as Vanta signals. Mutually exclusive with `asset_class`."},"payout_address":{"anyOf":[{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"},{"type":"null"}],"title":"Payout Address","description":"EVM address for USDC payouts. Only valid for HL-linked subaccounts."},"admin":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Admin","description":"Create as an admin subaccount."}},"type":"object","required":["account_size"],"title":"VantaRegisterRequest"},"VantaRegisterResult":{"properties":{"subaccount":{"anyOf":[{"$ref":"#/components/schemas/VantaSubaccount"},{"type":"null"}]},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","title":"VantaRegisterResult"},"VantaSubaccount":{"properties":{"subaccount_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Subaccount Id"},"subaccount_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Subaccount Uuid"},"synthetic_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Synthetic Hotkey"},"asset_class":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Asset Class"},"account_size":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Account Size"}},"type":"object","title":"VantaSubaccount"},"VantaTpSlRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair","description":"Pair whose open position to attach TP/SL to."},"take_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"},"bracket_orders":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Bracket Orders"}},"type":"object","required":["trade_pair"],"title":"VantaTpSlRequest"},"VerifyEmailRequest":{"properties":{"email":{"type":"string","format":"email","title":"Email"},"code":{"type":"string","maxLength":12,"minLength":4,"title":"Code"}},"type":"object","required":["email","code"],"title":"VerifyEmailRequest"},"VerifyEmailResponse":{"properties":{"user_id":{"type":"string","title":"User Id"},"email":{"type":"string","title":"Email"},"email_verified":{"type":"boolean","title":"Email Verified"},"session_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Token"},"session_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session Expires At"}},"type":"object","required":["user_id","email","email_verified"],"title":"VerifyEmailResponse"},"ZeroAmountRequest":{"properties":{"tier_id":{"type":"string","title":"Tier Id"},"asset_class":{"type":"string","enum":["crypto","forex","equities","commodities","all_markets"],"title":"Asset Class"},"account_size":{"type":"number","exclusiveMinimum":0.0,"title":"Account Size"},"metadata":{"additionalProperties":true,"type":"object","title":"Metadata"}},"type":"object","required":["tier_id","asset_class","account_size"],"title":"ZeroAmountRequest"},"hyperscaled_api__routers__orders__ClosePositionRequest":{"properties":{"pair":{"type":"string","title":"Pair","description":"Pair whose open position to fully close."}},"type":"object","required":["pair"],"title":"ClosePositionRequest"},"hyperscaled_api__routers__orders__TpSlRequest":{"properties":{"pair":{"type":"string","title":"Pair","description":"Pair whose open position to attach TP/SL to."},"take_profit":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"string","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"}},"type":"object","required":["pair"],"title":"TpSlRequest"},"hyperscaled_api__routers__orders__VantaSubmitOrderRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair","description":"Network pair, e.g. BTC/USD"},"order_type":{"type":"string","enum":["LONG","SHORT","FLAT"],"title":"Order Type"},"leverage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Leverage","description":"Account-size multiplier. At most one of leverage/value/quantity."},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value","description":"USD notional value."},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity","description":"Base-currency units."},"execution_type":{"type":"string","enum":["MARKET","LIMIT","STOP_LIMIT","BRACKET","LIMIT_CANCEL","LIMIT_EDIT","FLAT_ALL"],"title":"Execution Type","default":"MARKET"},"limit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Limit Price","description":"Required for LIMIT/STOP_LIMIT."},"stop_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Price","description":"Required for STOP_LIMIT."},"stop_condition":{"anyOf":[{"type":"string","enum":["GTE","LTE"]},{"type":"null"}],"title":"Stop Condition"},"take_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"},"bracket_orders":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Bracket Orders"},"order_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Uuid","description":"Client order id. Reused for LIMIT_CANCEL/LIMIT_EDIT/FLAT_ALL."}},"type":"object","required":["trade_pair","order_type"],"title":"VantaSubmitOrderRequest"},"hyperscaled_api__v2__routers__admin_apps__CreateAppRequest":{"properties":{"name":{"type":"string","maxLength":255,"minLength":1,"title":"Name"},"slug":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9][a-z0-9-]*$","title":"Slug"},"entity_hotkey":{"type":"string","maxLength":128,"minLength":1,"title":"Entity Hotkey"},"network_api_key":{"type":"string","minLength":1,"title":"Network Api Key"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"}},"type":"object","required":["name","slug","entity_hotkey","network_api_key"],"title":"CreateAppRequest"},"hyperscaled_api__v2__routers__admin_auth__TotpConfirmRequest":{"properties":{"code":{"type":"string","maxLength":8,"minLength":6,"title":"Code"}},"type":"object","required":["code"],"title":"TotpConfirmRequest"},"hyperscaled_api__v2__routers__app_requests__CreateAppRequest":{"properties":{"company_name":{"type":"string","maxLength":255,"minLength":1,"title":"Company Name"},"slug":{"type":"string","maxLength":64,"minLength":1,"pattern":"^[a-z0-9][a-z0-9-]*$","title":"Slug"},"contact_email":{"type":"string","format":"email","title":"Contact Email"},"contact_name":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Contact Name"},"website":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}],"title":"Website"},"use_case":{"anyOf":[{"type":"string","maxLength":4000},{"type":"null"}],"title":"Use Case"}},"type":"object","required":["company_name","slug","contact_email"],"title":"CreateAppRequest"},"hyperscaled_api__v2__routers__apps__AppMeResponse":{"properties":{"app_id":{"type":"string","title":"App Id"},"slug":{"type":"string","title":"Slug"},"name":{"type":"string","title":"Name"},"entity_hotkey":{"type":"string","title":"Entity Hotkey"},"allowed_scopes":{"items":{"type":"string"},"type":"array","title":"Allowed Scopes"},"active":{"type":"boolean","title":"Active"}},"type":"object","required":["app_id","slug","name","entity_hotkey","allowed_scopes","active"],"title":"AppMeResponse"},"hyperscaled_api__v2__routers__auth__TotpConfirmRequest":{"properties":{"code":{"type":"string","title":"Code"}},"type":"object","required":["code"],"title":"TotpConfirmRequest"},"hyperscaled_api__v2__routers__oauth__AppMeResponse":{"properties":{"app_id":{"type":"string","title":"App Id"},"slug":{"type":"string","title":"Slug"},"entity_hotkey":{"type":"string","title":"Entity Hotkey"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"}},"type":"object","required":["app_id","slug","entity_hotkey","scopes"],"title":"AppMeResponse"},"hyperscaled_api__v2__routers__trading__ClosePositionRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair"}},"type":"object","required":["trade_pair"],"title":"ClosePositionRequest"},"hyperscaled_api__v2__routers__trading__TpSlRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair"},"take_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"},"bracket_orders":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Bracket Orders"}},"type":"object","required":["trade_pair"],"title":"TpSlRequest"},"hyperscaled_api__v2__routers__trading__VantaSubmitOrderRequest":{"properties":{"trade_pair":{"type":"string","title":"Trade Pair"},"order_type":{"type":"string","enum":["LONG","SHORT","FLAT"],"title":"Order Type"},"leverage":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Leverage"},"value":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Value"},"quantity":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Quantity"},"execution_type":{"type":"string","enum":["MARKET","LIMIT","STOP_LIMIT","BRACKET","LIMIT_CANCEL","LIMIT_EDIT","FLAT_ALL"],"title":"Execution Type","default":"MARKET"},"limit_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Limit Price"},"stop_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Price"},"stop_condition":{"anyOf":[{"type":"string","enum":["GTE","LTE"]},{"type":"null"}],"title":"Stop Condition"},"take_profit":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Take Profit"},"stop_loss":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Stop Loss"},"trailing_stop":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trailing Stop"},"bracket_orders":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Bracket Orders"},"order_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Order Uuid"}},"type":"object","required":["trade_pair","order_type"],"title":"VantaSubmitOrderRequest"}},"securitySchemes":{"HTTPBearer":{"type":"http","description":"Partner API key issued by Hyperscaled. Send as `Authorization: Bearer <key>`.","scheme":"bearer"}}},"tags":[{"name":"sessions","description":"Enroll a trader's signing credentials for Hyperliquid writes."},{"name":"balance","description":"Account, spot, and Hyperliquid balances."},{"name":"positions","description":"Open positions — `/hyperscaled` (Hyperliquid) and `/vanta` (network)."},{"name":"orders","description":"Submit and manage orders. `/hyperscaled/*` is Hyperliquid via the SDK (one SDK method per endpoint); `/vanta/*` is network-direct via the entity miner (every variant submits to one upstream route with a different `execution_type`)."},{"name":"history","description":"Historical orders and positions."},{"name":"register","description":"Provision funded accounts. `POST /v1/register/hyperscaled` runs the Hyperliquid x402 purchase flow; `POST /v1/register/vanta` creates a Vanta subaccount via the entity miner."},{"name":"rules","description":"Validate orders against trading rules before submission."},{"name":"payouts","description":"Payout history and configuration."},{"name":"auth","description":"Identity check — confirm a partner key resolves and see its partner_id."},{"name":"health","description":"Liveness probe."}]}