Create a transfer between the client's own accounts
Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. authorization says what that approval covers: a debit of the client’s wallet that funds the move, or an intent its smart wallet signs so the backend can settle it.
POST
/
swaps
Create a transfer between the client's own accounts
Your own key for this write, ^[A-Za-z0-9._:-]{1,128}$. A retry with the same key replays the first answer; the same key with a different request is refused.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"HEVN","description":"HEVN documentation: the whitelabel REST API for linking and operating your customers' own accounts, remote transfers for paying from your own account with a capped key, and how the non-custodial platform underneath works.","colors":{"primary":"#256FAD","light":"#3C8DCE","dark":"#1B527F"},"logo":{"light":"https://mintcdn.com/hevninc/to0nUVRkO9X57VRK/logo/light.svg?fit=max\u0026auto=format\u0026n=to0nUVRkO9X57VRK\u0026q=85\u0026s=0d24037b3480e3fd22fdbc2ea7c2a1bf","dark":"https://mintcdn.com/hevninc/to0nUVRkO9X57VRK/logo/dark.svg?fit=max\u0026auto=format\u0026n=to0nUVRkO9X57VRK\u0026q=85\u0026s=ae6bd68499f79b907f010902b41a52e8"},"favicon":"https://mintcdn.com/hevninc/BoTZRcp0gyv2H79f/favicon.png?fit=max\u0026auto=format\u0026n=BoTZRcp0gyv2H79f\u0026q=85\u0026s=0d529d33047e81a45ef91637a41645b1","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript"]}},"navbar":{"links":[{"href":"https://calendly.com/hevn/hevn","label":"Book a call"}],"primary":{"type":"button","label":"Open app","href":"https://app.gethevn.com"}},"icons":{"library":"lucide"},"markdown":{"instructions":["HEVN accounts are non-custodial in both products. Self-serve (the General tab): the person who owns the email holds the only key and signs for themselves. Whitelabel (the Whitelabel and REST API tabs): the integrator's customer creates and owns their account through Sign in with HEVN, a HEVN-hosted popup on the integrator's site; the integrator's backend holds a developer key, operates linked accounts and books their payouts, and the account holder approves every payout in that popup. The developer key signs only for the integrator's own wallet; it never signs a client's money.","Use HEVN's terms exactly. A rail is a bank route a client can request. A virtual account (bnk_) is an opened rail. Account details are what a payer needs in order to wire money, and arrive in a field named requisites. A client is a customer's own account linked to the integrator through Sign in with HEVN (POST /dapi/v1/connect/sessions, then POST /dapi/v1/clients/link); there is no API call that creates one. The business behind it is the integrator's customer. A contact is a saved destination; a beneficiary is the party at the far end of a fiat payout. Every departure of money is a payout, to a bank account or to a wallet alike.","Never name a banking partner. Say 'a licensed banking partner'.","There are no published fee rates, spreads or minimums. Prices come from a quote on a specific payment; direct pricing questions to HEVN rather than inventing numbers.","The whitelabel API is at /dapi/v1 and takes a developer-key session plus an X-Hevn-Account header. Developer keys have an IP allowlist and no scopes. Remote transfers are at /api/v1/remote_spend_limit and take a remote transfer key (rsl_) in X-Api-Key, bounded by an onchain spend permission the account holder grants. They are different credentials and neither works on the other surface. The HEVN CLI is discontinued."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"hevninc","hasAudioNarration":false,"actualSubdomain":"hevninc","customDomains":[],"gitSource":{"type":"github","owner":"hevn-inc","repo":"docs","deployBranch":"main","isPrivate":false,"contentDirectory":"","mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"agentFeedback":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"}},"buildId":"6af5f1ed510572438570ff24","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"REST API","count":51},{"language":"default","tag":"Whitelabel","count":29},{"language":"default","tag":"General","count":10},{"language":"default","tag":"Escrow","count":8},{"language":"default","tag":"Reference","count":7},{"language":"default","tag":"Clients","count":6},{"language":"default","tag":"Contacts","count":6},{"language":"default","tag":"Core concepts","count":5},{"language":"default","tag":"Verification","count":5},{"language":"default","tag":"Overview","count":4}],"searchSettings":{"showContentSnippets":true}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":false,"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/transfers/create-a-transfer-between-the-clients-own-accounts","slug":"/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts","pageMetadata":{"title":"Create a transfer between the client's own accounts","description":"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. `authorization` says what that approval covers: a `debit` of the client's wallet that funds the move, or an `intent` its smart wallet signs so the backend can settle it.","deprecated":null,"version":null,"openapi":"/openapi.json post /swaps","href":"/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts","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: [\"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. \", _jsx(_components.code, {\n children: \"authorization\"\n }), \" says what that approval covers: a \", _jsx(_components.code, {\n children: \"debit\"\n }), \" of the client’s wallet that funds the move, or an \", _jsx(_components.code, {\n children: \"intent\"\n }), \" its smart wallet signs so the backend can settle it.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create a transfer between the client's own accounts","description":"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. `authorization` says what that approval covers: a `debit` of the client's wallet that funds the move, or an `intent` its smart wallet signs so the backend can settle it.","deprecated":null,"version":null,"openapi":"/openapi.json post /swaps","href":"/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["transfers"],"summary":"Create a transfer between the client's own accounts","description":"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. `authorization` says what that approval covers: a `debit` of the client's wallet that funds the move, or an `intent` its smart wallet signs so the backend can settle it.","operationId":"create_swap_swaps_post","security":["56ebea5c-0165-4c59-bed0-d3cb25965a74"],"parameters":["7edb8e41-dcc4-48d7-b03a-41a9d6324346","b221d791-da5b-4ca2-8bda-bd42516205e7"],"requestBody":"0ac5da91-31ed-4eeb-a957-87e2734919ae","responses":{"201":"f95d86b3-d084-43d9-880e-284e50d94027","422":"3a790d7b-5ff6-4f5d-97d1-cb40ea1aa81e"},"method":"post","type":"path","servers":[],"path":"/swaps","baseUrlOptions":[],"title":"Create a transfer between the client's own accounts","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7edb8e41-dcc4-48d7-b03a-41a9d6324346":{"name":"X-Hevn-Account","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"X-Hevn-Account","description":"The client account to act for, as a `cl_…` id. Omit it to act as yourself.","example":"cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"X-Hevn-Account","description":"The client account to act for, as a `cl_…` id. Omit it to act as yourself.","example":"cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"The client account to act for, as a `cl_…` id. Omit it to act as yourself."},"b221d791-da5b-4ca2-8bda-bd42516205e7":{"name":"Idempotency-Key","in":"header","required":false,"schema":{"oneOf":[{"type":"string","title":"Idempotency-Key","description":"Your own key for this write, `^[A-Za-z0-9._:-]{1,128}$`. A retry with the same key replays the first answer; the same key with a different request is refused.","example":"po-inv-2026-114","uniqueKey":"oneOf.0","typeLabel":"string"},{"type":"null","title":"Idempotency-Key","description":"Your own key for this write, `^[A-Za-z0-9._:-]{1,128}$`. A retry with the same key replays the first answer; the same key with a different request is refused.","example":"po-inv-2026-114","uniqueKey":"oneOf.1","typeLabel":"null"}],"isRequired":false,"uniqueKey":"","typeLabel":"string | null"},"description":"Your own key for this write, `^[A-Za-z0-9._:-]{1,128}$`. A retry with the same key replays the first answer; the same key with a different request is refused."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"sourceAccount":{"type":"string","enum":["USDC","EURC","RD","USDC_ARB","FDIC_USD","FDIC_EUR","KYC_CARDS"],"title":"AccountKey","description":"Account the money leaves.","isRequired":true,"uniqueKey":"sourceAccount","typeLabel":"enum\u003cstring>"},"destinationAccount":{"type":"string","enum":["USDC","EURC","RD","USDC_ARB","FDIC_USD","FDIC_EUR","KYC_CARDS"],"title":"AccountKey","description":"Account the money lands on.","isRequired":true,"uniqueKey":"destinationAccount","typeLabel":"enum\u003cstring>"},"publicKey":{"type":"string","maxLength":512,"minLength":1,"title":"Publickey","description":"Base64 DER SubjectPublicKeyInfo for the registered P-256 developer key.","isRequired":true,"uniqueKey":"publicKey","typeLabel":"string"},"amount":{"oneOf":[{"type":"string","title":"Amount","description":"Exact amount to debit from the source account.","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","example":"500.00","uniqueKey":"amount.oneOf.0","typeLabel":"string"},{"type":"null","title":"Amount","description":"Exact amount to debit from the source account.","uniqueKey":"amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"amount","typeLabel":"string | null"},"amountTo":{"oneOf":[{"type":"string","title":"Amountto","description":"Exact amount the destination account should receive.","pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","example":"500.00","uniqueKey":"amountTo.oneOf.0","typeLabel":"string"},{"type":"null","title":"Amountto","description":"Exact amount the destination account should receive.","uniqueKey":"amountTo.oneOf.1","typeLabel":"null"}],"uniqueKey":"amountTo","typeLabel":"string | null"}},"additionalProperties":false,"type":"object","required":["sourceAccount","destinationAccount","publicKey"],"title":"SwapCreateRequest","uniqueKey":"","typeLabel":"SwapCreateRequest · object"},"examples":{"Example":{"title":"Example","value":{"publicKey":"\u003cstring>","amount":"500.00","amountTo":"500.00"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f95d86b3-d084-43d9-880e-284e50d94027":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"id":{"type":"string","pattern":"^(?:swp_)?[A-Za-z0-9._:\\-]{1,216}$","title":"Id","description":"Stable public identifier for this swap.","examples":["swp_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41"],"isRequired":true,"uniqueKey":"id","typeLabel":"string"},"status":{"type":"string","enum":["awaitingSignature","submitted","settled","failed"],"title":"SwapState","description":"Current public lifecycle status of the swap.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"idempotencyKey":{"type":"string","title":"Idempotencykey","description":"Caller-supplied key that makes an identical retry return this result.","isRequired":true,"uniqueKey":"idempotencyKey","typeLabel":"string"},"sourceAccount":{"type":"string","enum":["USDC","EURC","RD","USDC_ARB","FDIC_USD","FDIC_EUR","KYC_CARDS"],"title":"AccountKey","description":"Account the money leaves.","isRequired":true,"uniqueKey":"sourceAccount","typeLabel":"enum\u003cstring>"},"destinationAccount":{"type":"string","enum":["USDC","EURC","RD","USDC_ARB","FDIC_USD","FDIC_EUR","KYC_CARDS"],"title":"AccountKey","description":"Account the money lands on.","isRequired":true,"uniqueKey":"destinationAccount","typeLabel":"enum\u003cstring>"},"quote":{"properties":{"fromAmount":{"type":"string","title":"Fromamount","description":"Amount debited from the source account.","example":"500.00","isRequired":true,"uniqueKey":"quote.fromAmount","typeLabel":"string"},"fromCurrency":{"type":"string","title":"Fromcurrency","description":"Currency or digital asset debited.","isRequired":true,"uniqueKey":"quote.fromCurrency","typeLabel":"string"},"toAmount":{"type":"string","title":"Toamount","description":"Amount credited to the destination account.","example":"500.00","isRequired":true,"uniqueKey":"quote.toAmount","typeLabel":"string"},"toCurrency":{"type":"string","title":"Tocurrency","description":"Currency or digital asset credited.","isRequired":true,"uniqueKey":"quote.toCurrency","typeLabel":"string"},"rate":{"type":"string","title":"Rate","description":"Conversion rate from the source amount to the destination amount.","example":"500.00","isRequired":true,"uniqueKey":"quote.rate","typeLabel":"string"},"feeAmount":{"type":"string","title":"Feeamount","description":"Total fee charged in feeCurrency.","example":"500.00","isRequired":true,"uniqueKey":"quote.feeAmount","typeLabel":"string"},"feeCurrency":{"type":"string","title":"Feecurrency","description":"Currency in which the fee is charged.","isRequired":true,"uniqueKey":"quote.feeCurrency","typeLabel":"string"},"minimumToAmount":{"oneOf":[{"type":"string","title":"Minimumtoamount","description":"Worst-case amount credited when the route carries slippage.","example":"500.00","uniqueKey":"quote.minimumToAmount.oneOf.0","typeLabel":"string"},{"type":"null","title":"Minimumtoamount","description":"Worst-case amount credited when the route carries slippage.","uniqueKey":"quote.minimumToAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"quote.minimumToAmount","typeLabel":"string | null"},"estimated":{"type":"boolean","title":"Estimated","description":"Whether the delivered amount is an estimate settled later, rather than a locked price.","default":false,"uniqueKey":"quote.estimated","typeLabel":"boolean"},"etaHours":{"oneOf":[{"type":"integer","title":"Etahours","description":"Expected hours until the destination account is credited.","uniqueKey":"quote.etaHours.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Etahours","description":"Expected hours until the destination account is credited.","uniqueKey":"quote.etaHours.oneOf.1","typeLabel":"null"}],"uniqueKey":"quote.etaHours","typeLabel":"integer | null"},"expiresAt":{"oneOf":[{"type":"string","title":"Expiresat","description":"UTC timestamp after which this price is no longer honored.","format":"date-time","uniqueKey":"quote.expiresAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","title":"Expiresat","description":"UTC timestamp after which this price is no longer honored.","uniqueKey":"quote.expiresAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"quote.expiresAt","typeLabel":"string\u003cdate-time> | null"}},"type":"object","required":["fromAmount","fromCurrency","toAmount","toCurrency","rate","feeAmount","feeCurrency"],"title":"SwapQuoteView","description":"Price, fee and conversion terms fixed for this swap.","isRequired":true,"uniqueKey":"quote","typeLabel":"SwapQuoteView · object"},"authorization":{"type":"string","enum":["debit","intent","client"],"title":"AuthorizationKind","description":"Whether the approval authorizes a balance debit or a signature over the swap's terms.","isRequired":true,"uniqueKey":"authorization","typeLabel":"enum\u003cstring>"},"approval":{"properties":{"id":{"type":"string","title":"Id","description":"Single-use approval identifier.","isRequired":true,"uniqueKey":"approval.id","typeLabel":"string"},"payload":{"type":"string","title":"Payload","description":"Base64 canonical authorization payload to sign with the developer key.","isRequired":true,"uniqueKey":"approval.payload","typeLabel":"string"},"expiresAt":{"type":"string","format":"date-time","title":"Expiresat","description":"UTC timestamp after which this approval is refused.","isRequired":true,"uniqueKey":"approval.expiresAt","typeLabel":"string\u003cdate-time>"}},"type":"object","required":["id","payload","expiresAt"],"title":"ApprovalView","description":"Authorization to sign with the developer key before settlement.","isRequired":true,"uniqueKey":"approval","typeLabel":"ApprovalView · object"},"debit":{"oneOf":[{"type":"object","title":"DebitView","description":"Exact on-chain debit used to fund this swap.","required":["address","amount","amountAtomic","token","chainId"],"properties":{"address":{"type":"string","title":"Address","description":"On-chain address receiving the funding debit.","isRequired":true,"uniqueKey":"debit.oneOf.0.address","typeLabel":"string"},"amount":{"type":"string","title":"Amount","description":"Human-readable token amount debited.","example":"500.00","isRequired":true,"uniqueKey":"debit.oneOf.0.amount","typeLabel":"string"},"amountAtomic":{"type":"string","title":"Amountatomic","description":"Integer token amount in the asset's smallest unit.","isRequired":true,"uniqueKey":"debit.oneOf.0.amountAtomic","typeLabel":"string"},"token":{"type":"string","title":"Token","description":"Digital asset debited to fund the transfer.","isRequired":true,"uniqueKey":"debit.oneOf.0.token","typeLabel":"string"},"chainId":{"type":"integer","title":"Chainid","description":"Numeric network identifier on which the debit executes.","isRequired":true,"uniqueKey":"debit.oneOf.0.chainId","typeLabel":"integer"}},"uniqueKey":"debit.oneOf.0","typeLabel":"DebitView · object"},{"type":"null","description":"Exact on-chain debit used to fund this swap.","uniqueKey":"debit.oneOf.1","typeLabel":"null"}],"uniqueKey":"debit","typeLabel":"DebitView · object | null"},"intent":{"oneOf":[{"type":"object","title":"IntentView","description":"Terms authorized by the signature, when this swap is not funded by a debit.","required":["digest","settles"],"properties":{"digest":{"type":"string","title":"Digest","description":"EIP-712 digest of the terms authorized by this approval.","isRequired":true,"uniqueKey":"intent.oneOf.0.digest","typeLabel":"string"},"settles":{"type":"string","title":"Settles","description":"How the backend settles once the intent is authorized.","isRequired":true,"uniqueKey":"intent.oneOf.0.settles","typeLabel":"string"}},"uniqueKey":"intent.oneOf.0","typeLabel":"IntentView · object"},{"type":"null","description":"Terms authorized by the signature, when this swap is not funded by a debit.","uniqueKey":"intent.oneOf.1","typeLabel":"null"}],"uniqueKey":"intent","typeLabel":"IntentView · object | null"}},"type":"object","required":["id","status","idempotencyKey","sourceAccount","destinationAccount","quote","authorization","approval"],"title":"SwapResponse","uniqueKey":"","typeLabel":"SwapResponse · object"},"examples":{"Example":{"title":"Example","value":{"id":"swp_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41","status":"awaitingSignature","idempotencyKey":"\u003cstring>","sourceAccount":"USDC","destinationAccount":"USDC","quote":{"fromAmount":"500.00","fromCurrency":"\u003cstring>","toAmount":"500.00","toCurrency":"\u003cstring>","rate":"500.00","feeAmount":"500.00","feeCurrency":"\u003cstring>","minimumToAmount":"500.00","estimated":false,"etaHours":123,"expiresAt":"2023-11-07T05:31:56Z"},"authorization":"debit","approval":{"id":"\u003cstring>","payload":"\u003cstring>","expiresAt":"2023-11-07T05:31:56Z"},"debit":{"address":"\u003cstring>","amount":"500.00","amountAtomic":"\u003cstring>","token":"\u003cstring>","chainId":123},"intent":{"digest":"\u003cstring>","settles":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"3a790d7b-5ff6-4f5d-97d1-cb40ea1aa81e":{"description":"Request validation failed","content":{"application/json":{"schema":{"properties":{"error":{"properties":{"code":{"type":"string","enum":["invalid_request","validation_failed","invalid_cursor","invalid_id","idempotency_key_invalid","idempotency_key_reused","unauthenticated","token_expired","forbidden","not_found","method_not_allowed","conflict","gone","payload_too_large","rate_limited","provider_unavailable","database_unavailable","internal_error","invalid_credentials","request_expired","challenge_not_found","challenge_consumed","challenge_expired","signature_invalid","key_not_registered","signer_not_attached","wallet_not_linked","approval_consumed","approval_expired","approval_mismatch","signing_policy_refused","login_unavailable","login_mode_unavailable","developer_key_not_found","developer_key_already_exists","account_header_invalid","account_scope_conflict","account_not_found","account_forbidden","account_read_only","account_not_controlled","contact_not_found","quote_not_submitted","quote_not_fundable","funding_mode_unsupported","funding_token_unsupported","insufficient_funds","smart_wallet_not_deployed","wallet_owner_unverified","already_funded","payment_slot_consumed","funding_in_progress","funding_attempt_expired","contact_changed","user_operation_rejected","user_operation_unavailable","transfer_policy_denied","client_creation_not_enabled","client_not_found","link_code_invalid","link_code_expired","client_already_linked","redirect_uri_not_allowed","payout_not_awaiting_signature","verification_not_applicable","profile_locked","contact_not_payable","contact_chain_unsupported","contact_token_unsupported","contact_payment_details_invalid","amount_below_minimum","amount_above_maximum","amount_precision_unsupported","payout_not_found","payout_not_fundable","quote_expired","bundler_rejected","bundler_unavailable","contact_details_invalid","contact_in_use","kyb_incomplete","kyb_documents_processing","kyb_roster_conflict","kyb_subject_conflict","document_not_found","document_type_unsupported","invalid_enum_value","entity_not_found","escrow_not_found","escrow_action_not_found","escrow_not_operated_by_you","escrow_state_changed","action_in_flight","simulation_failed","stale_nonce","amount_out_of_range","amount_not_allowed","window_closed","token_not_supported","receiver_not_a_client","rail_not_found","rail_not_available","payin_not_available","payin_expired","payin_not_found","transaction_not_found","account_unavailable","account_not_supported","swap_not_found","swap_route_unavailable","swap_not_confirmable","intent_not_signable","sandbox_amount_limit_exceeded","sandbox_faucet_balance_too_high"],"title":"PlatformErrorCode","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","title":"Message","description":"Human-readable explanation safe to show to an end user.","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"oneOf":[{"type":"object","title":"Details","description":"Structured context for this error, when available.","additionalProperties":true,"uniqueKey":"error.details.oneOf.0","typeLabel":"Details · object"},{"type":"null","title":"Details","description":"Structured context for this error, when available.","uniqueKey":"error.details.oneOf.1","typeLabel":"null"}],"uniqueKey":"error.details","typeLabel":"Details · object | null"}},"type":"object","required":["code","message"],"title":"PlatformErrorBody","description":"Public error body.","isRequired":true,"uniqueKey":"error","typeLabel":"PlatformErrorBody · object"}},"type":"object","required":["error"],"title":"PlatformErrorResponse","uniqueKey":"","typeLabel":"PlatformErrorResponse · object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"invalid_request","message":"\u003cstring>","details":{}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"56ebea5c-0165-4c59-bed0-d3cb25965a74":{"HTTPBearer":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"HTTPBearer"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"HTTPBearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"hevninc","siteName":"HEVN","title":"Create a transfer between the client's own accounts - HEVN","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T10:43:04.630Z","originalFileLocation":"api-reference/transfers/create-a-transfer-between-the-clients-own-accounts.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=\"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. authorization says what that approval covers: a debit of the client\u0026#x27;s wallet that funds the move, or an intent its smart wallet signs so the backend can settle it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"HEVN\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/hevninc/Mrkw47wG7Tt5G32B/_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/hevninc/Mrkw47wG7Tt5G32B/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/hevninc/Mrkw47wG7Tt5G32B/_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/hevninc/Mrkw47wG7Tt5G32B/_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/hevninc/Mrkw47wG7Tt5G32B/_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/hevninc/Mrkw47wG7Tt5G32B/_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/hevninc/Mrkw47wG7Tt5G32B/_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/hevninc/Mrkw47wG7Tt5G32B/_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/hevninc/Mrkw47wG7Tt5G32B/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a transfer between the client\u0026#x27;s own accounts - HEVN\">\u003cmeta data-mint-head property=\"og:description\" content=\"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. authorization says what that approval covers: a debit of the client\u0026#x27;s wallet that funds the move, or an intent its smart wallet signs so the backend can settle it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"HEVN\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://hevninc.mintlify.site/_mintlify/api/og/v2?division=Swaps\u0026amp;title=Create+a+transfer+between+the+client%27s+own+accounts\u0026amp;description=Price+a+move+between+two+accounts+the+client+owns%2C+reserve+it+idempotently+and+return+the+approval+to+sign.+%60authorization%60+says+what+that+approval+covers%3A+a+%60d\u0026amp;theme=aed7afc4fc65302f1c71cd72\u0026amp;signature=460a1c5a80fac6ea43b73aab57aa6b7e8fc7f372e44e9d7f69e6c0624fb164ad\">\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 a transfer between the client\u0026#x27;s own accounts - HEVN\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. authorization says what that approval covers: a debit of the client\u0026#x27;s wallet that funds the move, or an intent its smart wallet signs so the backend can settle it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://hevninc.mintlify.site/_mintlify/api/og/v2?division=Swaps\u0026amp;title=Create+a+transfer+between+the+client%27s+own+accounts\u0026amp;description=Price+a+move+between+two+accounts+the+client+owns%2C+reserve+it+idempotently+and+return+the+approval+to+sign.+%60authorization%60+says+what+that+approval+covers%3A+a+%60d\u0026amp;theme=aed7afc4fc65302f1c71cd72\u0026amp;signature=460a1c5a80fac6ea43b73aab57aa6b7e8fc7f372e44e9d7f69e6c0624fb164ad\">\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/hevninc/Mrkw47wG7Tt5G32B/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"HEVN\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#256FAD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://hevninc.mintlify.app/#organization\",\"name\":\"HEVN\",\"url\":\"https://hevninc.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/hevninc/to0nUVRkO9X57VRK/logo/light.svg?fit=max\u0026auto=format\u0026n=to0nUVRkO9X57VRK\u0026q=85\u0026s=0d24037b3480e3fd22fdbc2ea7c2a1bf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://hevninc.mintlify.app#website\",\"name\":\"HEVN\",\"url\":\"https://hevninc.mintlify.app\",\"publisher\":{\"@id\":\"https://hevninc.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts#webpage\",\"url\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts\",\"name\":\"Create a transfer between the client's own accounts\",\"description\":\"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. authorization says what that approval covers: a debit of the client's wallet that funds the move, or an intent its smart wallet signs so the backend can settle it.\",\"dateModified\":\"2026-10-23T10:43:04.630Z\",\"isPartOf\":{\"@id\":\"https://hevninc.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"HEVN\",\"item\":\"https://hevninc.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a transfer between the client's own accounts\",\"item\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts#apireference\",\"headline\":\"Create a transfer between the client's own accounts\",\"name\":\"Create a transfer between the client's own accounts\",\"description\":\"Price a move between two accounts the client owns, reserve it idempotently and return the approval to sign. authorization says what that approval covers: a debit of the client's wallet that funds the move, or an intent its smart wallet signs so the backend can settle it.\",\"url\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts\",\"mainEntityOfPage\":{\"@id\":\"https://hevninc.mintlify.app/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts#webpage\"},\"dateModified\":\"2026-10-23T10:43:04.630Z\",\"publisher\":{\"@id\":\"https://hevninc.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://hevninc.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"HEVN\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"HEVN\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts.md","siteName":"HEVN","nav":{"global":null,"tabs":[{"tab":"General","pages":[{"title":"General","href":"/general/what-is-hevn"}]},{"tab":"Remote Transfers","pages":[{"title":"Remote Transfers","href":"/remote-transfers/overview"}]},{"tab":"Whitelabel","pages":[{"title":"Whitelabel","href":"/whitelabel/overview"}]},{"tab":"REST API","groups":[{"group":"Overview","pages":[{"title":"REST API overview","href":"/api-reference/overview"},{"title":"API authentication","href":"/api-reference/authentication"}]},{"group":"Authentication","pages":[{"title":"Start a developer-key login and receive the payload to sign","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/challenge","href":"/api-reference/auth/start-a-developer-key-login-and-receive-the-payload-to-sign"},{"title":"Exchange a signed login challenge for a session","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/token","href":"/api-reference/auth/exchange-a-signed-login-challenge-for-a-session"},{"title":"Exchange a refresh token for a session, optionally acting for an account","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/refresh","href":"/api-reference/auth/exchange-a-refresh-token-for-a-session-optionally-acting-for-an-account"}]},{"group":"Clients","pages":[{"title":"Create a sign-in window session","deprecated":null,"version":null,"openapi":"/openapi.json post /connect/sessions","href":"/api-reference/accounts/create-a-sign-in-window-session"},{"title":"Connect an existing account","deprecated":null,"version":null,"openapi":"/openapi.json post /clients/link","href":"/api-reference/accounts/connect-an-existing-account"},{"title":"List clients","deprecated":null,"version":null,"openapi":"/openapi.json get /clients","href":"/api-reference/accounts/list-clients"},{"title":"Retrieve one account","deprecated":null,"version":null,"openapi":"/openapi.json get /client","href":"/api-reference/accounts/retrieve-one-account"},{"title":"Update a client profile","deprecated":null,"version":null,"openapi":"/openapi.json patch /client","href":"/api-reference/accounts/update-a-client-profile"},{"title":"Read a client's balances","deprecated":null,"version":null,"openapi":"/openapi.json get /client/balance","href":"/api-reference/accounts/read-a-clients-balances"}]},{"group":"Verification","pages":[{"title":"Provide applicant information","deprecated":null,"version":null,"openapi":"/openapi.json put /client/kyb","href":"/api-reference/verification/provide-applicant-information"},{"title":"Retrieve the verification submission","deprecated":null,"version":null,"openapi":"/openapi.json get /client/kyb","href":"/api-reference/verification/retrieve-the-verification-submission"},{"title":"Complete the verification submission","deprecated":null,"version":null,"openapi":"/openapi.json post /client/kyb/complete","href":"/api-reference/verification/complete-the-verification-submission"},{"title":"Upload a document","deprecated":null,"version":null,"openapi":"/openapi.json post /documents","href":"/api-reference/documents/upload-a-document"},{"title":"Fill the typed fields read off a document","deprecated":null,"version":null,"openapi":"/openapi.json put /documents/{documentId}/content","href":"/api-reference/documents/fill-the-typed-fields-read-off-a-document"}]},{"group":"Virtual accounts","pages":[{"title":"List virtual accounts and available payment methods","deprecated":null,"version":null,"openapi":"/openapi.json get /banks","href":"/api-reference/virtual-accounts/list-virtual-accounts-and-available-payment-methods"},{"title":"Request a receiving account for a product","deprecated":null,"version":null,"openapi":"/openapi.json post /banks","href":"/api-reference/virtual-accounts/request-a-receiving-account-for-a-product"},{"title":"Retrieve one virtual account","deprecated":null,"version":null,"openapi":"/openapi.json get /banks/{product}","href":"/api-reference/virtual-accounts/retrieve-one-virtual-account"},{"title":"Retrieve the receiving conversion rate","deprecated":null,"version":null,"openapi":"/openapi.json get /banks/{product}/rate","href":"/api-reference/virtual-accounts/retrieve-the-receiving-conversion-rate"}]},{"group":"Money in","pages":[{"title":"Create an incoming transfer quote","deprecated":null,"version":null,"openapi":"/openapi.json post /payins","href":"/api-reference/transfers/create-an-incoming-transfer-quote"},{"title":"Open the incoming transfer and retrieve funding instructions","deprecated":null,"version":null,"openapi":"/openapi.json post /payins/{payinId}/instructions","href":"/api-reference/transfers/open-the-incoming-transfer-and-retrieve-funding-instructions"},{"title":"Retrieve an incoming transfer","deprecated":null,"version":null,"openapi":"/openapi.json get /payins/{payinId}","href":"/api-reference/transfers/retrieve-an-incoming-transfer"}]},{"group":"Money out","pages":[{"title":"Create an outgoing transfer","deprecated":null,"version":null,"openapi":"/openapi.json post /payouts","href":"/api-reference/transfers/create-an-outgoing-transfer"},{"title":"Create an outgoing transfer quote","deprecated":null,"version":null,"openapi":"/openapi.json post /payouts/preview","href":"/api-reference/transfers/create-an-outgoing-transfer-quote"},{"title":"Authorize an outgoing transfer","deprecated":null,"version":null,"openapi":"/openapi.json post /payouts/{payoutId}/confirm","href":"/api-reference/transfers/authorize-an-outgoing-transfer"},{"title":"Retrieve an outgoing transfer","description":"Retrieve the current transfer lifecycle, including quote, contact, settlement result and any actionable failure.","deprecated":null,"version":null,"openapi":"/openapi.json get /payouts/{payoutId}","href":"/api-reference/transfers/retrieve-an-outgoing-transfer"}]},{"group":"Swaps","pages":[{"title":"Create a transfer between the client's own accounts","deprecated":null,"version":null,"openapi":"/openapi.json post /swaps","href":"/api-reference/transfers/create-a-transfer-between-the-clients-own-accounts"},{"title":"Price a transfer between the client's own accounts","description":"Compare every route that can serve this pair of accounts and return the best price. Nothing is booked with a provider and nothing is signed.","deprecated":null,"version":null,"openapi":"/openapi.json post /swaps/preview","href":"/api-reference/transfers/price-a-transfer-between-the-clients-own-accounts"},{"title":"Authorize a transfer between the client's own accounts","deprecated":null,"version":null,"openapi":"/openapi.json post /swaps/{swapId}/confirm","href":"/api-reference/transfers/authorize-a-transfer-between-the-clients-own-accounts"},{"title":"Retrieve a transfer between the client's own accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /swaps/{swapId}","href":"/api-reference/transfers/retrieve-a-transfer-between-the-clients-own-accounts"}]},{"group":"Contacts","pages":[{"title":"Create a contact","deprecated":null,"version":null,"openapi":"/openapi.json post /contacts","href":"/api-reference/contacts/create-a-contact"},{"title":"List saved contacts","deprecated":null,"version":null,"openapi":"/openapi.json get /contacts","href":"/api-reference/contacts/list-saved-contacts"},{"title":"Retrieve one contact","deprecated":null,"version":null,"openapi":"/openapi.json get /contacts/{contactId}","href":"/api-reference/contacts/retrieve-one-contact"},{"title":"Update a contact","deprecated":null,"version":null,"openapi":"/openapi.json patch /contacts/{contactId}","href":"/api-reference/contacts/update-a-contact"},{"title":"Delete a contact","deprecated":null,"version":null,"openapi":"/openapi.json delete /contacts/{contactId}","href":"/api-reference/contacts/delete-a-contact"},{"title":"Retrieve contact channels","deprecated":null,"version":null,"openapi":"/openapi.json get /contacts/{contactId}/capabilities","href":"/api-reference/contacts/retrieve-contact-channels"}]},{"group":"Transactions","pages":[{"title":"List transactions, newest first","deprecated":null,"version":null,"openapi":"/openapi.json get /transactions","href":"/api-reference/transactions/list-transactions-newest-first"},{"title":"Retrieve one transaction","deprecated":null,"version":null,"openapi":"/openapi.json get /transactions/{transactionId}","href":"/api-reference/transactions/retrieve-one-transaction"},{"title":"Inflow and outflow totals for the same filters","deprecated":null,"version":null,"openapi":"/openapi.json get /transactions/summary","href":"/api-reference/transactions/inflow-and-outflow-totals-for-the-same-filters"},{"title":"Export transactions, a statement, a confirmation or a receipt","deprecated":null,"version":null,"openapi":"/openapi.json get /transactions/export","href":"/api-reference/transactions/export-transactions-a-statement-a-confirmation-or-a-receipt"}]},{"group":"Escrow","pages":[{"title":"Open an escrow and return the payer's approval","deprecated":null,"version":null,"openapi":"/openapi.json post /escrow","href":"/api-reference/escrow/open-an-escrow-and-return-the-payers-approval"},{"title":"List the escrows this account operates","deprecated":null,"version":null,"openapi":"/openapi.json get /escrow","href":"/api-reference/escrow/list-the-escrows-this-account-operates"},{"title":"Read one escrow","deprecated":null,"version":null,"openapi":"/openapi.json get /escrow/{escrowId}","href":"/api-reference/escrow/read-one-escrow"},{"title":"Prepare an escrow action and return the payload to sign","deprecated":null,"version":null,"openapi":"/openapi.json post /escrow/{escrowId}/actions","href":"/api-reference/escrow/prepare-an-escrow-action-and-return-the-payload-to-sign"},{"title":"Submit the signature for a prepared escrow action","deprecated":null,"version":null,"openapi":"/openapi.json post /escrow/{escrowId}/actions/{idempotencyKey}/confirm","href":"/api-reference/escrow/submit-the-signature-for-a-prepared-escrow-action"},{"title":"Reconcile one escrow with the chain","deprecated":null,"version":null,"openapi":"/openapi.json post /escrow/{escrowId}/sync","href":"/api-reference/escrow/reconcile-one-escrow-with-the-chain"}]},{"group":"Sandbox","pages":[{"title":"Read the sandbox treasury that funds emulated credits","deprecated":null,"version":null,"openapi":"/openapi.json get /sandbox/treasury","href":"/api-reference/sandbox/read-the-sandbox-treasury-that-funds-emulated-credits"},{"title":"Emulate an incoming deposit: an account transfer with bankId, a token transfer without","deprecated":null,"version":null,"openapi":"/openapi.json post /sandbox/deposits","href":"/api-reference/sandbox/emulate-an-incoming-deposit:-an-account-transfer-with-bankid-a-token-transfer-without"},{"title":"Emulate the arrival of the funds a pay-in is waiting for","deprecated":null,"version":null,"openapi":"/openapi.json post /sandbox/payins/{payinId}/complete","href":"/api-reference/sandbox/emulate-the-arrival-of-the-funds-a-pay-in-is-waiting-for"},{"title":"Move an emulated outgoing transfer to its next reported status","deprecated":null,"version":null,"openapi":"/openapi.json post /sandbox/payouts/{payoutId}/status","href":"/api-reference/sandbox/move-an-emulated-outgoing-transfer-to-its-next-reported-status"}]}]}]},"basePath":"","title":"Create a transfer between the client's own accounts - HEVN","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}