Scoped API key (ttk_...), created in the Totalis app or by a wallet-session user through the API keys routes with a fresh wallet signature; those routes never accept a key. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires. Send no Origin.
Scopes
funding:withdraw
sponsorship:use
Headers
Idempotency-Key
string<uuid>
required
Lowercase UUIDv7 naming this command, unique per caller and route. A retry with the same key and body returns the original result; the same key with a different body returns 409 IDEMPOTENCY_KEY_REUSED.
The whole withdrawal in one request: pay amount from the embedded wallet to destination, topping the wallet up from the vault first when it cannot cover the amount. The owner signs the vault Exit for the shortfall and the USDC payout together; Totalis relays both, in order, and pays the gas.
destination
string
required
External address that receives the USDC.
Pattern: ^0x[0-9a-f]{40}$
amount
string<uint128-decimal>
required
Total amount to send, in atomic USDC (6 decimals); must be greater than zero.
Maximum string length: 39
Pattern: ^(0|[1-9][0-9]*)$
payout_authorization
object
required
The embedded wallet's USDC EIP-3009 TransferWithAuthorization of exactly amount to destination. Its nonce is not sent: sign keccak256(abi.encode(keccak256("TOTALIS_PAYOUT_NONCE_V1"), chainId, vault, account, uint128(Idempotency-Key))), where account is the embedded wallet and Idempotency-Key is this request's key read as 16 bytes. The signature is therefore bound to this request and cannot start a second withdrawal. Choose the Idempotency-Key before you sign.
Show child attributes
vault_withdrawal
object
Signed Exit moving the exact shortfall (amount minus spendable wallet USDC) from the vault back to the embedded wallet. Required when there is a shortfall and forbidden when there is none; a mismatch returns 409 STATE_CONFLICT with retry REFRESH: re-read balances and sign again.
Show child attributes
Response
Admitted, not yet paid: Totalis tops your wallet up from the vault if needed, relays the payout and pays the gas. Follow WITHDRAWAL_UPDATED on the account stream until PAYOUT_COMMITTED or FAILED. A retry with the same Idempotency-Key and body returns the withdrawal as it stands.
Total amount sent to destination, in atomic USDC (6 decimals).
Maximum string length: 39
Pattern: ^(0|[1-9][0-9]*)$
shortfall_amount
string<uint128-decimal>
required
Part of amount first withdrawn from the vault to the wallet, in atomic USDC; "0" when the wallet already covered it.
Maximum string length: 39
Pattern: ^(0|[1-9][0-9]*)$
status
enum<string>
required
VAULT_WITHDRAWAL_QUEUED: the vault top-up is queued and the payout waits for it; PAYOUT_SUBMITTED: the payout is queued or relayed; PAYOUT_COMMITTED: destination received amount (terminal); FAILED: the withdrawal stopped and nothing left the Totalis balance: a vault top-up that committed stays in the wallet (terminal).
Available options:
VAULT_WITHDRAWAL_QUEUED,
PAYOUT_SUBMITTED,
PAYOUT_COMMITTED,
FAILED
vault_operation_id
string | null
required
Operation of the vault top-up; null when there is no shortfall.
Pattern: ^0x[0-9a-f]{64}$
payout_operation_id
string | null
required
Operation of the relayed payout; null until the vault top-up commits.
Pattern: ^0x[0-9a-f]{64}$
payout_transaction_hash
string | null
required
HyperEVM transaction of the payout; null until it is broadcast.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Totalis","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/ucalledit/r8jaq7Kk06SHWl7c/logo/totalis-light.png?fit=max\u0026auto=format\u0026n=r8jaq7Kk06SHWl7c\u0026q=85\u0026s=bfc2c43758a4153215b97f4f1f4a849e","dark":"https://mintcdn.com/ucalledit/r8jaq7Kk06SHWl7c/logo/totalis-dark.png?fit=max\u0026auto=format\u0026n=r8jaq7Kk06SHWl7c\u0026q=85\u0026s=c9cd04e32bfb6912c319d5bea48cb835"},"favicon":"https://mintcdn.com/ucalledit/r8jaq7Kk06SHWl7c/favicon.png?fit=max\u0026auto=format\u0026n=r8jaq7Kk06SHWl7c\u0026q=85\u0026s=c011a0a3e86a2aba4ac734a6c7cd366a","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://api.totalis.trade"}},"background":{"color":{"light":"#FAFBFA","dark":"#0B0F0D"}},"navbar":{"links":[{"href":"https://app.totalis.trade/account/api-keys","label":"Get an API key"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.totalis.trade"}},"footer":{"socials":{"x":"https://x.com/totalistrading","github":"https://github.com/totalistrading"},"links":[{"header":"Status","items":[{"label":"Hyperliquid status","href":"https://status.totalis.trade"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"/terms-of-service"},{"label":"Privacy Policy","href":"/privacy-policy"}]}]},"seo":{"metatags":{"og:type":"website","og:site_name":"Totalis Documentation","og:locale":"en_US","og:image":"https://docs.totalis.trade/totalis.png","twitter:card":"summary_large_image","twitter:image":"https://docs.totalis.trade/totalis.png"}},"fonts":{"family":"DM Sans"},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ucalledit","hasAudioNarration":false,"actualSubdomain":"ucalledit","customDomains":["docs.totalis.trade"],"gitSource":{"type":"github","owner":"totalistrading","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afc6e88837a82b451e7d784","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":119},{"language":"default","tag":"Hyperliquid","count":100},{"language":"default","tag":"Solana","count":68},{"language":"default","tag":"Guides","count":63},{"language":"default","tag":"Account","count":22},{"language":"default","tag":"API keys","count":15},{"language":"default","tag":"RFQs \u0026 Quotes","count":14},{"language":"default","tag":"Resources","count":9},{"language":"default","tag":"Quote service","count":9},{"language":"default","tag":"Makers","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":""}]}
{"page":{"pagePath":"hyperliquid/api-reference/withdrawals/create-withdrawal","slug":"/hyperliquid/api-reference/withdrawals/create-withdrawal","pageMetadata":{"title":"Create withdrawal","description":"Withdraw USDC from your Totalis balance to an external address.\n\nRequires a key for your account with `funding:withdraw`, `sponsorship:use`.\n\nA wallet session for the account also works, with no scope limit, sent from its `Origin`.","deprecated":null,"version":null,"sidebarTitle":"Create withdrawal","openapi":"/hyperliquid/openapi.json post /v1/me/withdrawals","href":"/hyperliquid/api-reference/withdrawals/create-withdrawal","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Withdraw USDC from your Totalis balance to an external address.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Requires a key for your account with \", _jsx(_components.code, {\n children: \"funding:withdraw\"\n }), \", \", _jsx(_components.code, {\n children: \"sponsorship:use\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"A wallet session for the account also works, with no scope limit, sent from its \", _jsx(_components.code, {\n children: \"Origin\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create withdrawal","description":"Withdraw USDC from your Totalis balance to an external address.\n\nRequires a key for your account with `funding:withdraw`, `sponsorship:use`.\n\nA wallet session for the account also works, with no scope limit, sent from its `Origin`.","deprecated":null,"version":null,"sidebarTitle":"Create withdrawal","openapi":"/hyperliquid/openapi.json post /v1/me/withdrawals","href":"/hyperliquid/api-reference/withdrawals/create-withdrawal","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createWithdrawal","summary":"Create withdrawal","description":"Withdraw USDC from your Totalis balance to an external address.\n\nRequires a key for your account with `funding:withdraw`, `sponsorship:use`.\n\nA wallet session for the account also works, with no scope limit, sent from its `Origin`.","tags":["Account"],"security":["e8d1dd5f-4b35-46f8-86f0-0023af7fcad9","c5880a65-f44c-44da-9d20-ebb40559f232"],"parameters":["dae8a76e-0cf6-413b-8b93-f30ac1010cca"],"requestBody":"e8de606a-4d8a-4111-bf07-1d3c5bc6c4ff","responses":{"202":"cc6f8ec3-97e2-483a-b0b7-24bfdc4c4456","400":"02be5e4a-ecd2-4342-8afa-2e1e8add63e0","401":"bc98ec70-ea27-457e-b4c9-73f1e53fb967","403":"869eb096-c63f-4739-87f1-9c0814f0058f","404":"2e401367-dc14-4dab-aed9-c39f28ed25d4","409":"52208b0e-f604-43e2-86e3-5421fe5d19f2","422":"5b5747fc-af4c-4dc8-a309-059e0aceecd9","429":"0ba3ba9d-26a6-42a4-895d-e29732676dd8","503":"cc9878c4-2bf0-4c01-81a5-15cc00e3f700"},"x-mint":{"href":"/hyperliquid/api-reference/withdrawals/create-withdrawal","metadata":{"title":"Create withdrawal","sidebarTitle":"Create withdrawal"}},"method":"post","type":"path","servers":["2778c702-84e3-4f5c-844b-cf09a1faeeeb","f4a2f610-e68a-43ad-9bdb-14b9874b1841"],"path":"/v1/me/withdrawals","baseUrlOptions":["https://hip4-api.totalis.trade","https://hip4-api-staging.totalis.trade"],"title":"Create withdrawal","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"dae8a76e-0cf6-413b-8b93-f30ac1010cca":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","isRequired":true,"description":"Lowercase UUIDv7 naming this command, unique per caller and route. A retry with the same key and body returns the original result; the same key with a different body returns `409 IDEMPOTENCY_KEY_REUSED`.","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Lowercase UUIDv7 naming this command, unique per caller and route. A retry with the same key and body returns the original result; the same key with a different body returns `409 IDEMPOTENCY_KEY_REUSED`.","example":"0198a6f6-82a5-7abc-9f2a-4f0fb437493e"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"description":"The whole withdrawal in one request: pay amount from the embedded wallet to destination, topping the wallet up from the vault first when it cannot cover the amount. The owner signs the vault Exit for the shortfall and the USDC payout together; Totalis relays both, in order, and pays the gas.","type":"object","additionalProperties":false,"required":["destination","amount","payout_authorization"],"properties":{"destination":{"type":"string","pattern":"^0x[0-9a-f]{40}$","not":{"const":"0x0000000000000000000000000000000000000000"},"description":"External address that receives the USDC.","isRequired":true,"uniqueKey":"destination","typeLabel":"string"},"amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","maxLength":39,"format":"uint128-decimal","description":"Total amount to send, in atomic USDC (6 decimals); must be greater than zero.","isRequired":true,"uniqueKey":"amount","typeLabel":"string\u003cuint128-decimal>"},"payout_authorization":{"description":"The embedded wallet's USDC EIP-3009 TransferWithAuthorization of exactly amount to destination. Its nonce is not sent: sign keccak256(abi.encode(keccak256(\"TOTALIS_PAYOUT_NONCE_V1\"), chainId, vault, account, uint128(Idempotency-Key))), where account is the embedded wallet and Idempotency-Key is this request's key read as 16 bytes. The signature is therefore bound to this request and cannot start a second withdrawal. Choose the `Idempotency-Key` before you sign.","type":"object","additionalProperties":false,"required":["valid_after","valid_before","authorization_signature"],"properties":{"valid_after":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18}|1[0-7][0-9]{18}|18[0-3][0-9]{17}|184[0-3][0-9]{16}|1844[0-5][0-9]{15}|18446[0-6][0-9]{14}|184467[0-3][0-9]{13}|1844674[0-3][0-9]{12}|184467440[0-6][0-9]{10}|1844674407[0-2][0-9]{9}|18446744073[0-6][0-9]{8}|1844674407370[0-8][0-9]{6}|18446744073709[0-4][0-9]{5}|184467440737095[0-4][0-9]{4}|18446744073709550[0-9]{3}|18446744073709551[0-5][0-9]{2}|1844674407370955160[0-9]|1844674407370955161[0-5])$","maxLength":20,"format":"uint64-decimal","description":"EIP-3009 validAfter in Unix seconds; must not be in the future.","isRequired":true,"uniqueKey":"payout_authorization.valid_after","typeLabel":"string\u003cuint64-decimal>"},"valid_before":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18}|1[0-7][0-9]{18}|18[0-3][0-9]{17}|184[0-3][0-9]{16}|1844[0-5][0-9]{15}|18446[0-6][0-9]{14}|184467[0-3][0-9]{13}|1844674[0-3][0-9]{12}|184467440[0-6][0-9]{10}|1844674407[0-2][0-9]{9}|18446744073[0-6][0-9]{8}|1844674407370[0-8][0-9]{6}|18446744073709[0-4][0-9]{5}|184467440737095[0-4][0-9]{4}|18446744073709550[0-9]{3}|18446744073709551[0-5][0-9]{2}|1844674407370955160[0-9]|1844674407370955161[0-5])$","maxLength":20,"format":"uint64-decimal","description":"EIP-3009 validBefore in Unix seconds: at least 300 seconds after vault_withdrawal.expiry (or after now when there is no shortfall), so the payout can still be relayed once the vault leg lands, and at most 4500 seconds after valid_after.","isRequired":true,"uniqueKey":"payout_authorization.valid_before","typeLabel":"string\u003cuint64-decimal>"},"authorization_signature":{"type":"string","pattern":"^0x[0-9a-f]{130}$","description":"65-byte ECDSA signature by the embedded wallet over the USDC TransferWithAuthorization(from=wallet, to=destination, value=amount, validAfter, validBefore, nonce) message.","isRequired":true,"uniqueKey":"payout_authorization.authorization_signature","typeLabel":"string"}},"isRequired":true,"uniqueKey":"payout_authorization","typeLabel":"object"},"vault_withdrawal":{"description":"Signed Exit moving the exact shortfall (amount minus spendable wallet USDC) from the vault back to the embedded wallet. Required when there is a shortfall and forbidden when there is none; a mismatch returns 409 STATE_CONFLICT with retry REFRESH: re-read balances and sign again.","type":"object","additionalProperties":false,"required":["amount","expiry","salt","signature"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","maxLength":39,"format":"uint128-decimal","description":"Shortfall in atomic USDC (6 decimals): the withdrawal amount minus spendable wallet USDC; must be greater than zero.","isRequired":true,"uniqueKey":"vault_withdrawal.amount","typeLabel":"string\u003cuint128-decimal>"},"expiry":{"type":"string","pattern":"^(0|[1-9][0-9]{0,18}|1[0-7][0-9]{18}|18[0-3][0-9]{17}|184[0-3][0-9]{16}|1844[0-5][0-9]{15}|18446[0-6][0-9]{14}|184467[0-3][0-9]{13}|1844674[0-3][0-9]{12}|184467440[0-6][0-9]{10}|1844674407[0-2][0-9]{9}|18446744073[0-6][0-9]{8}|1844674407370[0-8][0-9]{6}|18446744073709[0-4][0-9]{5}|184467440737095[0-4][0-9]{4}|18446744073709550[0-9]{3}|18446744073709551[0-5][0-9]{2}|1844674407370955160[0-9]|1844674407370955161[0-5])$","maxLength":20,"format":"uint64-decimal","description":"Exit expiry in Unix seconds; must be at least 5 seconds ahead and at most 3600 seconds ahead, less a 5-second clock-skew margin.","isRequired":true,"uniqueKey":"vault_withdrawal.expiry","typeLabel":"string\u003cuint64-decimal>"},"salt":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","maxLength":78,"format":"uint256-decimal","description":"Caller-chosen uint256 as a decimal string that makes the signed Exit unique.","isRequired":true,"uniqueKey":"vault_withdrawal.salt","typeLabel":"string\u003cuint256-decimal>"},"signature":{"type":"string","pattern":"^0x(?:[0-9a-f]{2}){1,4096}$","description":"Signature by the embedded wallet over the EIP-712 `Exit(account,to,amount,expiry,salt)` digest, with `account` and `to` the wallet; ECDSA or ERC-1271 contract signature bytes.","isRequired":true,"uniqueKey":"vault_withdrawal.signature","typeLabel":"string"}},"uniqueKey":"vault_withdrawal","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"destination":"0x2222222222222222222222222222222222222222","amount":"15000000","vault_withdrawal":{"amount":"10000000","expiry":"1790434800","salt":"4919131752989213764","signature":"0xefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefef"},"payout_authorization":{"valid_after":"1790433540","valid_before":"1790435100","authorization_signature":"0x9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e1b"}},"examples":{"Example":{"title":"Example","value":{"destination":"0x2222222222222222222222222222222222222222","amount":"15000000","vault_withdrawal":{"amount":"10000000","expiry":"1790434800","salt":"4919131752989213764","signature":"0xefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefefef"},"payout_authorization":{"valid_after":"1790433540","valid_before":"1790435100","authorization_signature":"0x9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e9e1b"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"cc6f8ec3-97e2-483a-b0b7-24bfdc4c4456":{"description":"Admitted, not yet paid: Totalis tops your wallet up from the vault if needed, relays the payout and pays the gas. Follow `WITHDRAWAL_UPDATED` on the account stream until `PAYOUT_COMMITTED` or `FAILED`. A retry with the same `Idempotency-Key` and body returns the withdrawal as it stands.","content":{"application/json":{"schema":{"type":"object","required":["withdrawal_id","account","destination","amount","shortfall_amount","status","vault_operation_id","payout_operation_id","payout_transaction_hash","updated_at"],"properties":{"withdrawal_id":{"type":"string","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","description":"Server-assigned ID of this withdrawal.","isRequired":true,"uniqueKey":"withdrawal_id","typeLabel":"string\u003cuuid>"},"account":{"type":"string","pattern":"^0x[0-9a-f]{40}$","not":{"const":"0x0000000000000000000000000000000000000000"},"description":"Embedded wallet that pays out.","isRequired":true,"uniqueKey":"account","typeLabel":"string"},"destination":{"type":"string","pattern":"^0x[0-9a-f]{40}$","not":{"const":"0x0000000000000000000000000000000000000000"},"description":"External address that receives the USDC.","isRequired":true,"uniqueKey":"destination","typeLabel":"string"},"amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","maxLength":39,"format":"uint128-decimal","description":"Total amount sent to destination, in atomic USDC (6 decimals).","isRequired":true,"uniqueKey":"amount","typeLabel":"string\u003cuint128-decimal>"},"shortfall_amount":{"type":"string","pattern":"^(0|[1-9][0-9]*)$","maxLength":39,"format":"uint128-decimal","description":"Part of amount first withdrawn from the vault to the wallet, in atomic USDC; \"0\" when the wallet already covered it.","isRequired":true,"uniqueKey":"shortfall_amount","typeLabel":"string\u003cuint128-decimal>"},"status":{"description":"VAULT_WITHDRAWAL_QUEUED: the vault top-up is queued and the payout waits for it; PAYOUT_SUBMITTED: the payout is queued or relayed; PAYOUT_COMMITTED: destination received amount (terminal); FAILED: the withdrawal stopped and nothing left the Totalis balance: a vault top-up that committed stays in the wallet (terminal).","enum":["VAULT_WITHDRAWAL_QUEUED","PAYOUT_SUBMITTED","PAYOUT_COMMITTED","FAILED"],"type":"string","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"vault_operation_id":{"oneOf":[{"type":"string","description":"Operation of the vault top-up; null when there is no shortfall.","pattern":"^0x[0-9a-f]{64}$","isRequired":true,"uniqueKey":"vault_operation_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Operation of the vault top-up; null when there is no shortfall.","isRequired":true,"uniqueKey":"vault_operation_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"vault_operation_id","typeLabel":"string | null"},"payout_operation_id":{"oneOf":[{"type":"string","description":"Operation of the relayed payout; null until the vault top-up commits.","pattern":"^0x[0-9a-f]{64}$","isRequired":true,"uniqueKey":"payout_operation_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Operation of the relayed payout; null until the vault top-up commits.","isRequired":true,"uniqueKey":"payout_operation_id.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payout_operation_id","typeLabel":"string | null"},"payout_transaction_hash":{"oneOf":[{"type":"string","description":"HyperEVM transaction of the payout; null until it is broadcast.","pattern":"^0x[0-9a-f]{64}$","isRequired":true,"uniqueKey":"payout_transaction_hash.oneOf.0","typeLabel":"string"},{"type":"null","description":"HyperEVM transaction of the payout; null until it is broadcast.","isRequired":true,"uniqueKey":"payout_transaction_hash.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"payout_transaction_hash","typeLabel":"string | null"},"updated_at":{"type":"string","format":"date-time","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,9})?Z$","maxLength":30,"description":"When the withdrawal last changed, RFC3339 UTC.","isRequired":true,"uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"withdrawal_id":"01998683-7a31-7e5a-a3c1-6f2b8d4e9a17","account":"0x1111111111111111111111111111111111111111","destination":"0x2222222222222222222222222222222222222222","amount":"15000000","shortfall_amount":"10000000","status":"VAULT_WITHDRAWAL_QUEUED","vault_operation_id":"0x3a7d1e9c5b2f8a4e6d1c9b3f7a5e2d8c4b1f6a9e3d7c2b5f8a1e4d9c6b3f7a20","payout_operation_id":null,"payout_transaction_hash":null,"updated_at":"2026-09-26T14:30:00.412000Z"},"examples":{"Example":{"title":"Example","value":{"withdrawal_id":"01998683-7a31-7e5a-a3c1-6f2b8d4e9a17","account":"0x1111111111111111111111111111111111111111","destination":"0x2222222222222222222222222222222222222222","amount":"15000000","shortfall_amount":"10000000","status":"VAULT_WITHDRAWAL_QUEUED","vault_operation_id":"0x3a7d1e9c5b2f8a4e6d1c9b3f7a5e2d8c4b1f6a9e3d7c2b5f8a1e4d9c6b3f7a20","payout_operation_id":null,"payout_transaction_hash":null,"updated_at":"2026-09-26T14:30:00.412000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"02be5e4a-ecd2-4342-8afa-2e1e8add63e0":{"description":"- `INVALID_REQUEST` (retry `NEVER`): The body, a path parameter or a header is malformed or fails validation. `field_violations` names invalid body fields; for an RFQ leg whose market refuses new positions now, `/legs/{i}/outcome_id`, with the reason in the message. `NEVER` means the same request will fail again; the leg's market can become eligible later, so before a new RFQ read its live `eligibility` and, for a Combo leg, `combo.state` and `combo.reason` (`combo.opens_at` is set only for an `OUTSIDE_WINDOW` refusal whose window has a known time).\n- `INVALID_IDEMPOTENCY_KEY` (retry `NEVER`): The command needs exactly one lowercase UUIDv7 `Idempotency-Key` header; confirm takes none.\n- `ORIGIN_REQUIRED` (retry `NEVER`): A browser route needs exactly one `Origin` header.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["INVALID_REQUEST","INVALID_IDEMPOTENCY_KEY","ORIGIN_REQUIRED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["NEVER"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"NEVER"}}}},"exampleType":"generated"}},"exampleType":"generated"},"bc98ec70-ea27-457e-b4c9-73f1e53fb967":{"description":"- `UNAUTHENTICATED` (retry `NEVER`): The credential is missing, invalid, expired or revoked.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["UNAUTHENTICATED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["NEVER"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHENTICATED","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"NEVER"}}}},"exampleType":"generated"}},"exampleType":"generated"},"869eb096-c63f-4739-87f1-9c0814f0058f":{"description":"- `FORBIDDEN` (retry `NEVER`): The credential is valid but lacks the scope, permission or role this operation needs.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["FORBIDDEN"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["NEVER"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"FORBIDDEN","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"NEVER"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2e401367-dc14-4dab-aed9-c39f28ed25d4":{"description":"- `IDENTITY_NOT_FOUND` (retry `NEVER`): The account has no venue identity yet; bind the embedded wallet first.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["IDENTITY_NOT_FOUND"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["NEVER"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"IDENTITY_NOT_FOUND","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"NEVER"}}}},"exampleType":"generated"}},"exampleType":"generated"},"52208b0e-f604-43e2-86e3-5421fe5d19f2":{"description":"- `IDEMPOTENCY_KEY_REUSED` (retry `NEVER`): The idempotency key was already used with different input.\n- `STATE_CONFLICT` (retry `REFRESH`): The resource changed and no longer admits this request.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["IDEMPOTENCY_KEY_REUSED","STATE_CONFLICT"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["NEVER","REFRESH"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"IDEMPOTENCY_KEY_REUSED","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"NEVER"}}}},"exampleType":"generated"}},"exampleType":"generated"},"5b5747fc-af4c-4dc8-a309-059e0aceecd9":{"description":"- `INVALID_SIGNATURE` (retry `NEVER`): The signature does not verify for the signed terms.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["INVALID_SIGNATURE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["NEVER"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_SIGNATURE","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"NEVER"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0ba3ba9d-26a6-42a4-895d-e29732676dd8":{"description":"- `RATE_LIMITED` (retry `BACKOFF`): The request quota for this credential or route is exhausted.","headers":{"Retry-After":{"description":"Seconds to wait before resending the same request","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["RATE_LIMITED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["BACKOFF"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"RATE_LIMITED","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"BACKOFF"}}}},"exampleType":"generated"}},"exampleType":"generated"},"cc9878c4-2bf0-4c01-81a5-15cc00e3f700":{"description":"- `AUTHORIZATION_UNAVAILABLE` (retry `BACKOFF`): Identity or credential authority storage is unavailable.\n- `DEPENDENCY_STALE` (retry `BACKOFF`): A projection or upstream the request depends on (chain projection, HyperCore state, database) is behind its freshness bound or unavailable.\n- `FINANCIAL_ACTIONS_DISABLED` (retry `BACKOFF`): Financial actions are disabled for this deployment.\n- `CONTRACT_SIGNATURE_OVERLOADED` (retry `BACKOFF`): Contract signature verification is at capacity.\n- `SPONSORSHIP_UNAVAILABLE` (retry `BACKOFF`): Venue gas sponsorship is unavailable.","headers":{"Retry-After":{"description":"Seconds to wait before resending the same request","schema":{"type":"integer","minimum":1}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","description":"The error this operation returns with this status.","required":["code","message","retry","request_id","field_violations"],"properties":{"code":{"type":"string","description":"One of the registered codes listed in this response's description.","enum":["AUTHORIZATION_UNAVAILABLE","DEPENDENCY_STALE","FINANCIAL_ACTIONS_DISABLED","CONTRACT_SIGNATURE_OVERLOADED","SPONSORSHIP_UNAVAILABLE"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"field_violations":{"description":"Each invalid input by JSON pointer; empty when the error is not about a specific input.","items":{"properties":{"code":{"description":"REQUIRED: the input is missing. INVALID: it is present but malformed or out of range. UNEXPECTED: the input is not accepted here.","enum":["REQUIRED","INVALID","UNEXPECTED"],"type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"field":{"description":"JSON pointer into the body, or into the query parameters as one flat object for requests without a body, for example /legs/0/stake or /limit.","pattern":"^(/([^~/]|~[01])*)+$","type":"string","isRequired":true,"uniqueKey":"error.field_violations.items.[INDEX].field","typeLabel":"string"}},"required":["field","code"],"type":"object","uniqueKey":"error.field_violations.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"error.field_violations","typeLabel":"object[]"},"message":{"description":"Human-readable; may change without notice.","minLength":1,"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"description":"UUIDv7 of this request, also returned in the X-Request-ID header. Quote it when reporting a problem.","format":"uuid","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$","type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string\u003cuuid>"},"retry":{"type":"string","description":"The retry rule the registry fixes for the returned code.","enum":["BACKOFF"],"isRequired":true,"uniqueKey":"error.retry","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"AUTHORIZATION_UNAVAILABLE","field_violations":[{"code":"REQUIRED","field":"\u003cstring>"}],"message":"\u003cstring>","request_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","retry":"BACKOFF"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e8d1dd5f-4b35-46f8-86f0-0023af7fcad9":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"ttk_","description":"Scoped API key (`ttk_...`), created in the Totalis app or by a wallet-session user through the API keys routes with a fresh wallet signature; those routes never accept a key. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires. Send no `Origin`.","scopes":["funding:withdraw","sponsorship:use"],"schemeName":"apiKey"}},"c5880a65-f44c-44da-9d20-ebb40559f232":{"walletSession":{"type":"http","scheme":"bearer","description":"Wallet session: the `access_token` from `POST /v1/auth/wallet-sessions`, for a user who brings their own wallet to a partner's web page. It acts for that wallet's account with no scope limit, and is bound to the `Origin` it signed in from: send exactly one `Origin` header with that value, or the request is `ORIGIN_REQUIRED` or `UNAUTHENTICATED`. It lasts at most 30 days and ends after 7 idle days or at `DELETE /v1/auth/wallet-sessions/current`.","scopes":[],"schemeName":"walletSession"}}},"servers":{"2778c702-84e3-4f5c-844b-cf09a1faeeeb":{"url":"https://hip4-api.totalis.trade","description":"Production public edge"},"f4a2f610-e68a-43ad-9bdb-14b9874b1841":{"url":"https://hip4-api-staging.totalis.trade","description":"Staging and chain-998 public edge"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"ttk_","description":"Scoped API key (`ttk_...`), created in the Totalis app or by a wallet-session user through the API keys routes with a fresh wallet signature; those routes never accept a key. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires. Send no `Origin`.","scopes":["funding:withdraw","sponsorship:use"],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Scoped API key (`ttk_...`), created in the Totalis app or by a wallet-session user through the API keys routes with a fresh wallet signature; those routes never accept a key. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires. Send no `Origin`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Wallet session: the `access_token` from `POST /v1/auth/wallet-sessions`, for a user who brings their own wallet to a partner's web page. It acts for that wallet's account with no scope limit, and is bound to the `Origin` it signed in from: send exactly one `Origin` header with that value, or the request is `ORIGIN_REQUIRED` or `UNAUTHENTICATED`. It lasts at most 30 days and ends after 7 idle days or at `DELETE /v1/auth/wallet-sessions/current`.","scopes":[],"schemeName":"walletSession"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Wallet session: the `access_token` from `POST /v1/auth/wallet-sessions`, for a user who brings their own wallet to a partner's web page. It acts for that wallet's account with no scope limit, and is bound to the `Origin` it signed in from: send exactly one `Origin` header with that value, or the request is `ORIGIN_REQUIRED` or `UNAUTHENTICATED`. It lasts at most 30 days and ends after 7 idle days or at `DELETE /v1/auth/wallet-sessions/current`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"walletSession","name":"Authorization"}],"title":"walletSession"}]},"originalFileLocation":"hyperliquid/openapi.json"},"subdomain":"ucalledit","siteName":"Totalis","title":"Create withdrawal - Totalis","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-17T15:11:12.055Z","originalFileLocation":"hyperliquid/api-reference/withdrawals/create-withdrawal.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Withdraw USDC from your Totalis balance to an external address. Requires a key for your account with funding:withdraw, sponsorship:use. A wallet session for the account also works, with no scope limit, sent from its Origin.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Totalis\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create withdrawal - Totalis\">\u003cmeta data-mint-head property=\"og:description\" content=\"Withdraw USDC from your Totalis balance to an external address. Requires a key for your account with funding:withdraw, sponsorship:use. A wallet session for the account also works, with no scope limit, sent from its Origin.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Totalis Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.totalis.trade/totalis.png\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create withdrawal - Totalis\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Withdraw USDC from your Totalis balance to an external address. Requires a key for your account with funding:withdraw, sponsorship:use. A wallet session for the account also works, with no scope limit, sent from its Origin.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.totalis.trade/totalis.png\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ucalledit/nSbc8XH_JELxakJk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Totalis\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/hyperliquid/api-reference/withdrawals/create-withdrawal.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.totalis.trade/#organization\",\"name\":\"Totalis\",\"url\":\"https://docs.totalis.trade\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ucalledit/r8jaq7Kk06SHWl7c/logo/totalis-light.png?fit=max\u0026auto=format\u0026n=r8jaq7Kk06SHWl7c\u0026q=85\u0026s=bfc2c43758a4153215b97f4f1f4a849e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.totalis.trade#website\",\"name\":\"Totalis\",\"url\":\"https://docs.totalis.trade\",\"publisher\":{\"@id\":\"https://docs.totalis.trade/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal#webpage\",\"url\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal\",\"name\":\"Create withdrawal\",\"description\":\"Withdraw USDC from your Totalis balance to an external address. Requires a key for your account with funding:withdraw, sponsorship:use. A wallet session for the account also works, with no scope limit, sent from its Origin.\",\"dateModified\":\"2026-11-17T15:11:12.055Z\",\"isPartOf\":{\"@id\":\"https://docs.totalis.trade#website\"},\"breadcrumb\":{\"@id\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Account\",\"item\":\"https://docs.totalis.trade/hyperliquid/api-reference/account/get-identity\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create withdrawal\",\"item\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal#apireference\",\"headline\":\"Create withdrawal\",\"name\":\"Create withdrawal\",\"description\":\"Withdraw USDC from your Totalis balance to an external address. Requires a key for your account with funding:withdraw, sponsorship:use. A wallet session for the account also works, with no scope limit, sent from its Origin.\",\"url\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal\",\"mainEntityOfPage\":{\"@id\":\"https://docs.totalis.trade/hyperliquid/api-reference/withdrawals/create-withdrawal#webpage\"},\"image\":\"https://docs.totalis.trade/totalis.png\",\"dateModified\":\"2026-11-17T15:11:12.055Z\",\"publisher\":{\"@id\":\"https://docs.totalis.trade/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.totalis.trade#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Totalis\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Totalis\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/hyperliquid/api-reference/withdrawals/create-withdrawal.md","siteName":"Totalis","nav":{"global":{"anchors":[]},"products":[{"product":"Hyperliquid","description":"Combos on Hyperliquid HIP-4 prediction markets, quoted by market makers and settled on HyperEVM","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/hyperliquid"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/hyperliquid/api-reference/introduction"}]},{"group":"Markets","pages":[{"title":"List markets","deprecated":null,"version":null,"sidebarTitle":"List markets","openapi":"/hyperliquid/openapi.json get /v1/markets","href":"/hyperliquid/api-reference/markets/list-markets"},{"title":"List questions","deprecated":null,"version":null,"sidebarTitle":"List questions","openapi":"/hyperliquid/openapi.json get /v1/discovery","href":"/hyperliquid/api-reference/markets/list-questions"},{"title":"Get market","deprecated":null,"version":null,"sidebarTitle":"Get market","openapi":"/hyperliquid/openapi.json get /v1/markets/{outcome_id}","href":"/hyperliquid/api-reference/markets/get-market"},{"title":"Get market history","deprecated":null,"version":null,"sidebarTitle":"Get market history","openapi":"/hyperliquid/openapi.json get /v1/markets/{outcome_id}/history","href":"/hyperliquid/api-reference/markets/get-market-history"},{"title":"Get market display","deprecated":null,"version":null,"sidebarTitle":"Get market display","openapi":"/hyperliquid/openapi.json get /v1/market-display","href":"/hyperliquid/api-reference/markets/get-market-display"}]},{"group":"RFQs \u0026 Quotes","pages":[{"group":"Taking","pages":[{"title":"Create RFQ","deprecated":null,"version":null,"sidebarTitle":"Create RFQ","openapi":"/hyperliquid/openapi.json post /v1/rfqs","href":"/hyperliquid/api-reference/rfqs/create-rfq"},{"title":"Accept quote","deprecated":null,"version":null,"sidebarTitle":"Accept quote","openapi":"/hyperliquid/openapi.json post /v1/quotes/{quote_id}/accept","href":"/hyperliquid/api-reference/quotes/accept-quote"},{"title":"Cancel RFQ","deprecated":null,"version":null,"sidebarTitle":"Cancel RFQ","openapi":"/hyperliquid/openapi.json post /v1/rfqs/{rfq_id}/cancel","href":"/hyperliquid/api-reference/rfqs/cancel-rfq"},{"title":"Cash out position","deprecated":null,"version":null,"sidebarTitle":"Cash out position","openapi":"/hyperliquid/openapi.json post /v1/me/positions/{position_id}/cashout","href":"/hyperliquid/api-reference/positions/cash-out-position"}]},{"group":"Making","pages":[{"title":"Create quote","deprecated":null,"version":null,"sidebarTitle":"Create quote","openapi":"/hyperliquid/openapi.json post /v1/rfqs/{rfq_id}/quotes","href":"/hyperliquid/api-reference/quotes/create-quote"},{"title":"Cancel quote","deprecated":null,"version":null,"sidebarTitle":"Cancel quote","openapi":"/hyperliquid/openapi.json delete /v1/quotes/{quote_id}","href":"/hyperliquid/api-reference/quotes/cancel-quote"},{"title":"Confirm quote","deprecated":null,"version":null,"sidebarTitle":"Confirm quote","openapi":"/hyperliquid/openapi.json post /v1/quotes/{quote_id}/confirm","href":"/hyperliquid/api-reference/quotes/confirm-quote"},{"title":"List acceptances","deprecated":null,"version":null,"sidebarTitle":"List acceptances","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/acceptances","href":"/hyperliquid/api-reference/quotes/list-acceptances"},{"title":"Keep quote lease","deprecated":null,"version":null,"sidebarTitle":"Keep quote lease","openapi":"/hyperliquid/openapi.json put /v1/makers/{maker_id}/quote-lease","href":"/hyperliquid/api-reference/quotes/keep-quote-lease"},{"title":"Release quote lease","deprecated":null,"version":null,"sidebarTitle":"Release quote lease","openapi":"/hyperliquid/openapi.json delete /v1/makers/{maker_id}/quote-lease","href":"/hyperliquid/api-reference/quotes/release-quote-lease"}]},{"group":"Reads","pages":[{"title":"List RFQs","deprecated":null,"version":null,"sidebarTitle":"List RFQs","openapi":"/hyperliquid/openapi.json get /v1/rfqs","href":"/hyperliquid/api-reference/rfqs/list-rfqs"},{"title":"Get RFQ","deprecated":null,"version":null,"sidebarTitle":"Get RFQ","openapi":"/hyperliquid/openapi.json get /v1/rfqs/{rfq_id}","href":"/hyperliquid/api-reference/rfqs/get-rfq"},{"title":"List quotes","deprecated":null,"version":null,"sidebarTitle":"List quotes","openapi":"/hyperliquid/openapi.json get /v1/rfqs/{rfq_id}/quotes","href":"/hyperliquid/api-reference/quotes/list-quotes"},{"title":"Get acceptance","deprecated":null,"version":null,"sidebarTitle":"Get acceptance","openapi":"/hyperliquid/openapi.json get /v1/quotes/{quote_id}/acceptance","href":"/hyperliquid/api-reference/quotes/get-acceptance"}]}]},{"group":"Positions","pages":[{"title":"List positions","deprecated":null,"version":null,"sidebarTitle":"List positions","openapi":"/hyperliquid/openapi.json get /v1/me/positions","href":"/hyperliquid/api-reference/positions/list-positions"},{"title":"Get position","deprecated":null,"version":null,"sidebarTitle":"Get position","openapi":"/hyperliquid/openapi.json get /v1/me/positions/{position_id}","href":"/hyperliquid/api-reference/positions/get-position"}]},{"group":"Account","pages":[{"title":"Get identity","deprecated":null,"version":null,"sidebarTitle":"Get identity","openapi":"/hyperliquid/openapi.json get /v1/me","href":"/hyperliquid/api-reference/account/get-identity"},{"title":"Get balances","deprecated":null,"version":null,"sidebarTitle":"Get balances","openapi":"/hyperliquid/openapi.json get /v1/me/balances","href":"/hyperliquid/api-reference/account/get-balances"},{"title":"Get account value","deprecated":null,"version":null,"sidebarTitle":"Get account value","openapi":"/hyperliquid/openapi.json get /v1/me/account-value","href":"/hyperliquid/api-reference/account/get-account-value"},{"title":"List activity","deprecated":null,"version":null,"sidebarTitle":"List activity","openapi":"/hyperliquid/openapi.json get /v1/me/activity","href":"/hyperliquid/api-reference/account/list-activity"},{"title":"Get P\u0026L","deprecated":null,"version":null,"sidebarTitle":"Get P\u0026L","openapi":"/hyperliquid/openapi.json get /v1/me/pnl","href":"/hyperliquid/api-reference/account/get-p-l"},{"title":"List operations","deprecated":null,"version":null,"sidebarTitle":"List operations","openapi":"/hyperliquid/openapi.json get /v1/me/operations","href":"/hyperliquid/api-reference/account/list-operations"},{"title":"Get operation","description":"Get an on-chain operation and its latest chain status.\n\nRequires one of:\n\n- a key for your account with `account:read`\n- a key for a maker with `vault:read`\n\nA wallet session for the account also works, with no scope limit, sent from its `Origin`.","deprecated":null,"version":null,"sidebarTitle":"Get operation","openapi":"/hyperliquid/openapi.json get /v1/me/operations/{operation_id}","href":"/hyperliquid/api-reference/account/get-operation"},{"title":"Create withdrawal","deprecated":null,"version":null,"sidebarTitle":"Create withdrawal","openapi":"/hyperliquid/openapi.json post /v1/me/withdrawals","href":"/hyperliquid/api-reference/withdrawals/create-withdrawal"},{"title":"Create run-off claim","description":"Moves the account's cash in a vault running off (`run_off` in Get balances) to the account's own wallet, part of Cash, by relaying its owner-signed Exit for that vault; a Totalis embedded wallet's run-off cash moves on its own and needs no claim.\n\nRequires a key for your account with `funding:withdraw`, `sponsorship:use`.\n\nA wallet session for the account also works, with no scope limit, sent from its `Origin`.","deprecated":null,"version":null,"sidebarTitle":"Create run-off claim","openapi":"/hyperliquid/openapi.json post /v1/me/run-off-claims","href":"/hyperliquid/api-reference/withdrawals/create-run-off-claim"},{"title":"Get withdrawal","deprecated":null,"version":null,"sidebarTitle":"Get withdrawal","openapi":"/hyperliquid/openapi.json get /v1/me/withdrawals/{withdrawal_id}","href":"/hyperliquid/api-reference/withdrawals/get-withdrawal"},{"title":"Create deposit","deprecated":null,"version":null,"sidebarTitle":"Create deposit","openapi":"/hyperliquid/openapi.json post /v1/me/deposits","href":"/hyperliquid/api-reference/deposits/create-deposit"},{"title":"Get wallet approval","deprecated":null,"version":null,"sidebarTitle":"Get wallet approval","openapi":"/hyperliquid/openapi.json get /v1/me/wallet-approval","href":"/hyperliquid/api-reference/deposits/get-wallet-approval"},{"title":"Create wallet approval","deprecated":null,"version":null,"sidebarTitle":"Create wallet approval","openapi":"/hyperliquid/openapi.json post /v1/me/wallet-approval","href":"/hyperliquid/api-reference/deposits/create-wallet-approval"},{"title":"Create HyperCore exit","deprecated":null,"version":null,"sidebarTitle":"Create HyperCore exit","openapi":"/hyperliquid/openapi.json post /v1/core-exits","href":"/hyperliquid/api-reference/core-exits/create-hypercore-exit"},{"title":"List HyperCore exits","deprecated":null,"version":null,"sidebarTitle":"List HyperCore exits","openapi":"/hyperliquid/openapi.json get /v1/me/core-exits","href":"/hyperliquid/api-reference/core-exits/list-hypercore-exits"},{"title":"Get HyperCore exit","deprecated":null,"version":null,"sidebarTitle":"Get HyperCore exit","openapi":"/hyperliquid/openapi.json get /v1/core-exits/{exit_id}","href":"/hyperliquid/api-reference/core-exits/get-hypercore-exit"},{"title":"Abandon HyperCore exit","deprecated":null,"version":null,"sidebarTitle":"Abandon HyperCore exit","openapi":"/hyperliquid/openapi.json post /v1/core-exits/{exit_id}/abandon","href":"/hyperliquid/api-reference/core-exits/abandon-hypercore-exit"}]},{"group":"Makers","pages":[{"title":"Get own maker","deprecated":null,"version":null,"sidebarTitle":"Get own maker","openapi":"/hyperliquid/openapi.json get /v1/me/maker","href":"/hyperliquid/api-reference/makers/get-own-maker"},{"title":"Admit own maker","deprecated":null,"version":null,"sidebarTitle":"Admit own maker","openapi":"/hyperliquid/openapi.json post /v1/me/maker","href":"/hyperliquid/api-reference/makers/admit-own-maker"},{"title":"List quote history","deprecated":null,"version":null,"sidebarTitle":"List quote history","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/quote-history","href":"/hyperliquid/api-reference/makers/list-quote-history"},{"title":"Get maker capital","deprecated":null,"version":null,"sidebarTitle":"Get maker capital","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/capital","href":"/hyperliquid/api-reference/makers/get-maker-capital"},{"title":"Get maker performance","deprecated":null,"version":null,"sidebarTitle":"Get maker performance","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/performance","href":"/hyperliquid/api-reference/makers/get-maker-performance"},{"title":"Create collateral reduction","deprecated":null,"version":null,"sidebarTitle":"Create collateral reduction","openapi":"/hyperliquid/openapi.json post /v1/makers/{maker_id}/collateral-reductions","href":"/hyperliquid/api-reference/makers/create-collateral-reduction"},{"title":"Get collateral reduction","deprecated":null,"version":null,"sidebarTitle":"Get collateral reduction","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/collateral-reductions/{job_id}","href":"/hyperliquid/api-reference/makers/get-collateral-reduction"},{"title":"Get maker withdrawal","deprecated":null,"version":null,"sidebarTitle":"Get maker withdrawal","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/withdrawal","href":"/hyperliquid/api-reference/makers/get-maker-withdrawal"},{"title":"Submit self-funded transaction","deprecated":null,"version":null,"sidebarTitle":"Submit self-funded transaction","openapi":"/hyperliquid/openapi.json post /v1/makers/{maker_id}/operations/{operation_id}/self-funded-transaction","href":"/hyperliquid/api-reference/makers/submit-self-funded-transaction"}]},{"group":"Partners \u0026 wallet sign-in","pages":[{"title":"Admit wallet","deprecated":null,"version":null,"sidebarTitle":"Admit wallet","openapi":"/hyperliquid/openapi.json post /v1/partner/wallet-admissions","href":"/hyperliquid/api-reference/partners/admit-wallet"},{"title":"Get partner report","deprecated":null,"version":null,"sidebarTitle":"Get partner report","openapi":"/hyperliquid/openapi.json get /v1/partner/report","href":"/hyperliquid/api-reference/partners/get-partner-report"},{"title":"List partner fills","deprecated":null,"version":null,"sidebarTitle":"List partner fills","openapi":"/hyperliquid/openapi.json get /v1/partner/fills","href":"/hyperliquid/api-reference/partners/list-partner-fills"},{"title":"List webhook events","deprecated":null,"version":null,"sidebarTitle":"List webhook events","openapi":"/hyperliquid/openapi.json get /v1/partner/webhook-events","href":"/hyperliquid/api-reference/partners/list-webhook-events"},{"title":"Get user account value","deprecated":null,"version":null,"sidebarTitle":"Get user account value","openapi":"/hyperliquid/openapi.json get /v1/partner/accounts/{wallet}/account-value","href":"/hyperliquid/api-reference/partners/get-user-account-value"},{"title":"Create wallet challenge","deprecated":null,"version":null,"sidebarTitle":"Create wallet challenge","openapi":"/hyperliquid/openapi.json post /v1/auth/wallet-challenges","href":"/hyperliquid/api-reference/wallet-sessions/create-wallet-challenge"},{"title":"Create wallet session","deprecated":null,"version":null,"sidebarTitle":"Create wallet session","openapi":"/hyperliquid/openapi.json post /v1/auth/wallet-sessions","href":"/hyperliquid/api-reference/wallet-sessions/create-wallet-session"},{"title":"End wallet session","deprecated":null,"version":null,"sidebarTitle":"End wallet session","openapi":"/hyperliquid/openapi.json delete /v1/auth/wallet-sessions/current","href":"/hyperliquid/api-reference/wallet-sessions/end-wallet-session"}]},{"group":"API keys","pages":[{"title":"Create API key challenge","deprecated":null,"version":null,"sidebarTitle":"Create API key challenge","openapi":"/hyperliquid/openapi.json post /v1/me/api-key-challenges","href":"/hyperliquid/api-reference/api-keys/create-api-key-challenge"},{"title":"Create API key","deprecated":null,"version":null,"sidebarTitle":"Create API key","openapi":"/hyperliquid/openapi.json post /v1/me/api-keys","href":"/hyperliquid/api-reference/api-keys/create-api-key"},{"title":"Rotate API key","deprecated":null,"version":null,"sidebarTitle":"Rotate API key","openapi":"/hyperliquid/openapi.json post /v1/me/api-keys/{key_id}/rotations","href":"/hyperliquid/api-reference/api-keys/rotate-api-key"},{"title":"List API keys","deprecated":null,"version":null,"sidebarTitle":"List API keys","openapi":"/hyperliquid/openapi.json get /v1/me/api-keys","href":"/hyperliquid/api-reference/api-keys/list-api-keys"},{"title":"Revoke API key","deprecated":null,"version":null,"sidebarTitle":"Revoke API key","openapi":"/hyperliquid/openapi.json delete /v1/me/api-keys/{key_id}","href":"/hyperliquid/api-reference/api-keys/revoke-api-key"},{"title":"List API key scopes","deprecated":null,"version":null,"sidebarTitle":"List API key scopes","openapi":"/hyperliquid/openapi.json get /v1/me/api-key-capabilities","href":"/hyperliquid/api-reference/api-keys/list-api-key-scopes"},{"title":"Create maker API key challenge","deprecated":null,"version":null,"sidebarTitle":"Create maker API key challenge","openapi":"/hyperliquid/openapi.json post /v1/makers/{maker_id}/api-key-challenges","href":"/hyperliquid/api-reference/api-keys/create-maker-api-key-challenge"},{"title":"Create maker API key","deprecated":null,"version":null,"sidebarTitle":"Create maker API key","openapi":"/hyperliquid/openapi.json post /v1/makers/{maker_id}/api-keys","href":"/hyperliquid/api-reference/api-keys/create-maker-api-key"},{"title":"Rotate maker API key","deprecated":null,"version":null,"sidebarTitle":"Rotate maker API key","openapi":"/hyperliquid/openapi.json post /v1/makers/{maker_id}/api-keys/{key_id}/rotations","href":"/hyperliquid/api-reference/api-keys/rotate-maker-api-key"},{"title":"List maker API keys","deprecated":null,"version":null,"sidebarTitle":"List maker API keys","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/api-keys","href":"/hyperliquid/api-reference/api-keys/list-maker-api-keys"},{"title":"Revoke maker API key","deprecated":null,"version":null,"sidebarTitle":"Revoke maker API key","openapi":"/hyperliquid/openapi.json delete /v1/makers/{maker_id}/api-keys/{key_id}","href":"/hyperliquid/api-reference/api-keys/revoke-maker-api-key"},{"title":"List maker API key scopes","deprecated":null,"version":null,"sidebarTitle":"List maker API key scopes","openapi":"/hyperliquid/openapi.json get /v1/makers/{maker_id}/api-key-capabilities","href":"/hyperliquid/api-reference/api-keys/list-maker-api-key-scopes"}]},{"group":"Deployment","pages":[{"title":"Get deployment","deprecated":null,"version":null,"sidebarTitle":"Get deployment","openapi":"/hyperliquid/openapi.json get /v1/deployment","href":"/hyperliquid/api-reference/deployment/get-deployment"}]},{"group":"WebSocket","pages":[{"title":"Connection","icon":"plug","href":"/hyperliquid/api-reference/websocket/connection"},{"title":"Account channel","icon":"user","href":"/hyperliquid/api-reference/websocket/account"},{"title":"Maker channel","icon":"chart-candlestick","href":"/hyperliquid/api-reference/websocket/maker"},{"title":"Market data","icon":"wave-square","href":"/hyperliquid/api-reference/websocket/market-data"},{"title":"Open stream","deprecated":null,"version":null,"sidebarTitle":"Open stream","openapi":"/hyperliquid/openapi.json get /v1/stream","href":"/hyperliquid/api-reference/streams/open-stream"}]}]}]},{"product":"Solana","description":"Parlays across Kalshi and Polymarket, settled on Solana","pages":[{"title":"Solana","href":"/solana"}]}]},"basePath":"","title":"Create withdrawal - Totalis","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}