Accept the winning bid on your early cashout auction and exit on-chain. The bid is the price, and the market maker does not confirm it. You echo back the price you accepted, and the exit fills only at or above it. Totalis obtains signatures server-side via Privy at execution.You receive min_price_micro or better either way. Who won decides what happens to the position:
Winning bid from
Position
RFQ status
The position’s own counterparty
Closes. Your stake is released.
Becomes bought_back
Any other market maker
Transfers to the winner and stays open under new ownership. You are out of it.
Does not become bought_back
The commit is idempotent per (request, user). A committed result is cached for 5 minutes and replayed verbatim with 200 OK. A retry with a differentmin_price_micro still gets the first result, and the new floor is not re-evaluated. Retry with the value you first sent.
Indeterminate commits never double-spend. If the on-chain outcome is unknown (timeout or transient RPC failure), the request stays committing and returns 503 with details.indeterminate: true. Totalis resolves it against on-chain state, so do not treat that 503 as a failure. Reopen the stream and wait for the terminal status. See the 503 cases below.
Authentication
Send your API key in the X-API-Key header. The key needs the trading:write scope.
X-API-Key: <your-api-key>
A Privy JWT (Authorization: Bearer <jwt>) is also accepted. See Authentication.
Path parameters
string
required
The cashout request ID (UUID).
Request body
integer
required
The price you accepted on screen, in microUSDC. Echo back the price_micro from the best_quote frame you were shown. Without it the commit is a 400, because nothing ever fills at a price the user did not see.The fill uses the best live bid at commit time, floored at this value. A better bid fills at the better price. If the book has moved below it, the commit fails with 409 price_below_accepted (carrying best_price_micro) and the auction stays open to re-tap.
The body is strict. An unknown field is a 400.
Response
Returns 201 Created on a fresh commit, or 200 OK when replaying a cached idempotent result.
object
Show data
string
The cashout request UUID.
string
"committed"
string
The on-chain transaction signature: buy_back_position when the position closed, transfer_position when it transferred.
Errors
Status
Code
Description
400
VALIDATION_ERROR
Missing or invalid min_price_micro (must be an integer >= 1), or an unknown field.
401
UNAUTHORIZED
Missing or invalid API key.
403
FORBIDDEN
You do not own this cashout request (details.reason: not_owner).
404
NOT_FOUND
Cashout request not found.
409
CONFLICT
Determinate failure: nothing landed. See details.reason below.
410
GONE
The auction expired before commit. Open a fresh one.
429
RATE_LIMITED
Too many requests. Honor Retry-After.
503
SERVICE_UNAVAILABLE
Branch on details.indeterminate, never on the message. See below.
A 409 means nothing landed. Most reasons are retryable against a live book. already_transferred is terminal: stop, and re-read the position instead of reopening an auction.
409 reason
Meaning
price_below_accepted
The best live bid is below min_price_micro. Carries best_price_micro.
quote_expired
No live bid left.
not_active
The cashout request is not active.
locked
A commit for this auction is already in flight.
missing_wallet
The position has no seller wallet on record, so the exit cannot be built.
amount_over_bound
The winning counterparty bid failed the collateral re-check at commit.
Buyer-side rejections when the winner is acquiring the position.
details.indeterminate
Meaning
Your move
true
The exit may have landed. details.reason is the execution-layer code, typically COMMIT_UNREACHABLE (the lane was not reached), BAD_RESPONSE (it answered unusably), or the lane’s own error code. It is not a stable taxonomy, so treat every value the same.
Do not retry. Reopen the stream and wait for the terminal status.
false
Only ever fee_unavailable: the profit-fee rate could not be read. Nothing landed, and the auction is still open.
{"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":"6af941d125f0e2ea6db75f43","clientVersion":"0.0.4149","searchFilterCounts":[{"language":"default","tag":"API reference","count":118},{"language":"default","tag":"Hyperliquid","count":98},{"language":"default","tag":"Solana","count":68},{"language":"default","tag":"Guides","count":62},{"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":""}],"page":{"pagePath":"solana/api-reference/quote-service/cashout-commit","slug":"/solana/api-reference/quote-service/cashout-commit","pageMetadata":{"title":"Commit cashout","api":"POST /v1/cashout-requests/{id}/commit","description":"Accept the winning bid on an early cashout auction and drive it on-chain.","href":"/solana/api-reference/quote-service/cashout-commit"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Accept the winning bid on an early cashout auction and drive it on-chain.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Accept the winning bid on your early cashout auction and exit on-chain. The bid is the price, and the market maker does not confirm it. You echo back the price you accepted, and the exit fills only at or above it. Totalis obtains signatures server-side via Privy at execution.`}),`\n`,_jsxs(_components.p,{children:[`You receive `,_jsx(_components.code,{children:`min_price_micro`}),` or better either way. Who won decides what happens to the position:`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Winning bid from`}),_jsx(_components.th,{children:`Position`}),_jsx(_components.th,{children:`RFQ status`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`The position’s own counterparty`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Closes.`}),` Your stake is released.`]}),_jsxs(_components.td,{children:[`Becomes `,_jsx(_components.code,{children:`bought_back`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Any other market maker`}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Transfers`}),` to the winner and stays open under new ownership. You are out of it.`]}),_jsxs(_components.td,{children:[`Does not become `,_jsx(_components.code,{children:`bought_back`})]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`The commit is idempotent per (request, user). A committed result is cached for 5 minutes and replayed verbatim with `,_jsx(_components.code,{children:`200 OK`}),`. A retry with a `,_jsx(_components.em,{children:`different`}),` `,_jsx(_components.code,{children:`min_price_micro`}),` still gets the first result, and the new floor is not re-evaluated. Retry with the value you first sent.`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Indeterminate commits never double-spend.`}),` If the on-chain outcome is unknown (timeout or transient RPC failure), the request stays `,_jsx(_components.code,{children:`committing`}),` and returns `,_jsx(_components.code,{children:`503`}),` with `,_jsx(_components.code,{children:`details.indeterminate: true`}),`. Totalis resolves it against on-chain state, so do not treat that `,_jsx(_components.code,{children:`503`}),` as a failure. Reopen the `,_jsx(_components.a,{href:`/solana/api-reference/quote-service/cashout-stream`,children:`stream`}),` and wait for the terminal `,_jsx(_components.code,{children:`status`}),`. See the `,_jsxs(_components.a,{href:`#errors`,children:[_jsx(_components.code,{children:`503`}),` cases`]}),` below.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`authentication`,children:`Authentication`}),`\n`,_jsxs(_components.p,{children:[`Send your API key in the `,_jsx(_components.code,{children:`X-API-Key`}),` header. The key needs the `,_jsx(_components.code,{children:`trading:write`}),` scope.`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`X-API-Key: \u003cyour-api-key>`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`A Privy JWT (`,_jsx(_components.code,{children:`Authorization: Bearer \u003cjwt>`}),`) is also accepted. See `,_jsx(_components.a,{href:`/solana/authentication`,children:`Authentication`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`path-parameters`,children:`Path parameters`}),`\n`,_jsx(ParamField,{path:`id`,type:`string`,required:true,id:`param-id`,children:_jsx(_components.p,{children:`The cashout request ID (UUID).`})}),`\n`,_jsx(Heading,{level:`2`,id:`request-body`,children:`Request body`}),`\n`,_jsxs(ParamField,{body:`min_price_micro`,type:`integer`,required:true,id:`param-min-price-micro`,children:[_jsxs(_components.p,{children:[`The price you accepted on screen, in `,_jsx(_components.a,{href:`/solana/glossary#units`,children:`microUSDC`}),`. Echo back the `,_jsx(_components.code,{children:`price_micro`}),` from the `,_jsx(_components.code,{children:`best_quote`}),` frame you were shown. Without it the commit is a `,_jsx(_components.code,{children:`400`}),`, because nothing ever fills at a price the user did not see.`]}),_jsxs(_components.p,{children:[`The fill uses the best live bid at commit time, floored at this value. A better bid fills at the better price. If the book has moved below it, the commit fails with `,_jsx(_components.code,{children:`409 price_below_accepted`}),` (carrying `,_jsx(_components.code,{children:`best_price_micro`}),`) and the auction stays open to re-tap.`]})]}),`\n`,_jsxs(_components.p,{children:[`The body is strict. An unknown field is a `,_jsx(_components.code,{children:`400`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsxs(_components.p,{children:[`Returns `,_jsx(_components.code,{children:`201 Created`}),` on a fresh commit, or `,_jsx(_components.code,{children:`200 OK`}),` when replaying a cached idempotent result.`]}),`\n`,_jsx(ResponseField,{name:`data`,type:`object`,id:`param-data`,children:_jsxs(Expandable,{title:`data`,children:[_jsx(ResponseField,{name:`cashout_request_id`,type:`string`,id:`param-cashout-request-id`,children:`The cashout request UUID.`}),_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsx(_components.code,{children:`\"committed\"`})}),_jsxs(ResponseField,{name:`chain_sig`,type:`string`,id:`param-chain-sig`,children:[`The on-chain transaction signature: `,_jsx(_components.code,{children:`buy_back_position`}),` when the position closed, `,_jsx(_components.code,{children:`transfer_position`}),` when it transferred.`]})]})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`VALIDATION_ERROR`})}),_jsxs(_components.td,{children:[`Missing or invalid `,_jsx(_components.code,{children:`min_price_micro`}),` (must be an integer >= 1), or an unknown field.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`401`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UNAUTHORIZED`})}),_jsx(_components.td,{children:`Missing or invalid API key.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`403`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`FORBIDDEN`})}),_jsxs(_components.td,{children:[`You do not own this cashout request (`,_jsx(_components.code,{children:`details.reason: not_owner`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_FOUND`})}),_jsx(_components.td,{children:`Cashout request not found.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`409`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CONFLICT`})}),_jsxs(_components.td,{children:[`Determinate failure: nothing landed. See `,_jsx(_components.code,{children:`details.reason`}),` below.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`410`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GONE`})}),_jsx(_components.td,{children:`The auction expired before commit. Open a fresh one.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`429`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`RATE_LIMITED`})}),_jsxs(_components.td,{children:[`Too many requests. Honor `,_jsx(_components.code,{children:`Retry-After`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`503`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`SERVICE_UNAVAILABLE`})}),_jsxs(_components.td,{children:[`Branch on `,_jsx(_components.code,{children:`details.indeterminate`}),`, never on the message. See below.`]})]})]})]}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.code,{children:`409`}),` means nothing landed. Most reasons are retryable against a live book. `,_jsx(_components.code,{children:`already_transferred`}),` is terminal: stop, and re-read the position instead of reopening an auction.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsxs(_components.th,{children:[_jsx(_components.code,{children:`409`}),` reason`]}),_jsx(_components.th,{children:`Meaning`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`price_below_accepted`})}),_jsxs(_components.td,{children:[`The best live bid is below `,_jsx(_components.code,{children:`min_price_micro`}),`. Carries `,_jsx(_components.code,{children:`best_price_micro`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`quote_expired`})}),_jsx(_components.td,{children:`No live bid left.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`not_active`})}),_jsxs(_components.td,{children:[`The cashout request is not `,_jsx(_components.code,{children:`active`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`locked`})}),_jsx(_components.td,{children:`A commit for this auction is already in flight.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`missing_wallet`})}),_jsx(_components.td,{children:`The position has no seller wallet on record, so the exit cannot be built.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount_over_bound`})}),_jsx(_components.td,{children:`The winning counterparty bid failed the collateral re-check at commit.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`already_transferred`})}),_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`Terminal.`}),` The position has already moved.`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.code,{children:`insufficient_buyer_balance`}),`, `,_jsx(_components.code,{children:`buyer_no_vault`}),`, `,_jsx(_components.code,{children:`buyer_is_seller`}),`, `,_jsx(_components.code,{children:`buyer_is_counterparty`})]}),_jsx(_components.td,{children:`Buyer-side rejections when the winner is acquiring the position.`})]})]})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:_jsx(_components.code,{children:`details.indeterminate`})}),_jsx(_components.th,{children:`Meaning`}),_jsx(_components.th,{children:`Your move`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`true`})}),_jsxs(_components.td,{children:[`The exit may have landed. `,_jsx(_components.code,{children:`details.reason`}),` is the execution-layer code, typically `,_jsx(_components.code,{children:`COMMIT_UNREACHABLE`}),` (the lane was not reached), `,_jsx(_components.code,{children:`BAD_RESPONSE`}),` (it answered unusably), or the lane’s own error code. It is not a stable taxonomy, so treat every value the same.`]}),_jsxs(_components.td,{children:[`Do not retry. Reopen the `,_jsx(_components.a,{href:`/solana/api-reference/quote-service/cashout-stream`,children:`stream`}),` and wait for the terminal `,_jsx(_components.code,{children:`status`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`false`})}),_jsxs(_components.td,{children:[`Only ever `,_jsx(_components.code,{children:`fee_unavailable`}),`: the profit-fee rate could not be read. Nothing landed, and the auction is still open.`]}),_jsx(_components.td,{children:`Retry immediately. It is safe.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Commit cashout","api":"POST /v1/cashout-requests/{id}/commit","description":"Accept the winning bid on an early cashout auction and drive it on-chain.","href":"/solana/api-reference/quote-service/cashout-commit"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[396,405,"questExample,ResponseExample,ResponseFie"],[688,700,"questExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)"],[13460,13888,",`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`4`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`4`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api.totalis.trade/v1/cashout-requests/c3d4e5f6-7890-abcd-ef12-34567890abcd/commit`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-API-Key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$TOTALIS_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{\"min_price_micro\": 66250000}'`})]}),`\n`]})})})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`201`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cashout_request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"c3d4e5f6-7890-abcd-ef12-34567890abcd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"committed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"chain_sig\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5Nx7...buybackSig\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`503`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"SERVICE_UNAVAILABLE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Cashout is being processed; please check back\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"details\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"reason\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"COMMIT_UNREACHABLE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"indeterminate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Authentication","slug":"authentication","depth":2,"children":[]},{"title":"Path parameters","slug":"path-parameters","depth":2,"children":[]},{"title":"Request body","slug":"request-body","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://api.totalis.trade/v1/cashout-requests/c3d4e5f6-7890-abcd-ef12-34567890abcd/commit\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"X-API-Key: \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">$TOTALIS_API_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\"min_price_micro\": 66250000}'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"201","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"cashout_request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"c3d4e5f6-7890-abcd-ef12-34567890abcd\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"committed\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"chain_sig\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"5Nx7...buybackSig\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"503","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"error\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"SERVICE_UNAVAILABLE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Cashout is being processed; please check back\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"details\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"reason\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"COMMIT_UNREACHABLE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"indeterminate\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">true\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Commit cashout","path":"/v1/cashout-requests/{id}/commit","servers":[{"url":"https://api.totalis.trade"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{"id":{"schema":[{"type":"string","description":"The cashout request ID (UUID).","required":true}]}}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"min_price_micro":[{"type":"integer","description":"The price you accepted on screen, in microUSDC . Echo back the `price_micro` from the `best_quote` frame you were shown. Without it the commit is a `400` , because nothing ever fills at a price the user did not see. The fill uses the best live bid at commit time, floored at this value. A better bid fills at the better price. If the book has moved below it, the commit fails with `409 price_below_accepted` (carrying `best_price_micro` ) and the auction stays open to re-tap.","required":true}]}}],"examples":{"example":{"value":{"min_price_micro":123}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"object","properties":{"cashout_request_id":[{"type":"string","description":"The cashout request UUID."}],"status":[{"type":"string","description":"`\"committed\"`"}],"chain_sig":[{"type":"string","description":"The on-chain transaction signature: `buy_back_position` when the position closed, `transfer_position` when it transferred."}]}}]}}],"examples":{"example":{"value":{"data":{"cashout_request_id":"\u003cstring>","status":"\u003cstring>","chain_sig":"\u003cstring>"}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"ucalledit","siteName":"Totalis","title":"Commit cashout - Totalis","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-14T00:55:06.001Z","originalFileLocation":"solana/api-reference/quote-service/cashout-commit.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=\"Accept the winning bid on an early cashout auction and drive it on-chain.\">\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=\"Commit cashout - Totalis\">\u003cmeta data-mint-head property=\"og:description\" content=\"Accept the winning bid on an early cashout auction and drive it on-chain.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Totalis Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit\">\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=\"Commit cashout - Totalis\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Accept the winning bid on an early cashout auction and drive it on-chain.\">\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/solana/api-reference/quote-service/cashout-commit\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/solana/api-reference/quote-service/cashout-commit.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/solana/api-reference/quote-service/cashout-commit#webpage\",\"url\":\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit\",\"name\":\"Commit cashout\",\"description\":\"Accept the winning bid on an early cashout auction and drive it on-chain.\",\"dateModified\":\"2026-11-14T00:55:06.001Z\",\"isPartOf\":{\"@id\":\"https://docs.totalis.trade#website\"},\"breadcrumb\":{\"@id\":\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Quote service\",\"item\":\"https://docs.totalis.trade/solana/api-reference/quote-service/create\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Commit cashout\",\"item\":\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit#apireference\",\"headline\":\"Commit cashout\",\"name\":\"Commit cashout\",\"description\":\"Accept the winning bid on an early cashout auction and drive it on-chain.\",\"url\":\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit\",\"mainEntityOfPage\":{\"@id\":\"https://docs.totalis.trade/solana/api-reference/quote-service/cashout-commit#webpage\"},\"image\":\"https://docs.totalis.trade/totalis.png\",\"dateModified\":\"2026-11-14T00:55:06.001Z\",\"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":"/solana/api-reference/quote-service/cashout-commit.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","pages":[{"title":"Hyperliquid","href":"/hyperliquid"}]},{"product":"Solana","description":"Parlays across Kalshi and Polymarket, settled on Solana","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/solana"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API overview","href":"/solana/api-reference/introduction"},{"title":"Errors","href":"/solana/errors"}]},{"group":"Quote service","pages":[{"title":"Create quote request","api":"POST /v1/quote-requests","href":"/solana/api-reference/quote-service/create"},{"title":"Update quote request","api":"PATCH /v1/quote-requests/{id}","href":"/solana/api-reference/quote-service/update"},{"title":"Get quote request","api":"GET /v1/quote-requests/{id}","href":"/solana/api-reference/quote-service/get"},{"title":"Commit quote request","api":"POST /v1/quote-requests/{id}/commit","href":"/solana/api-reference/quote-service/commit"},{"title":"Cancel quote request","api":"POST /v1/quote-requests/{id}/cancel","href":"/solana/api-reference/quote-service/cancel"},{"title":"Stream quote updates","api":"GET /v1/quote-requests/{id}/stream","href":"/solana/api-reference/quote-service/stream"},{"title":"Create cashout request","api":"POST /v1/cashout-requests","href":"/solana/api-reference/quote-service/cashout-create"},{"title":"Stream cashout quote","api":"GET /v1/cashout-requests/{id}/stream","description":"Follow the best live bid and terminal status for an early cashout auction via Server-Sent Events.","href":"/solana/api-reference/quote-service/cashout-stream"},{"title":"Commit cashout","api":"POST /v1/cashout-requests/{id}/commit","href":"/solana/api-reference/quote-service/cashout-commit"}]},{"group":"Market maker","pages":[{"title":"Stream quote requests","api":"GET /v1/mm/quote-requests/stream","description":"Subscribe to all active quote requests in real time via Server-Sent Events.","href":"/solana/api-reference/quote-service-mm/stream"},{"title":"Submit or replace quote","api":"PUT /v1/mm/quote-requests/{id}/quote","href":"/solana/api-reference/quote-service-mm/submit-quote"},{"title":"Withdraw quote","api":"DELETE /v1/mm/quote-requests/{id}/quote","href":"/solana/api-reference/quote-service-mm/withdraw-quote"},{"title":"Bid on a cashout auction","api":"PUT /v1/mm/cashout-requests/{id}/quote","href":"/solana/api-reference/quote-service-mm/cashout-quote"},{"title":"List quotes","api":"GET /v1/mm/quotes","href":"/solana/api-reference/mm/list-quotes"},{"title":"Confirm quote","api":"POST /v1/mm/quotes/{quoteId}/confirm","href":"/solana/api-reference/mm/confirm-quote"},{"title":"List positions","api":"GET /v1/mm/positions","href":"/solana/api-reference/mm/list-positions"},{"title":"Get position","api":"GET /v1/mm/positions/{id}","href":"/solana/api-reference/mm/get-position"}]},{"group":"Markets","pages":[{"title":"List markets","openapi":"GET /markets","href":"/solana/api-reference/markets/list"},{"title":"List markets (flat)","openapi":"GET /v1/markets/list","href":"/solana/api-reference/markets/list-flat"},{"title":"Get market","openapi":"GET /markets/{ticker}","href":"/solana/api-reference/markets/get"}]},{"group":"Parlays","pages":[{"title":"List parlays","openapi":"GET /v1/rfqs","href":"/solana/api-reference/parlays/list"},{"title":"Get parlay","openapi":"GET /v1/rfqs/{id}","href":"/solana/api-reference/parlays/get"}]},{"group":"Account","pages":[{"title":"Get profile","openapi":"GET /v1/me","href":"/solana/api-reference/user/get-profile"},{"title":"Update username","openapi":"PUT /v1/username","href":"/solana/api-reference/user/update-username"},{"title":"Check username","openapi":"GET /v1/username/check","href":"/solana/api-reference/user/check-username"},{"title":"Get wallet","openapi":"GET /v1/wallet","href":"/solana/api-reference/user/get-wallet"},{"title":"Submit transaction","openapi":"POST /v1/wallet/submit-tx","href":"/solana/api-reference/user/submit-tx"}]},{"group":"API keys","pages":[{"title":"List API keys","openapi":"GET /v1/api-keys","href":"/solana/api-reference/user/list-api-keys"},{"title":"Create API key","openapi":"POST /v1/api-keys","href":"/solana/api-reference/user/create-api-key"},{"title":"Revoke API key","openapi":"DELETE /v1/api-keys/{prefix}","href":"/solana/api-reference/user/revoke-api-key"}]},{"group":"Funds and vault","pages":[{"title":"Get vault","openapi":"GET /v1/vault","href":"/solana/api-reference/funds/get-vault"},{"title":"Deposit into the vault","openapi":"POST /v1/vault/deposit","href":"/solana/api-reference/funds/vault-deposit"},{"title":"Withdraw from the vault","openapi":"POST /v1/vault/withdraw","href":"/solana/api-reference/funds/vault-withdraw"},{"title":"Withdraw to external address","openapi":"POST /v1/wallet/withdraw","href":"/solana/api-reference/funds/wallet-withdraw"},{"title":"Wallet delegation status","openapi":"GET /v1/wallet/delegation-status","href":"/solana/api-reference/funds/delegation-status"},{"title":"Enable trading","openapi":"POST /v1/wallet/enable-trading","href":"/solana/api-reference/funds/enable-trading"},{"title":"Portfolio","openapi":"GET /v1/portfolio","href":"/solana/api-reference/funds/portfolio"},{"title":"P\u0026L timeseries","openapi":"GET /v1/pnl","href":"/solana/api-reference/funds/pnl"}]},{"group":"Webhooks","pages":[{"title":"Get webhook config","openapi":"GET /v1/webhooks","href":"/solana/api-reference/webhooks/get-config"},{"title":"Set webhook config","openapi":"PUT /v1/webhooks","href":"/solana/api-reference/webhooks/set-config"},{"title":"Rotate signing secret","openapi":"POST /v1/webhooks/rotate-secret","href":"/solana/api-reference/webhooks/rotate-secret"},{"title":"List deliveries","openapi":"GET /v1/webhooks/deliveries","href":"/solana/api-reference/webhooks/list-deliveries"},{"title":"Replay delivery","openapi":"POST /v1/webhooks/deliveries/{id}/redeliver","href":"/solana/api-reference/webhooks/redeliver"}]}]}]}]},"basePath":"","title":"Commit cashout - Totalis","buildId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","deploymentId":"dpl_4D8r1dHg6bQcRuBgQyL3z9waJJtn","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-dD8DedlW.js","utils-BgJ6PauS.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-m4sNRkou.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dg97LVEU.js","snippetPresets-C6CxWGOo.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CKiRf67B.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CDY0tBIx.js","shallow-BHHaYlmm.js","getApiPlaygroundDisplay-D6K3-cVX.js","CodeSnippet-BrS3fDep.js","CodeSnippets-Dkf1llUu.js","Page-DOwQSAHT.js","getPastedJson-3JcMsaes.js","icon-CWSTKRsN.js","MethodPill-t_TXGK5I.js","DuplicateIcon-DcjhdAbh.js","createIcon-2JHmGxKn.js","DynamicMarkdown-DMUWO-az.js","SectionHeading-DxvGHAss.js","axios-vUo_bRtp.js"]}