Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market’s batch-auction cadence (see the market’s batchAuctionIntervalMs), so a 201 response means the order was admitted, not necessarily filled.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"XentFi API Documentation","colors":{"primary":"#F5A623","light":"#FFDE91","dark":"#E09515"},"logo":{"light":"https://mintcdn.com/xentfi/nt7OxiXA-10q40ko/logo/logo-light.png?fit=max\u0026auto=format\u0026n=nt7OxiXA-10q40ko\u0026q=85\u0026s=16c34a61758b9de6b5424ed250c09789","dark":"https://mintcdn.com/xentfi/nt7OxiXA-10q40ko/logo/logo-dark.png?fit=max\u0026auto=format\u0026n=nt7OxiXA-10q40ko\u0026q=85\u0026s=3f71f7865e6c676be30074e3a6d0679b"},"favicon":"https://mintcdn.com/xentfi/nt7OxiXA-10q40ko/logo/favicon-16x16.png?fit=max\u0026auto=format\u0026n=nt7OxiXA-10q40ko\u0026q=85\u0026s=cf57780c07c8f0c9326c3f300499dc45","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","javascript","python","go","typescript"],"prefill":true,"autogenerate":true}},"navbar":{"links":[{"href":"https://dashboard.xentfi.com","label":"Dashboard"},{"href":"mailto:support@xentfi.com","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/xentfi","github":"https://github.com/xentfi","discord":"https://discord.gg/xentfi"}},"contextual":{"options":["copy","chatgpt","assistant"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"xentfi","hasAudioNarration":false,"actualSubdomain":"xentfi","customDomains":["docs.xentfi.com"],"gitSource":{"type":"github","owner":"xentfi","repo":"xentfi-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aef630559edac7bace6ab9c","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":134},{"language":"default","tag":"XentFi Pro","count":21},{"language":"default","tag":"Documentation","count":13},{"language":"default","tag":"Getting Started","count":12},{"language":"default","tag":"Agents","count":11},{"language":"default","tag":"Addresses","count":10},{"language":"default","tag":"Auto Settlement","count":10},{"language":"default","tag":"Off-ramp","count":10},{"language":"default","tag":"Agent Self","count":9},{"language":"default","tag":"Master Wallets","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/orderbook/place-an-order","slug":"/api-reference/orderbook/place-an-order","pageMetadata":{"title":"Place an order","description":"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market's batch-auction cadence (see the market's `batchAuctionIntervalMs`), so a 201 response means the order was admitted, not necessarily filled.\n","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml post /v1/orderbook/orders","href":"/api-reference/orderbook/place-an-order","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {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(_components.p, {\n children: [\"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market’s batch-auction cadence (see the market’s \", _jsx(_components.code, {\n children: \"batchAuctionIntervalMs\"\n }), \"), so a 201 response means the order was admitted, not necessarily filled.\"]\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":"Place an order","description":"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market's batch-auction cadence (see the market's `batchAuctionIntervalMs`), so a 201 response means the order was admitted, not necessarily filled.\n","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml post /v1/orderbook/orders","href":"/api-reference/orderbook/place-an-order","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["OrderBook"],"summary":"Place an order","description":"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market's batch-auction cadence (see the market's `batchAuctionIntervalMs`), so a 201 response means the order was admitted, not necessarily filled.\n","operationId":"placeOrder","security":["48517214-4cdd-43ac-bf68-143d16d36eb7"],"requestBody":"0b0af2fd-a09b-4291-af1e-5b3ffc2b2d0b","responses":{"201":"cae1a324-3ade-4ac2-9fd9-af59af07078d","400":"1404609f-239a-42f5-b0a4-a91d10bef24b","401":"d032e625-8586-4cdc-888d-88ddbc9882ac","404":"efd94077-90dd-4da9-99b5-73e5b3bf9e25","409":"2094909f-d508-4f15-b11e-4aad52b40b16"},"method":"post","type":"path","servers":["e721a284-d86d-460c-bf00-7b7c180c5ffc"],"path":"/v1/orderbook/orders","baseUrlOptions":["https://api.pro.xentfi.com"],"title":"Place an order","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go","typescript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.marketSymbol":"USDC-USDT","body.walletId":"\u003cstring>","body.quantity":"\u003cstring>","body.clientOrderId":"\u003cstring>","body.price":"\u003cstring>"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["marketSymbol","walletId","side","type","timeInForce","quantity","clientOrderId"],"properties":{"marketSymbol":{"type":"string","example":"USDC-USDT","isRequired":true,"uniqueKey":"marketSymbol","typeLabel":"string"},"walletId":{"type":"string","description":"Xentfi WaaS child wallet ID placing the order","isRequired":true,"uniqueKey":"walletId","typeLabel":"string"},"side":{"type":"string","enum":["BUY","SELL"],"isRequired":true,"uniqueKey":"side","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["LIMIT","MARKET","POST_ONLY","IOC","FOK"],"isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"timeInForce":{"type":"string","enum":["GTC","IOC","FOK","GTT"],"isRequired":true,"uniqueKey":"timeInForce","typeLabel":"enum\u003cstring>"},"quantity":{"type":"string","description":"Base asset units. Decimal string.","isRequired":true,"uniqueKey":"quantity","typeLabel":"string"},"clientOrderId":{"type":"string","description":"Caller-supplied idempotency key, unique per organisation+app.","isRequired":true,"uniqueKey":"clientOrderId","typeLabel":"string"},"price":{"type":"string","description":"Required for LIMIT and POST_ONLY orders. Decimal string.","uniqueKey":"price","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"marketSymbol":"USDC-USDT","walletId":"\u003cstring>","quantity":"\u003cstring>","clientOrderId":"\u003cstring>","price":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"cae1a324-3ade-4ac2-9fd9-af59af07078d":{"description":"Order admitted","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","uniqueKey":"data.id","typeLabel":"string"},"organisationId":{"type":"string","uniqueKey":"data.organisationId","typeLabel":"string"},"appId":{"type":"string","uniqueKey":"data.appId","typeLabel":"string"},"marketId":{"type":"string","uniqueKey":"data.marketId","typeLabel":"string"},"walletId":{"type":"string","uniqueKey":"data.walletId","typeLabel":"string"},"clientOrderId":{"type":"string","uniqueKey":"data.clientOrderId","typeLabel":"string"},"side":{"type":"string","enum":["BUY","SELL"],"uniqueKey":"data.side","typeLabel":"enum\u003cstring>"},"type":{"type":"string","enum":["LIMIT","MARKET","POST_ONLY","IOC","FOK"],"uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"timeInForce":{"type":"string","enum":["GTC","IOC","FOK","GTT"],"uniqueKey":"data.timeInForce","typeLabel":"enum\u003cstring>"},"price":{"oneOf":[{"type":"string","uniqueKey":"data.price.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.price.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.price","typeLabel":"string | null"},"quantity":{"type":"string","uniqueKey":"data.quantity","typeLabel":"string"},"filledQuantity":{"type":"string","uniqueKey":"data.filledQuantity","typeLabel":"string"},"reservedBalance":{"type":"string","uniqueKey":"data.reservedBalance","typeLabel":"string"},"status":{"type":"string","enum":["PENDING_RISK","OPEN","PARTIALLY_FILLED","FILLED","CANCELLED","REJECTED"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"rejectReason":{"oneOf":[{"type":"string","uniqueKey":"data.rejectReason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.rejectReason.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.rejectReason","typeLabel":"string | null"},"sequence":{"oneOf":[{"type":"string","uniqueKey":"data.sequence.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.sequence.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.sequence","typeLabel":"string | null"},"createdAt":{"type":"string","format":"date-time","uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","organisationId":"\u003cstring>","appId":"\u003cstring>","marketId":"\u003cstring>","walletId":"\u003cstring>","clientOrderId":"\u003cstring>","side":"BUY","type":"LIMIT","timeInForce":"GTC","price":"\u003cstring>","quantity":"\u003cstring>","filledQuantity":"\u003cstring>","reservedBalance":"\u003cstring>","status":"PENDING_RISK","rejectReason":"\u003cstring>","sequence":"\u003cstring>","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1404609f-239a-42f5-b0a4-a91d10bef24b":{"description":"Bad request (validation failure, insufficient balance, price outside band)","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Wallet not found","uniqueKey":"error.message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"Wallet not found","timestamp":"2023-11-07T05:31:56Z","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d032e625-8586-4cdc-888d-88ddbc9882ac":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Wallet not found","uniqueKey":"error.message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"Wallet not found","timestamp":"2023-11-07T05:31:56Z","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"efd94077-90dd-4da9-99b5-73e5b3bf9e25":{"description":"Market not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Wallet not found","uniqueKey":"error.message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"Wallet not found","timestamp":"2023-11-07T05:31:56Z","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2094909f-d508-4f15-b11e-4aad52b40b16":{"description":"This node is not currently the leader for the order's market shard; retry","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"NOT_FOUND","uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Wallet not found","uniqueKey":"error.message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","uniqueKey":"error.timestamp","typeLabel":"string\u003cdate-time>"},"requestId":{"type":"string","uniqueKey":"error.requestId","typeLabel":"string"}},"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"Wallet not found","timestamp":"2023-11-07T05:31:56Z","requestId":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"48517214-4cdd-43ac-bf68-143d16d36eb7":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apiKey","scopes":[]},"OrgIdAuth":{"type":"apiKey","in":"header","name":"orgId","scopes":[]}}},"servers":{"e721a284-d86d-460c-bf00-7b7c180c5ffc":{"url":"https://api.pro.xentfi.com","description":"XentFi Pro production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"apiKey","scopes":[]},"schema":{"title":"apiKey","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"apiKey"},{"scheme":{"type":"apiKey","in":"header","name":"orgId","scopes":[]},"schema":{"title":"orgId","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"OrgIdAuth","name":"orgId"}],"title":"ApiKeyAuth \u0026 OrgIdAuth"}]},"originalFileLocation":"xentfi-pro/openapi.yaml"},"subdomain":"xentfi","siteName":"XentFi API Documentation","title":"Place an order - XentFi API Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-07T17:42:43.330Z","originalFileLocation":"api-reference/orderbook/place-an-order.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=\"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market\u0026#x27;s batch-auction cadence (see the market\u0026#x27;s batchAuctionIntervalMs), so a 201 response means the order was admitted, not necessarily filled.\">\u003cmeta data-mint-head name=\"application-name\" content=\"XentFi API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/xentfi/q_Pzx6ysmqGzPfz2/_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/xentfi/q_Pzx6ysmqGzPfz2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/xentfi/q_Pzx6ysmqGzPfz2/_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/xentfi/q_Pzx6ysmqGzPfz2/_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/xentfi/q_Pzx6ysmqGzPfz2/_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/xentfi/q_Pzx6ysmqGzPfz2/_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/xentfi/q_Pzx6ysmqGzPfz2/_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/xentfi/q_Pzx6ysmqGzPfz2/_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/xentfi/q_Pzx6ysmqGzPfz2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Place an order - XentFi API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market\u0026#x27;s batch-auction cadence (see the market\u0026#x27;s batchAuctionIntervalMs), so a 201 response means the order was admitted, not necessarily filled.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"XentFi API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.xentfi.com/api-reference/orderbook/place-an-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://xentfi.mintlify.site/_mintlify/api/og/v2?division=OrderBook\u0026amp;title=Place+an+order\u0026amp;description=Places+a+LIMIT%2C+MARKET%2C+POST_ONLY%2C+IOC%2C+or+FOK+order+on+the+given+market.+Performs+rate+limiting%2C+price-band+validation%2C+and+an+atomic+balance+reservation+befor\u0026amp;theme=d7876670383a0adff8859ee0\u0026amp;signature=9c1012d7a3433293627e7fcd2b4e630fbcd598f34824e3575be5e5ccfe175ef2\">\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=\"Place an order - XentFi API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market\u0026#x27;s batch-auction cadence (see the market\u0026#x27;s batchAuctionIntervalMs), so a 201 response means the order was admitted, not necessarily filled.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://xentfi.mintlify.site/_mintlify/api/og/v2?division=OrderBook\u0026amp;title=Place+an+order\u0026amp;description=Places+a+LIMIT%2C+MARKET%2C+POST_ONLY%2C+IOC%2C+or+FOK+order+on+the+given+market.+Performs+rate+limiting%2C+price-band+validation%2C+and+an+atomic+balance+reservation+befor\u0026amp;theme=d7876670383a0adff8859ee0\u0026amp;signature=9c1012d7a3433293627e7fcd2b4e630fbcd598f34824e3575be5e5ccfe175ef2\">\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/xentfi/q_Pzx6ysmqGzPfz2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"XentFi API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F5A623\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.xentfi.com/api-reference/orderbook/place-an-order\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/orderbook/place-an-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.xentfi.com/#organization\",\"name\":\"XentFi API Documentation\",\"url\":\"https://docs.xentfi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/xentfi/nt7OxiXA-10q40ko/logo/logo-light.png?fit=max\u0026auto=format\u0026n=nt7OxiXA-10q40ko\u0026q=85\u0026s=16c34a61758b9de6b5424ed250c09789\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.xentfi.com#website\",\"name\":\"XentFi API Documentation\",\"url\":\"https://docs.xentfi.com\",\"publisher\":{\"@id\":\"https://docs.xentfi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order#webpage\",\"url\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order\",\"name\":\"Place an order\",\"description\":\"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market's batch-auction cadence (see the market's batchAuctionIntervalMs), so a 201 response means the order was admitted, not necessarily filled.\",\"dateModified\":\"2026-11-07T17:42:43.330Z\",\"isPartOf\":{\"@id\":\"https://docs.xentfi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"OrderBook\",\"item\":\"https://docs.xentfi.com/api-reference/orderbook/list-orders\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Place an order\",\"item\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order#apireference\",\"headline\":\"Place an order\",\"name\":\"Place an order\",\"description\":\"Places a LIMIT, MARKET, POST_ONLY, IOC, or FOK order on the given market. Performs rate limiting, price-band validation, and an atomic balance reservation before the order is admitted to the book. Matching happens asynchronously on the market's batch-auction cadence (see the market's batchAuctionIntervalMs), so a 201 response means the order was admitted, not necessarily filled.\",\"url\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.xentfi.com/api-reference/orderbook/place-an-order#webpage\"},\"dateModified\":\"2026-11-07T17:42:43.330Z\",\"publisher\":{\"@id\":\"https://docs.xentfi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.xentfi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"XentFi API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"XentFi API Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"tab":"Agent","icon":"bot","pages":[{"title":"Agent","href":"/agent/introduction"}]},{"tab":"XentFi Pro","icon":"chart-candlestick","groups":[{"group":"Getting Started","pages":[{"title":"XentFi Pro Overview","href":"/xentfi-pro/overview"},{"title":"XentFi Pro Quickstart","href":"/xentfi-pro/quickstart"},{"title":"XentFi Pro Authentication","href":"/xentfi-pro/authentication"}]},{"group":"OrderBook","pages":[{"title":"List orders","description":null,"deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/orders","href":"/api-reference/orderbook/list-orders"},{"title":"Place an order","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml post /v1/orderbook/orders","href":"/api-reference/orderbook/place-an-order"},{"title":"Get an order by ID","description":null,"deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/orders/{orderId}","href":"/api-reference/orderbook/get-an-order-by-id"},{"title":"Cancel an order","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml delete /v1/orderbook/orders/{orderId}","href":"/api-reference/orderbook/cancel-an-order"},{"title":"Get fills for an order","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/orders/{orderId}/trades","href":"/api-reference/orderbook/get-fills-for-an-order"},{"title":"Trade history for a wallet","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/wallets/{walletId}/trades","href":"/api-reference/orderbook/trade-history-for-a-wallet"}]},{"group":"OrderBook Markets","pages":[{"title":"List markets","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/markets","href":"/api-reference/orderbook-markets/list-markets"},{"title":"Create a market (admin)","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml post /v1/orderbook/markets","href":"/api-reference/orderbook-markets/create-a-market-admin"},{"title":"Get market configuration","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/markets/{marketSymbol}","href":"/api-reference/orderbook-markets/get-market-configuration"},{"title":"Update market configuration or status (admin)","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml patch /v1/orderbook/markets/{marketSymbol}","href":"/api-reference/orderbook-markets/update-market-configuration-or-status-admin"},{"title":"Get order book depth snapshot","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/markets/{marketSymbol}/book","href":"/api-reference/orderbook-markets/get-order-book-depth-snapshot"},{"title":"Recent trades for a market","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/markets/{marketSymbol}/trades","href":"/api-reference/orderbook-markets/recent-trades-for-a-market"},{"title":"24-hour ticker statistics","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/markets/{marketSymbol}/ticker","href":"/api-reference/orderbook-markets/24-hour-ticker-statistics"},{"title":"OHLCV candles","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/markets/{marketSymbol}/candles","href":"/api-reference/orderbook-markets/ohlcv-candles"}]},{"group":"OrderBook Settlement","pages":[{"title":"List settlement batches","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/settlement-batches","href":"/api-reference/orderbook-settlement/list-settlement-batches"},{"title":"Get settlement batch status","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/settlement-batches/{batchId}","href":"/api-reference/orderbook-settlement/get-settlement-batch-status"}]},{"group":"OrderBook Ops","pages":[{"title":"Engine node health and shard leadership","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml get /v1/orderbook/status","href":"/api-reference/orderbook-ops/engine-node-health-and-shard-leadership"},{"title":"Authorize a private realtime channel subscription","deprecated":null,"version":null,"openapi":"/xentfi-pro/openapi.yaml post /v1/orderbook/realtime/auth","href":"/api-reference/orderbook-ops/authorize-a-private-realtime-channel-subscription"}]}]},{"tab":"Resources","icon":"book-open","menu":[{"item":"Release Notes","icon":"file-text","pages":[{"title":"Release Notes","href":"/release-notes/changelog"}]},{"item":"Sample Projects","icon":"folder-open","pages":[{"title":"Sample Projects","href":"/projects"}]}],"pages":[{"title":"Resources","href":"/release-notes/changelog"}]}]},"basePath":"","title":"Place an order - XentFi API Documentation","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}