{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Privata","description":"API and SDK for integrating Privata swap aggregator into crypto wallets. 50+ providers, single REST surface, privacy by design.","colors":{"primary":"#7C5CFF","light":"#A491FF","dark":"#4F3BC4"},"logo":{"light":"https://mintcdn.com/privatatechsolutions/lDX6pCB2JU-Aei3K/images/logo-light.svg?fit=max\u0026auto=format\u0026n=lDX6pCB2JU-Aei3K\u0026q=85\u0026s=fc20a83c2622a0423063e75e1acbeb78","dark":"https://mintcdn.com/privatatechsolutions/lDX6pCB2JU-Aei3K/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=lDX6pCB2JU-Aei3K\u0026q=85\u0026s=3e17e3e5236c957093fc36ba5be40747","href":"https://privataswap.com"},"favicon":"https://mintcdn.com/privatatechsolutions/lDX6pCB2JU-Aei3K/images/favicon.svg?fit=max\u0026auto=format\u0026n=lDX6pCB2JU-Aei3K\u0026q=85\u0026s=c9312fdc858ac019d8725a465b1e588a","appearance":{"default":"dark","strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A12"}},"navbar":{"links":[{"href":"https://dashboard.privataswap.com","label":"Dashboard"},{"href":"https://status.privataswap.com","label":"Status"}],"primary":{"type":"button","label":"Get API key","href":"https://dashboard.privataswap.com/signup"}},"footer":{"socials":{"x":"https://x.com/privataswap","github":"https://github.com/privataswap","telegram":"https://t.me/privataswap"},"links":[{"header":"Product","items":[{"label":"Swap","href":"https://privataswap.com"},{"label":"Dashboard","href":"https://dashboard.privataswap.com"},{"label":"Status","href":"https://status.privataswap.com"}]},{"header":"Developers","items":[{"label":"API Reference","href":"https://docs.privataswap.com/api-reference"},{"label":"SDK","href":"https://docs.privataswap.com/sdk/js/install"},{"label":"Changelog","href":"https://docs.privataswap.com/guides/changelog"}]},{"header":"Legal","items":[{"label":"Terms","href":"https://privataswap.com/terms"},{"label":"Privacy","href":"https://privataswap.com/privacy"}]}]},"search":{"prompt":"Ask the Privata docs..."},"seo":{"metatags":{"og:site_name":"Privata Docs","twitter:site":"@privataswap"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-PRIVATA"},"plausible":{"domain":"docs.privataswap.com"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"privatatechsolutions","hasAudioNarration":false,"actualSubdomain":"privatatechsolutions","customDomains":["docs.privataswap.com"],"gitSource":{"type":"github","owner":"v8h6k5bk2w-sketch","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20db7f7ee0972018488a12","collectionId":"9b2b9904-1e39-4269-b760-bf68c5b875ea","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a20db7f7ee0972018488a12:success","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"Guides","count":15},{"language":"default","tag":"Endpoints","count":15},{"language":"default","tag":"SDK","count":7},{"language":"default","tag":"Operations","count":6},{"language":"default","tag":"Core flows","count":6},{"language":"default","tag":"JavaScript / TypeScript","count":5},{"language":"default","tag":"Public","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Compatibility layers","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/orders/create-an-exchange-order","slug":"/api-reference/orders/create-an-exchange-order","pageMetadata":{"title":"Create an exchange order","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /order/create","href":"/api-reference/orders/create-an-exchange-order","autogeneratedByOpenApi":true},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create an exchange order","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /order/create","href":"/api-reference/orders/create-an-exchange-order","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Orders"],"summary":"Create an exchange order","requestBody":"b5c7ed35-b34f-4151-ae84-b208a5dfd508","responses":{"201":"f7146278-ecec-42cf-bde2-a79cedee03cd","400":"73d12f9f-5057-4b0f-a0f4-d6df27c4b317","409":"a0202c58-1f2d-4515-9c20-99180d075597"},"method":"post","type":"path","servers":["84d11cf7-2e78-44ca-af6e-c9ba23aef459","2183c1cd-6640-40cb-aeb5-0a7b5c5417c5"],"security":["cc3930b7-bf67-4952-abee-d3659f697bbd"],"path":"/order/create","baseUrlOptions":["https://api.privataswap.com/partner/v1","https://api.privataswap.com/v2/exchange"],"title":"Create an exchange order","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["quote_id","address"],"properties":{"quote_id":{"type":"string","isRequired":true,"uniqueKey":"quote_id","typeLabel":"string"},"address":{"type":"string","description":"Payout address.","isRequired":true,"uniqueKey":"address","typeLabel":"string"},"extra_id":{"oneOf":[{"type":"string","description":"Memo for XRP/XLM/TON.","uniqueKey":"extra_id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Memo for XRP/XLM/TON.","uniqueKey":"extra_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"extra_id","typeLabel":"string | null"},"refund_address":{"oneOf":[{"type":"string","uniqueKey":"refund_address.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"refund_address.oneOf.1","typeLabel":"null"}],"uniqueKey":"refund_address","typeLabel":"string | null"},"refund_extra_id":{"oneOf":[{"type":"string","uniqueKey":"refund_extra_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"refund_extra_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"refund_extra_id","typeLabel":"string | null"},"refund_preference":{"type":"object","properties":{"default":{"type":"string","enum":["return_to_refund_address","convert_to_stable"],"default":"return_to_refund_address","uniqueKey":"refund_preference.default","typeLabel":"enum\u003cstring>"},"fallback_if_refund_address_missing":{"type":"string","enum":["manual_review","convert_to_stable"],"default":"manual_review","uniqueKey":"refund_preference.fallback_if_refund_address_missing","typeLabel":"enum\u003cstring>"},"convert_to_stable_target":{"oneOf":[{"type":"string","enum":["USDT-TRC20","USDT-ERC20","USDC-ERC20","USDC-SOL",null],"uniqueKey":"refund_preference.convert_to_stable_target.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["USDT-TRC20","USDT-ERC20","USDC-ERC20","USDC-SOL",null],"uniqueKey":"refund_preference.convert_to_stable_target.oneOf.1","typeLabel":"null"}],"uniqueKey":"refund_preference.convert_to_stable_target","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"refund_preference","typeLabel":"object"},"partner_order_ref":{"type":"string","description":"Your internal id. Returned back in webhooks. Used for logical-dupe detection.","uniqueKey":"partner_order_ref","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"quote_id":"\u003cstring>","address":"\u003cstring>","extra_id":"\u003cstring>","refund_address":"\u003cstring>","refund_extra_id":"\u003cstring>","refund_preference":{"default":"return_to_refund_address","fallback_if_refund_address_missing":"manual_review"},"partner_order_ref":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f7146278-ecec-42cf-bde2-a79cedee03cd":{"description":"Created","content":{"application/json":{"schema":{"type":"object","properties":{"order_id":{"type":"string","example":"prv-9f0e...","uniqueKey":"order_id","typeLabel":"string"},"provider_order_id":{"type":"string","uniqueKey":"provider_order_id","typeLabel":"string"},"from":{"type":"string","uniqueKey":"from","typeLabel":"string"},"to":{"type":"string","uniqueKey":"to","typeLabel":"string"},"amount_from":{"type":"string","uniqueKey":"amount_from","typeLabel":"string"},"amount_to_expected":{"type":"string","uniqueKey":"amount_to_expected","typeLabel":"string"},"amount_to_actual":{"oneOf":[{"type":"string","uniqueKey":"amount_to_actual.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"amount_to_actual.oneOf.1","typeLabel":"null"}],"uniqueKey":"amount_to_actual","typeLabel":"string | null"},"deposit_address":{"type":"string","uniqueKey":"deposit_address","typeLabel":"string"},"deposit_extra_id":{"oneOf":[{"type":"string","uniqueKey":"deposit_extra_id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"deposit_extra_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"deposit_extra_id","typeLabel":"string | null"},"payout_address":{"type":"string","uniqueKey":"payout_address","typeLabel":"string"},"status":{"type":"string","enum":["waiting_deposit","confirming","exchanging","sending","completed","failed","expired","refund_required","refunded","manual_review"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"failed_reason_code":{"oneOf":[{"type":"string","enum":["kyt_block","amount_out_of_range","rate_changed","provider_timeout","provider_internal","underpayment","overpayment","network_congestion","unknown"],"uniqueKey":"failed_reason_code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["kyt_block","amount_out_of_range","rate_changed","provider_timeout","provider_internal","underpayment","overpayment","network_congestion","unknown"],"uniqueKey":"failed_reason_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"failed_reason_code","typeLabel":"enum\u003cstring> | null"},"failed_reason_message":{"oneOf":[{"type":"string","uniqueKey":"failed_reason_message.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"failed_reason_message.oneOf.1","typeLabel":"null"}],"uniqueKey":"failed_reason_message","typeLabel":"string | null"},"refund_capability":{"type":"string","enum":["programmatic","ticket","none"],"uniqueKey":"refund_capability","typeLabel":"enum\u003cstring>"},"refund_window_hours":{"oneOf":[{"type":"integer","uniqueKey":"refund_window_hours.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"refund_window_hours.oneOf.1","typeLabel":"null"}],"uniqueKey":"refund_window_hours","typeLabel":"integer | null"},"refund_sla_hours":{"oneOf":[{"type":"integer","uniqueKey":"refund_sla_hours.oneOf.0","typeLabel":"integer"},{"type":"null","uniqueKey":"refund_sla_hours.oneOf.1","typeLabel":"null"}],"uniqueKey":"refund_sla_hours","typeLabel":"integer | null"},"tx_in_hash":{"oneOf":[{"type":"string","uniqueKey":"tx_in_hash.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"tx_in_hash.oneOf.1","typeLabel":"null"}],"uniqueKey":"tx_in_hash","typeLabel":"string | null"},"tx_out_hash":{"oneOf":[{"type":"string","uniqueKey":"tx_out_hash.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"tx_out_hash.oneOf.1","typeLabel":"null"}],"uniqueKey":"tx_out_hash","typeLabel":"string | null"},"expires_at":{"type":"string","format":"date-time","uniqueKey":"expires_at","typeLabel":"string\u003cdate-time>"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"tracking_url":{"type":"string","format":"uri","description":"Signed URL with embedded HMAC token. Do not modify.","uniqueKey":"tracking_url","typeLabel":"string\u003curi>"},"timeline":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"timeline.items.[INDEX].status","typeLabel":"string"},"at":{"type":"string","format":"date-time","uniqueKey":"timeline.items.[INDEX].at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"timeline.items.[INDEX]","typeLabel":"object"},"uniqueKey":"timeline","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"order_id":"prv-9f0e...","provider_order_id":"\u003cstring>","from":"\u003cstring>","to":"\u003cstring>","amount_from":"\u003cstring>","amount_to_expected":"\u003cstring>","amount_to_actual":"\u003cstring>","deposit_address":"\u003cstring>","deposit_extra_id":"\u003cstring>","payout_address":"\u003cstring>","status":"waiting_deposit","failed_reason_code":"kyt_block","failed_reason_message":"\u003cstring>","refund_capability":"programmatic","refund_window_hours":123,"refund_sla_hours":123,"tx_in_hash":"\u003cstring>","tx_out_hash":"\u003cstring>","expires_at":"2023-11-07T05:31:56Z","created_at":"2023-11-07T05:31:56Z","tracking_url":"\u003cstring>","timeline":[{"status":"\u003cstring>","at":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"73d12f9f-5057-4b0f-a0f4-d6df27c4b317":{"description":"Error response","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["INVALID_KEY","RATE_LIMITED","INVALID_PAIR","AMOUNT_TOO_LOW","AMOUNT_TOO_HIGH","NO_PROVIDERS_AVAILABLE","PROVIDER_ERROR","QUOTE_EXPIRED","ORDER_NOT_FOUND","DUPLICATE_ACTIVE_ORDER","REFUND_WINDOW_EXPIRED","REFUND_NOT_PROGRAMMATIC","STABLE_TARGET_REQUIRED","WEBHOOK_PAUSED","SCOPE_REQUIRED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_KEY","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a0202c58-1f2d-4515-9c20-99180d075597":{"description":"DUPLICATE_ACTIVE_ORDER","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["INVALID_KEY","RATE_LIMITED","INVALID_PAIR","AMOUNT_TOO_LOW","AMOUNT_TOO_HIGH","NO_PROVIDERS_AVAILABLE","PROVIDER_ERROR","QUOTE_EXPIRED","ORDER_NOT_FOUND","DUPLICATE_ACTIVE_ORDER","REFUND_WINDOW_EXPIRED","REFUND_NOT_PROGRAMMATIC","STABLE_TARGET_REQUIRED","WEBHOOK_PAUSED","SCOPE_REQUIRED"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","uniqueKey":"error.request_id","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_KEY","message":"\u003cstring>","request_id":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"cc3930b7-bf67-4952-abee-d3659f697bbd":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Partner API key issued in the dashboard. Use `pk_live_...` in production, `pk_test_...` against sandbox.","scopes":[]}}},"servers":{"84d11cf7-2e78-44ca-af6e-c9ba23aef459":{"url":"https://api.privataswap.com/partner/v1","description":"Production"},"2183c1cd-6640-40cb-aeb5-0a7b5c5417c5":{"url":"https://api.privataswap.com/v2/exchange","description":"ChangeNOW-compatible layer (legacy clients)"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Partner API key issued in the dashboard. Use `pk_live_...` in production, `pk_test_...` against sandbox.","scopes":[]},"schema":{"title":"X-API-Key","type":"string","description":"Partner API key issued in the dashboard. Use `pk_live_...` in production, `pk_test_...` against sandbox.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-Key"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"privatatechsolutions","siteName":"Privata","title":"Create an exchange order - Privata","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-21T13:38:06.443Z","originalFileLocation":"api-reference/orders/create-an-exchange-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=\"dark\"}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=\"application-name\" content=\"Privata\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/privatatechsolutions/_WPhL6e-GTSBUR3d/_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/privatatechsolutions/_WPhL6e-GTSBUR3d/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/privatatechsolutions/_WPhL6e-GTSBUR3d/_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/privatatechsolutions/_WPhL6e-GTSBUR3d/_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/privatatechsolutions/_WPhL6e-GTSBUR3d/_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/privatatechsolutions/_WPhL6e-GTSBUR3d/_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/privatatechsolutions/_WPhL6e-GTSBUR3d/_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/privatatechsolutions/_WPhL6e-GTSBUR3d/_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/privatatechsolutions/_WPhL6e-GTSBUR3d/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an exchange order - Privata\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Privata Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://privatatechsolutions.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Create+an+exchange+order\u0026amp;theme=6d6b49908bf389be4af9e72d\u0026amp;signature=adde0cc1c5c62edd44f84cec8a90f75f8802008672a1f4f6c75f735622778201\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create an exchange order - Privata\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://privatatechsolutions.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Create+an+exchange+order\u0026amp;theme=6d6b49908bf389be4af9e72d\u0026amp;signature=adde0cc1c5c62edd44f84cec8a90f75f8802008672a1f4f6c75f735622778201\">\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/privatatechsolutions/_WPhL6e-GTSBUR3d/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Privata\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C5CFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-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/orders/create-an-exchange-order.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.privataswap.com/#organization\",\"name\":\"Privata\",\"url\":\"https://docs.privataswap.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/privatatechsolutions/lDX6pCB2JU-Aei3K/images/logo-light.svg?fit=max\u0026auto=format\u0026n=lDX6pCB2JU-Aei3K\u0026q=85\u0026s=fc20a83c2622a0423063e75e1acbeb78\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.privataswap.com#website\",\"name\":\"Privata\",\"url\":\"https://docs.privataswap.com\",\"publisher\":{\"@id\":\"https://docs.privataswap.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order#webpage\",\"url\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order\",\"name\":\"Create an exchange order\",\"dateModified\":\"2026-05-21T13:38:06.443Z\",\"isPartOf\":{\"@id\":\"https://docs.privataswap.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.privataswap.com/api-reference/public/list-supported-currencies\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an exchange order\",\"item\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order#apireference\",\"headline\":\"Create an exchange order\",\"name\":\"Create an exchange order\",\"url\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order\",\"mainEntityOfPage\":{\"@id\":\"https://docs.privataswap.com/api-reference/orders/create-an-exchange-order#webpage\"},\"dateModified\":\"2026-05-21T13:38:06.443Z\",\"publisher\":{\"@id\":\"https://docs.privataswap.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.privataswap.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Privata\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Privata","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Endpoints","pages":[{"group":"Public","pages":[{"title":"List supported currencies","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /currencies","href":"/api-reference/public/list-supported-currencies"},{"title":"List supported pairs","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /pairs","href":"/api-reference/public/list-supported-pairs"},{"title":"Get best-rate estimate for a swap","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /estimate","href":"/api-reference/public/get-best-rate-estimate-for-a-swap"},{"title":"Get min/max amounts for a pair","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /limits","href":"/api-reference/public/get-minmax-amounts-for-a-pair"}]},{"group":"Orders","pages":[{"title":"Create an exchange order","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /order/create","href":"/api-reference/orders/create-an-exchange-order"},{"title":"Get order status","description":null,"deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /order/{order_id}","href":"/api-reference/orders/get-order-status"}]},{"group":"Streaming","pages":[{"title":"Subscribe to order status via SSE","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /order/{order_id}/stream","href":"/api-reference/streaming/subscribe-to-order-status-via-sse"}]},{"group":"Refunds","pages":[{"title":"Confirm refund action for an order in refund_required state","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /order/{order_id}/refund-action","href":"/api-reference/refunds/confirm-refund-action-for-an-order-in-refund_required-state"},{"title":"List providers and their refund mode","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /providers/refund-capability","href":"/api-reference/refunds/list-providers-and-their-refund-mode"}]},{"group":"Webhooks","pages":[{"title":"Manually resume a paused webhook","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml post /webhook/resume","href":"/api-reference/webhooks/manually-resume-a-paused-webhook"}]},{"group":"Partner","pages":[{"title":"Get partner profile and aggregate stats","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /me","href":"/api-reference/partner/get-partner-profile-and-aggregate-stats"},{"title":"List partner orders","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /me/orders","href":"/api-reference/partner/list-partner-orders"}]},{"group":"Health","pages":[{"title":"Uptime probe endpoint","deprecated":null,"version":null,"openapi":"/api-reference/openapi.yaml get /health","href":"/api-reference/health/uptime-probe-endpoint"}]},{"group":"API Reference","pages":[{"title":"Order lifecycle event","version":null,"deprecated":null,"openapi":"/api-reference/openapi.yaml webhook order.event","href":"/api-reference/order-lifecycle-event"},{"title":"Operational event for partner integration","version":null,"deprecated":null,"openapi":"/api-reference/openapi.yaml webhook ops.event","href":"/api-reference/operational-event-for-partner-integration"}]}]}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/js/install"}]}]},"title":"Create an exchange order - Privata","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}