Use this endpoint to lock an exchange rate before creating a transfer. Quotes give the customer a deterministic source-to-destination conversion rate that’s valid for a fixed window (30, 60, or 300 seconds). The quote captures the source amount, destination amount, exchange rate, and full fee breakdown (integrator + platform) at the moment of issuance. A quote can be redeemed exactly once by passing its ID when calling Create Transfer.
Quotes are most useful for trading and cross-border payouts where the customer needs to see the exact rate they’ll receive before committing the transfer. For floating-rate transfers (e.g. payroll, treasury rebalancing), skip the quote and call /v2/transfer directly.
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
amount
string
required
The quote amount. For MXN/USD RFQ it is denominated by referenceSide; all other corridors retain their existing source-amount behavior.
Pattern: ^\d+(\.\d{2})?$
Example:
"100.00"
customerId
string
required
The customer's ID.
Pattern: ^customer_[a-z0-9]+$
Example:
"customer_3faa484998f44cfead9668608b9ee1f5"
destination
object
required
The destination currency and network for the quote.
Show child attributes
source
object
required
The source currency and network for the quote.
Show child attributes
integratorBpsFeeRate
string
The integrator BPS fee rate. The BPS rate must be an integer string between 0 and 10000.
Pattern: ^\d+$
Example:
"20"
quoteDurationSeconds
number
For MXN/SPEI to USD/wire or USD/swift quotes, the field may be omitted or must be 45; omission defaults to 45. For all other supported routes, explicit values must be 30, 60, or 300 seconds and omission defaults to 60.
Example:
60
referenceSide
enum<string>
MXN/USD RFQ only. The side denominating amount; defaults to source when omitted.
Available options:
source,
destination
Example:
"source"
Response
created
string<date-time>
required
The datetime the quote was created.
Example:
"2025-01-01T00:00:00.000Z"
customerId
string
required
The customer ID.
Example:
"customer_d243ab2b1de4447d8a046d87fefe58cf"
destination
object
required
Show child attributes
expiresAt
string<date-time>
required
The datetime when this quote expires.
Example:
"2025-01-01T00:01:00.000Z"
fees
object
required
Show child attributes
id
string
required
A unique identifier for the quote.
Pattern: ^quote_[a-z0-9]+$
Example:
"quote_d243ab2b1de4447d8a046d87fefe58cf"
source
object
required
Show child attributes
type
enum<string>
required
The transfer type this quote is for.
Available options:
on_ramp,
off_ramp,
fiat_to_fiat
Example:
"off_ramp"
quoteDurationSeconds
integer
RFQ-only quote duration in seconds.
Required range: x > 0
Example:
45
referenceSide
enum<string>
RFQ-only side whose amount was referenced for pricing.
Available options:
source,
destination
Example:
"source"
status
enum<string>
The current status of the quote.
Available options:
active,
used,
expired
Example:
"active"
Last modified on June 18, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SpherePay","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48","dark":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-dark.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=841362b62b2d8a0da3d2b69d22c62d88"},"favicon":"https://mintcdn.com/spherepayco/a4WF4v5_QYD1dXam/favicon.png?fit=max\u0026auto=format\u0026n=a4WF4v5_QYD1dXam\u0026q=85\u0026s=b3c29639701db7176e6ac8f2b03f68a7","api":{"playground":{"display":"none"}},"navbar":{"primary":{"type":"button","label":"Sphere Dashboard ↗","href":"https://spherepay.co/dashboard"}},"icons":{"library":"lucide"},"styling":{"codeblocks":"dark","latex":true},"metadata":{"timestamp":true},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"pt-BR","href":"pt-BR/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spherepayco","hasAudioNarration":false,"actualSubdomain":"spherepayco","customDomains":["docs.spherepay.co"],"gitSource":{"type":"github","owner":"sphere-laboratories","repo":"mintlify-docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afb548f102c05d39eace92b","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"en","tag":"API Reference","count":56},{"language":"es","tag":"Referencia de la API","count":56},{"language":"pt-BR","tag":"Referência da API","count":56},{"language":"en","tag":"Concepts","count":30},{"language":"es","tag":"Conceptos","count":30},{"language":"pt-BR","tag":"Conceitos","count":30},{"language":"en","tag":"Onboarding","count":27},{"language":"es","tag":"Incorporación","count":27},{"language":"pt-BR","tag":"Onboarding","count":27},{"language":"en","tag":"Money movement","count":24},{"language":"es","tag":"Movimiento de dinero","count":24},{"language":"pt-BR","tag":"Movimentação de dinheiro","count":24},{"language":"en","tag":"Webhooks","count":13},{"language":"es","tag":"Webhooks","count":13},{"language":"pt-BR","tag":"Webhooks","count":13},{"language":"en","tag":"Accounts","count":9},{"language":"en","tag":"Transfers","count":9},{"language":"en","tag":"Get Started","count":9},{"language":"es","tag":"Cuentas","count":9},{"language":"es","tag":"Transferencias","count":9},{"language":"es","tag":"Comenzar","count":9},{"language":"pt-BR","tag":"Contas","count":9},{"language":"pt-BR","tag":"Transferências","count":9},{"language":"pt-BR","tag":"Começar","count":9},{"language":"en","tag":"Virtual Accounts","count":7},{"language":"es","tag":"Cuentas Virtuales","count":7},{"language":"pt-BR","tag":"Contas Virtuais","count":7},{"language":"en","tag":"Documents \u0026 Verification","count":6},{"language":"es","tag":"Documentos y Verificación","count":6},{"language":"pt-BR","tag":"Documentos e Verificação","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@spherepay.co","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6a02974593b34b4b8541d063","deploymentId":"69f39b63abf2e25489b5290d","questionText":"What currencies are supported?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:13.452Z","updatedAt":"2026-05-12T02:58:13.452Z","__v":0},{"_id":"6a02973893b34b4b8541d023","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I create a transfer?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:00.452Z","updatedAt":"2026-05-12T02:58:00.452Z","__v":0},{"_id":"6a02972c93b34b4b8541cfef","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I onboard a business?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:57:48.946Z","updatedAt":"2026-05-12T02:57:48.946Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-component-part=\"update-tag\"]{padding:2px 8px;border:1px solid var(--gray-200, #e5e7eb);background:transparent;color:var(--gray-600, #4b5563);font-size:0.6875rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase;border-radius:4px;line-height:1.4}.dark [data-component-part=\"update-tag\"]{border-color:var(--gray-700, #374151);color:var(--gray-300, #d1d5db)}[data-component-part=\"update-tag-list\"]{margin-top:0.5rem;gap:0.375rem}nav[class*=\"navbar\"] ul li a.link{border-radius:0!important;background:transparent!important;border-bottom:2px solid transparent;transition:border-color 120ms ease, color 120ms ease}nav[class*=\"navbar\"] ul li a.link:hover{background:transparent!important;color:#18181b!important;border-bottom-color:rgba(37, 99, 235, 0.4)}.dark nav[class*=\"navbar\"] ul li a.link:hover{color:#60A5FA!important;border-bottom-color:rgba(96, 165, 250, 0.4)}nav[class*=\"navbar\"] ul li a.link[aria-current=\"page\"]{background:transparent!important;border-bottom-color:var(--mintlify-primary, #2563EB);color:#18181b!important}.dark nav[class*=\"navbar\"] ul li a.link[aria-current=\"page\"]{color:#fafafa!important;border-bottom-color:#60A5FA}nav[class*=\"navbar\"][class*=\"justify-center\"]{justify-content:flex-start!important}button:has(>div>svg.lucide-search){width:auto!important;min-width:220px;padding-left:14px!important;padding-right:12px!important;justify-content:space-between!important}button:has(>div>svg.lucide-search) .truncate.min-w-0{display:block!important}a[href=\"https://spherepay.co/dashboard\"] span[class*=\"bg-primary-dark\"]{border-radius:6px!important;background-color:#2970FF!important;transition:background-color 120ms ease}a[href=\"https://spherepay.co/dashboard\"]:hover span[class*=\"bg-primary-dark\"]{background-color:#155EEF!important;opacity:1!important}a[href=\"https://spherepay.co/dashboard\"] svg{display:none!important}[data-component-part=\"card-icon\"]{width:44px!important;height:44px!important;display:flex!important;align-items:center;justify-content:center;background:rgba(209, 224, 255, 0.5);border-radius:10px;margin-bottom:1rem}.dark [data-component-part=\"card-icon\"]{background:rgba(96, 165, 250, 0.15)}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){margin-left:24px;padding-left:4px;border-left:1.5px solid #E5E7EB}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)) a[href*=\"/api-reference/\"]{padding-left:16px!important}.dark ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){border-left-color:rgba(255, 255, 255, 0.12)}#sidebar button[aria-expanded]>div:has(>svg[viewBox=\"0 -9 3 24\"]){margin-left:auto}#sidebar:has(a[href*=\"/api-reference/\"]){border-right:1px solid #E5E7EB}.dark #sidebar:has(a[href*=\"/api-reference/\"]){border-right-color:rgba(255, 255, 255, 0.1)}.sidebar-group-icon{display:none!important}#navbar-transition{border-bottom-color:#E5E7EB!important}@media (min-width: 1024px){#navbar-transition::after{content:\"\";position:absolute;left:0;right:0;top:64px;height:1px;background:#E5E7EB;pointer-events:none}}#navbar .flex-1{border-bottom-color:transparent!important}.dark #navbar-transition{border-bottom-color:rgba(255, 255, 255, 0.1)!important}.dark #navbar-transition::after{background:rgba(255, 255, 255, 0.1)}"}]}
{"page":{"pagePath":"api-reference/quote/post","slug":"/api-reference/quote/post","pageMetadata":{"title":"Create a Rate-Locked Quote","sidebarTitle":"Create Quote","openapi":"openapi/spherepay.yaml POST /v2/quote","description":"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.","href":"/api-reference/quote/post"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Info}=_components;if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this endpoint to lock an exchange rate before creating a transfer. Quotes give the customer a deterministic source-to-destination conversion rate that’s valid for a fixed window (30, 60, or 300 seconds). The quote captures the source amount, destination amount, exchange rate, and full fee breakdown (integrator + platform) at the moment of issuance. A quote can be redeemed exactly once by passing its ID when calling `,_jsx(_components.a,{href:`/api-reference/transfer/post`,children:`Create Transfer`}),`.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Quotes are most useful for `,_jsx(_components.strong,{children:`trading`}),` and `,_jsx(_components.strong,{children:`cross-border payouts`}),` where the customer needs to see the exact rate they’ll receive before committing the transfer. For floating-rate transfers (e.g. payroll, treasury rebalancing), skip the quote and call `,_jsx(_components.code,{children:`/v2/transfer`}),` directly.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Create a Rate-Locked Quote","sidebarTitle":"Create Quote","openapi":"openapi/spherepay.yaml POST /v2/quote","description":"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.","href":"/api-reference/quote/post"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/spherepayco/27b80abc67bf6551/snippets/demoAppUrl.js"],"openApiReferenceData":{"operation":{"description":"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.","operationId":"postV2Quote","parameters":[],"requestBody":"fa5948e3-1b0d-49a6-a9b4-8d740e4ac543","responses":{"201":"940287dd-c204-4345-99d5-eca1a34ddc83","400":"3a09fa14-494b-460e-81f0-68441d90ce40","404":"58065101-7fe0-4681-8246-e1659ee101c4","422":"6f14559d-1945-4a45-9664-b59e7eedf091"},"summary":"Create a Quote","method":"post","type":"path","servers":["4cfe9135-ea06-4da5-aceb-a7fd710f8dd7","555a21b5-fc66-4e5f-842f-dedad3cc9816"],"security":["d2c5e951-bc5c-4c0e-9398-d81153991947"],"path":"/v2/quote","baseUrlOptions":["https://api.spherepay.co","https://api.sandbox.spherepay.co"],"title":"Create a Quote","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"amount":{"description":"The quote amount. For MXN/USD RFQ it is denominated by referenceSide; all other corridors retain their existing source-amount behavior.","example":"100.00","pattern":"^\\d+(\\.\\d{2})?$","type":"string","isRequired":true,"uniqueKey":"amount","typeLabel":"string"},"customerId":{"description":"The customer's ID.","example":"customer_3faa484998f44cfead9668608b9ee1f5","pattern":"^customer_[a-z0-9]+$","type":"string","isRequired":true,"uniqueKey":"customerId","typeLabel":"string"},"destination":{"description":"The destination currency and network for the quote.","properties":{"currency":{"description":"The destination currency. For off-ramp: a fiat currency (e.g., \"brl\"). For on-ramp: a stablecoin (e.g., \"usdc\").","enum":["usdc","usdt","eurc","usd","eur","brl","mxn","mxn"],"example":"brl","type":"string","isRequired":true,"uniqueKey":"destination.currency","typeLabel":"enum\u003cstring>"},"network":{"oneOf":[{"type":"string","description":"The destination network. For off-ramp: a payment rail (e.g., \"pix\"). For on-ramp: a blockchain (e.g., \"polygon\").","enum":["sol","fogo","ethereum","arbitrum","polygon","base","avalanche","sui","noble","sei","tron","starknet","aptos","hyperliquid"],"example":"pix","isRequired":true,"uniqueKey":"destination.network.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"The destination network. For off-ramp: a payment rail (e.g., \"pix\"). For on-ramp: a blockchain (e.g., \"polygon\").","enum":["wire","ach","achPush","achPull","achSameDay","swift","sepa","pix","spei","spei"],"example":"pix","isRequired":true,"uniqueKey":"destination.network.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"destination.network","typeLabel":"enum\u003cstring>"}},"required":["currency","network"],"type":"object","isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"source":{"description":"The source currency and network for the quote.","properties":{"currency":{"description":"The source currency. For off-ramp: a stablecoin (e.g., \"usdc\"). For on-ramp: a fiat currency (e.g., \"brl\").","enum":["usdc","usdt","eurc","usd","eur","brl","mxn","mxn"],"example":"usdc","type":"string","isRequired":true,"uniqueKey":"source.currency","typeLabel":"enum\u003cstring>"},"network":{"oneOf":[{"type":"string","description":"The source network. For off-ramp: a blockchain (e.g., \"polygon\"). For on-ramp: a payment rail (e.g., \"pix\").","enum":["sol","fogo","ethereum","arbitrum","polygon","base","avalanche","sui","noble","sei","tron","starknet","aptos","hyperliquid"],"example":"polygon","isRequired":true,"uniqueKey":"source.network.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"The source network. For off-ramp: a blockchain (e.g., \"polygon\"). For on-ramp: a payment rail (e.g., \"pix\").","enum":["wire","ach","achPush","achPull","achSameDay","swift","sepa","pix","spei","spei"],"example":"polygon","isRequired":true,"uniqueKey":"source.network.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"source.network","typeLabel":"enum\u003cstring>"}},"required":["currency","network"],"type":"object","isRequired":true,"uniqueKey":"source","typeLabel":"object"},"integratorBpsFeeRate":{"description":"The integrator BPS fee rate. The BPS rate must be an integer string between 0 and 10000.","example":"20","pattern":"^\\d+$","type":"string","uniqueKey":"integratorBpsFeeRate","typeLabel":"string"},"quoteDurationSeconds":{"description":"For MXN/SPEI to USD/wire or USD/swift quotes, the field may be omitted or must be 45; omission defaults to 45. For all other supported routes, explicit values must be 30, 60, or 300 seconds and omission defaults to 60.","example":60,"type":"number","uniqueKey":"quoteDurationSeconds","typeLabel":"number"},"referenceSide":{"description":"MXN/USD RFQ only. The side denominating amount; defaults to source when omitted.","enum":["source","destination"],"example":"source","type":"string","uniqueKey":"referenceSide","typeLabel":"enum\u003cstring>"}},"required":["amount","customerId","source","destination"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"amount":"100.00","customerId":"customer_3faa484998f44cfead9668608b9ee1f5","destination":{"currency":"brl","network":"pix"},"source":{"currency":"usdc","network":"polygon"},"integratorBpsFeeRate":"20","quoteDurationSeconds":60,"referenceSide":"source"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"940287dd-c204-4345-99d5-eca1a34ddc83":{"content":{"application/json":{"schema":{"properties":{"created":{"description":"The datetime the quote was created.","example":"2025-01-01T00:00:00.000Z","format":"date-time","type":"string","isRequired":true,"uniqueKey":"created","typeLabel":"string\u003cdate-time>"},"customerId":{"description":"The customer ID.","example":"customer_d243ab2b1de4447d8a046d87fefe58cf","type":"string","isRequired":true,"uniqueKey":"customerId","typeLabel":"string"},"destination":{"properties":{"amount":{"description":"The destination amount after exchange.","example":"545.50","type":"string","isRequired":true,"uniqueKey":"destination.amount","typeLabel":"string"},"currency":{"description":"The destination currency.","enum":["usdc","usdt","eurc","usd","eur","brl","mxn","mxn"],"example":"brl","type":"string","isRequired":true,"uniqueKey":"destination.currency","typeLabel":"enum\u003cstring>"},"exchangeRate":{"description":"The exchange rate applied to convert source to destination.","example":"5.455","type":"string","isRequired":true,"uniqueKey":"destination.exchangeRate","typeLabel":"string"},"network":{"oneOf":[{"type":"string","description":"The destination network.","enum":["sol","fogo","ethereum","arbitrum","polygon","base","avalanche","sui","noble","sei","tron","starknet","aptos","hyperliquid"],"example":"pix","isRequired":true,"uniqueKey":"destination.network.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"The destination network.","enum":["wire","ach","achPush","achPull","achSameDay","swift","sepa","pix","spei","spei"],"example":"pix","isRequired":true,"uniqueKey":"destination.network.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"destination.network","typeLabel":"enum\u003cstring>"}},"required":["currency","network","amount","exchangeRate"],"type":"object","isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"expiresAt":{"description":"The datetime when this quote expires.","example":"2025-01-01T00:01:00.000Z","format":"date-time","type":"string","isRequired":true,"uniqueKey":"expiresAt","typeLabel":"string\u003cdate-time>"},"fees":{"properties":{"integratorFee":{"description":"The integrator fee portion.","example":{"bpsRate":"0","currency":"usdc","fixedAmount":"0.00","totalAmount":"0.00"},"properties":{"bpsAmount":{"description":"The sum of the individually rounded percentage-based fee components.","example":"0.10","type":"string","isRequired":true,"uniqueKey":"fees.integratorFee.bpsAmount","typeLabel":"string"},"bpsRate":{"description":"The BPS rate of the fee.","example":"10","type":"string","isRequired":true,"uniqueKey":"fees.integratorFee.bpsRate","typeLabel":"string"},"currency":{"description":"The currency of the fee.","enum":["usdc","usdt","eurc","usd","eur","brl","mxn","mxn"],"example":"brl","type":"string","isRequired":true,"uniqueKey":"fees.integratorFee.currency","typeLabel":"enum\u003cstring>"},"fixedAmount":{"description":"The fixed amount of the fee.","example":"1.00","type":"string","isRequired":true,"uniqueKey":"fees.integratorFee.fixedAmount","typeLabel":"string"},"totalAmount":{"description":"The total amount of the fee applied to the source amount.","example":"1.10","type":"string","isRequired":true,"uniqueKey":"fees.integratorFee.totalAmount","typeLabel":"string"}},"required":["fixedAmount","bpsRate","bpsAmount","totalAmount","currency"],"type":"object","isRequired":true,"uniqueKey":"fees.integratorFee","typeLabel":"object"},"platformFee":{"description":"The platform fee portion.","example":{"bpsRate":"20","currency":"usdc","fixedAmount":"0.00","totalAmount":"2.00"},"properties":{"bpsAmount":{"description":"The sum of the individually rounded percentage-based fee components.","example":"0.10","type":"string","isRequired":true,"uniqueKey":"fees.platformFee.bpsAmount","typeLabel":"string"},"bpsRate":{"description":"The BPS rate of the fee.","example":"10","type":"string","isRequired":true,"uniqueKey":"fees.platformFee.bpsRate","typeLabel":"string"},"currency":{"description":"The currency of the fee.","enum":["usdc","usdt","eurc","usd","eur","brl","mxn","mxn"],"example":"brl","type":"string","isRequired":true,"uniqueKey":"fees.platformFee.currency","typeLabel":"enum\u003cstring>"},"fixedAmount":{"description":"The fixed amount of the fee.","example":"1.00","type":"string","isRequired":true,"uniqueKey":"fees.platformFee.fixedAmount","typeLabel":"string"},"totalAmount":{"description":"The total amount of the fee applied to the source amount.","example":"1.10","type":"string","isRequired":true,"uniqueKey":"fees.platformFee.totalAmount","typeLabel":"string"}},"required":["fixedAmount","bpsRate","bpsAmount","totalAmount","currency"],"type":"object","isRequired":true,"uniqueKey":"fees.platformFee","typeLabel":"object"}},"required":["integratorFee","platformFee"],"type":"object","isRequired":true,"uniqueKey":"fees","typeLabel":"object"},"id":{"description":"A unique identifier for the quote.","example":"quote_d243ab2b1de4447d8a046d87fefe58cf","pattern":"^quote_[a-z0-9]+$","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"source":{"properties":{"amount":{"description":"The source amount.","example":"100.00","type":"string","isRequired":true,"uniqueKey":"source.amount","typeLabel":"string"},"currency":{"description":"The source currency.","enum":["usdc","usdt","eurc","usd","eur","brl","mxn","mxn"],"example":"usdc","type":"string","isRequired":true,"uniqueKey":"source.currency","typeLabel":"enum\u003cstring>"},"network":{"oneOf":[{"type":"string","description":"The source network.","enum":["sol","fogo","ethereum","arbitrum","polygon","base","avalanche","sui","noble","sei","tron","starknet","aptos","hyperliquid"],"example":"polygon","isRequired":true,"uniqueKey":"source.network.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"The source network.","enum":["wire","ach","achPush","achPull","achSameDay","swift","sepa","pix","spei","spei"],"example":"polygon","isRequired":true,"uniqueKey":"source.network.oneOf.1","typeLabel":"enum\u003cstring>"}],"isRequired":true,"uniqueKey":"source.network","typeLabel":"enum\u003cstring>"}},"required":["currency","network","amount"],"type":"object","isRequired":true,"uniqueKey":"source","typeLabel":"object"},"type":{"description":"The transfer type this quote is for.","enum":["on_ramp","off_ramp","fiat_to_fiat"],"example":"off_ramp","type":"string","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"quoteDurationSeconds":{"description":"RFQ-only quote duration in seconds.","example":45,"exclusiveMinimum":true,"minimum":0,"type":"integer","uniqueKey":"quoteDurationSeconds","typeLabel":"integer"},"referenceSide":{"description":"RFQ-only side whose amount was referenced for pricing.","enum":["source","destination"],"example":"source","type":"string","uniqueKey":"referenceSide","typeLabel":"enum\u003cstring>"},"status":{"description":"The current status of the quote.","enum":["active","used","expired"],"example":"active","type":"string","uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"required":["id","type","customerId","fees","source","destination","expiresAt","created"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"created":"2025-01-01T00:00:00.000Z","customerId":"customer_d243ab2b1de4447d8a046d87fefe58cf","destination":{"amount":"545.50","currency":"brl","exchangeRate":"5.455","network":"pix"},"expiresAt":"2025-01-01T00:01:00.000Z","fees":{"integratorFee":{"bpsRate":"0","currency":"usdc","fixedAmount":"0.00","totalAmount":"0.00"},"platformFee":{"bpsRate":"20","currency":"usdc","fixedAmount":"0.00","totalAmount":"2.00"}},"id":"quote_d243ab2b1de4447d8a046d87fefe58cf","source":{"amount":"100.00","currency":"usdc","network":"polygon"},"type":"off_ramp","quoteDurationSeconds":45,"referenceSide":"source","status":"active"}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"3a09fa14-494b-460e-81f0-68441d90ce40":{"content":{"application/json":{"examples":{"Bad Request":{"title":"Bad Request","summary":"Bad Request","value":{"code":"address/invalid","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Invalid request parameters","status":400}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Bad Request","exampleType":"examples"},"58065101-7fe0-4681-8246-e1659ee101c4":{"content":{"application/json":{"examples":{"Not Found":{"title":"Not Found","summary":"Not Found","value":{"code":"resource/not-found","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Resource not found","status":404}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Not Found","exampleType":"examples"},"6f14559d-1945-4a45-9664-b59e7eedf091":{"content":{"application/json":{"examples":{"Validation Error":{"title":"Validation Error","summary":"Validation Error","value":{"code":"validation/failed","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Validation failed","errors":[{"detail":"Invalid email format","pointer":"/email"},{"detail":"Name is required","pointer":"/name"}],"status":422}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Unprocessable Entity - Validation Error","exampleType":"examples"}},"security":{"d2c5e951-bc5c-4c0e-9398-d81153991947":{"bearer":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"}}},"servers":{"4cfe9135-ea06-4da5-aceb-a7fd710f8dd7":{"description":"Production","url":"https://api.spherepay.co"},"555a21b5-fc66-4e5f-842f-dedad3cc9816":{"description":"Sandbox","url":"https://api.sandbox.spherepay.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"},"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":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi/spherepay.yaml"},"subdomain":"spherepayco","siteName":"SpherePay","title":"Create a Rate-Locked Quote - SpherePay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/quote/post","matchLevel":0},"es":{"href":"/es/api-reference/quote/post","matchLevel":1},"pt-BR":{"href":"/pt-BR/api-reference/quote/post","matchLevel":1}}},"lastModified":"2026-06-18T02:06:48.270Z","gitLastModified":"2026-06-18T02:06:27.000Z","originalFileLocation":"api-reference/quote/post.mdx","locale":"en"},"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=\"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Rate-Locked Quote - SpherePay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SpherePay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spherepay.co/api-reference/quote/post\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spherepayco.mintlify.site/_mintlify/api/og/v2?division=Quotes\u0026amp;title=Create+a+Rate-Locked+Quote\u0026amp;description=Create+a+locked+exchange+rate+quote.+The+quote+is+valid+for+the+specified+duration+and+can+be+used+once+to+create+a+transfer.\u0026amp;theme=eda2cafc957c45d3c16031d8\u0026amp;signature=bf9e692e209112629f7947ab2c7576e4b870a70e71a92d6cf54c3089e99f1ab3\">\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 Rate-Locked Quote - SpherePay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spherepayco.mintlify.site/_mintlify/api/og/v2?division=Quotes\u0026amp;title=Create+a+Rate-Locked+Quote\u0026amp;description=Create+a+locked+exchange+rate+quote.+The+quote+is+valid+for+the+specified+duration+and+can+be+used+once+to+create+a+transfer.\u0026amp;theme=eda2cafc957c45d3c16031d8\u0026amp;signature=bf9e692e209112629f7947ab2c7576e4b870a70e71a92d6cf54c3089e99f1ab3\">\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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spherepay.co/api-reference/quote/post\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/quote/post.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.spherepay.co/api-reference/quote/post\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.spherepay.co/es/api-reference/quote/post\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.spherepay.co/pt-BR/api-reference/quote/post\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.spherepay.co/api-reference/quote/post\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spherepay.co/#organization\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spherepay.co#website\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spherepay.co/api-reference/quote/post#webpage\",\"url\":\"https://docs.spherepay.co/api-reference/quote/post\",\"name\":\"Create a Rate-Locked Quote\",\"description\":\"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.\",\"dateModified\":\"2026-06-18T02:06:27.000Z\",\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spherepay.co/api-reference/quote/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spherepay.co/api-reference/quote/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Money movement\",\"item\":\"https://docs.spherepay.co/api-reference/transfer/post\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a Rate-Locked Quote\",\"item\":\"https://docs.spherepay.co/api-reference/quote/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.spherepay.co/api-reference/quote/post#apireference\",\"headline\":\"Create a Rate-Locked Quote\",\"name\":\"Create a Rate-Locked Quote\",\"description\":\"Create a locked exchange rate quote. The quote is valid for the specified duration and can be used once to create a transfer.\",\"url\":\"https://docs.spherepay.co/api-reference/quote/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spherepay.co/api-reference/quote/post#webpage\"},\"dateModified\":\"2026-06-18T02:06:27.000Z\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SpherePay\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"SpherePay\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/quote/post.md","siteName":"SpherePay","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/introduction"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/implementation-guides/overview"}]},{"tab":"Solutions","pages":[{"title":"Solutions","href":"/solutions/overview"}]},{"tab":"API Reference","groups":[{"group":"Onboarding","pages":[{"group":"Customers","icon":"user","pages":[{"title":"Create an Individual or Business Customer","sidebarTitle":"Create Customer","openapi":"openapi/spherepay.yaml POST /v2/customer","href":"/api-reference/customer/post"},{"title":"List Customers with Filters and Pagination","sidebarTitle":"List Customers","openapi":"openapi/spherepay.yaml GET /v2/customer","href":"/api-reference/customer/get"},{"title":"Retrieve a Customer with Verification Status","sidebarTitle":"Get Customer","openapi":"openapi/spherepay.yaml GET /v2/customer/{id}","href":"/api-reference/customer/get-id"},{"title":"Update Customer Address, Phone, or Email","sidebarTitle":"Update Customer","openapi":"openapi/spherepay.yaml PATCH /v2/customer/{id}","href":"/api-reference/customer/patch-id"}]},{"group":"Onboarding Links","icon":"link","pages":[{"title":"Create Customer via Link","sidebarTitle":"Create Customer via Link","openapi":"openapi/spherepay.yaml POST /v2/customer/kyc-link","href":"/api-reference/customer/kyc-link"},{"title":"Regenerate a Customer's KYC Link","sidebarTitle":"Regenerate KYC Link","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/kyc-link","href":"/api-reference/customer/kyc"}]},{"group":"Documents \u0026 Verification","icon":"file-check","pages":[{"title":"Upload KYC and KYB Identity Documents","sidebarTitle":"Upload Document","openapi":"openapi/spherepay.yaml POST /v2/document","href":"/api-reference/document/post"},{"title":"Generate a Customer Face Verification Link","sidebarTitle":"Face Verification Link","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/face-verification-link","href":"/api-reference/enhanced-due-diligence/face-verification-link"},{"title":"Generate a UBO Face Verification Link for KYB","sidebarTitle":"UBO Face Verification Link","openapi":"openapi/spherepay.yaml POST /v2/business-representative/{id}/face-verification-link","href":"/api-reference/enhanced-due-diligence/ubo-face-verification-link"},{"title":"Send an OTP Code for Customer Verification","sidebarTitle":"Send Verification Code","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-send","href":"/api-reference/enhanced-due-diligence/send-verification-code"},{"title":"Verify a Customer OTP Code for Email or Phone","sidebarTitle":"Verify OTP Code","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-verify","href":"/api-reference/enhanced-due-diligence/verify-verification-code"},{"title":"Record Customer Terms of Service Acceptance","sidebarTitle":"Accept Terms of Service","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/tos-link","href":"/api-reference/enhanced-due-diligence/tos"}]},{"group":"Business Representatives","icon":"users","pages":[{"title":"Register a Business UBO for KYB Verification","sidebarTitle":"Register Representative","openapi":"openapi/spherepay.yaml POST /v2/business-representative","href":"/api-reference/business-representative/post"},{"title":"List All Business Representatives and UBOs","sidebarTitle":"List Representatives","openapi":"openapi/spherepay.yaml GET /v2/business-representative","href":"/api-reference/business-representative/get"},{"title":"Retrieve a Business Representative by ID","sidebarTitle":"Get Representative","openapi":"openapi/spherepay.yaml GET /v2/business-representative/{id}","href":"/api-reference/business-representative/get-id"},{"title":"Update a Business Representative Before KYB","sidebarTitle":"Update Representative","openapi":"openapi/spherepay.yaml PATCH /v2/business-representative/{id}","href":"/api-reference/business-representative/patch-id"},{"title":"Remove a Business Representative or UBO","sidebarTitle":"Delete Representative","openapi":"openapi/spherepay.yaml DELETE /v2/business-representative/{id}","href":"/api-reference/business-representative/delete-id"}]}]},{"group":"Accounts","pages":[{"group":"Bank Accounts","icon":"landmark","pages":[{"title":"Register a Customer Bank Account for Transfers","sidebarTitle":"Register Bank Account","openapi":"openapi/spherepay.yaml POST /v2/bank-account","href":"/api-reference/bank-account/post"},{"title":"List All Registered Customer Bank Accounts","sidebarTitle":"List Bank Accounts","openapi":"openapi/spherepay.yaml GET /v2/bank-account","href":"/api-reference/bank-account/get"},{"title":"Retrieve a Bank Account by ID","sidebarTitle":"Get Bank Account","openapi":"openapi/spherepay.yaml GET /v2/bank-account/{id}","href":"/api-reference/bank-account/get-id"},{"title":"Update Bank Account Payment Rail Settings","sidebarTitle":"Update Bank Account","openapi":"openapi/spherepay.yaml PATCH /v2/bank-account/{id}","href":"/api-reference/bank-account/patch-id"},{"title":"Delete a Registered Customer Bank Account","sidebarTitle":"Delete Bank Account","openapi":"openapi/spherepay.yaml DELETE /v2/bank-account/{id}","href":"/api-reference/bank-account/delete-id"}]},{"group":"Wallets","icon":"wallet","pages":[{"title":"Register a Customer Crypto Wallet for Transfers","sidebarTitle":"Register Wallet","openapi":"openapi/spherepay.yaml POST /v2/wallet","href":"/api-reference/wallet/post"},{"title":"List All Registered Customer Crypto Wallets","sidebarTitle":"List Wallets","openapi":"openapi/spherepay.yaml GET /v2/wallet","href":"/api-reference/wallet/get"},{"title":"Retrieve a Customer Crypto Wallet by ID","sidebarTitle":"Get Wallet","openapi":"openapi/spherepay.yaml GET /v2/wallet/{id}","href":"/api-reference/wallet/get-id"},{"title":"Remove a Registered Customer Crypto Wallet","sidebarTitle":"Delete Wallet","openapi":"openapi/spherepay.yaml DELETE /v2/wallet/{id}","href":"/api-reference/wallet/delete-id"}]}]},{"group":"Money movement","pages":[{"group":"Transfers","icon":"arrow-right-left","pages":[{"title":"Create an On-Ramp or Off-Ramp Transfer","sidebarTitle":"Create Transfer","openapi":"openapi/spherepay.yaml POST /v2/transfer","href":"/api-reference/transfer/post"},{"title":"List On-Ramp and Off-Ramp Transfers","sidebarTitle":"List Transfers","openapi":"openapi/spherepay.yaml GET /v2/transfer","href":"/api-reference/transfer/get"},{"title":"Retrieve a Transfer with Deposit Instructions","sidebarTitle":"Get Transfer","openapi":"openapi/spherepay.yaml GET /v2/transfer/{id}","href":"/api-reference/transfer/get-id"},{"title":"Cancel an Unfunded Pending Transfer","sidebarTitle":"Cancel Transfer","openapi":"openapi/spherepay.yaml DELETE /v2/transfer/{id}","description":"Cancel a specific transfer.","href":"/api-reference/transfer/delete-id"}]},{"group":"Quotes","icon":"calculator","pages":[{"title":"Create a Rate-Locked Quote","sidebarTitle":"Create Quote","openapi":"openapi/spherepay.yaml POST /v2/quote","href":"/api-reference/quote/post"},{"title":"List All Rate-Locked Quotes for Your Account","sidebarTitle":"List Quotes","openapi":"openapi/spherepay.yaml GET /v2/quote","description":"List quotes for the application. Repeat a currency parameter to match any supplied value; source and destination filters combine.","href":"/api-reference/quote/get"},{"title":"Retrieve a Quote by ID","sidebarTitle":"Get Quote","openapi":"openapi/spherepay.yaml GET /v2/quote/{id}","href":"/api-reference/quote/get-id"},{"title":"Update Quote Status","sidebarTitle":"Update Quote","openapi":"openapi/spherepay.yaml PUT /v2/quote/{id}","href":"/api-reference/quote/put-id"}]},{"group":"Virtual Accounts","icon":"credit-card","pages":[{"title":"Create a Virtual Bank Account for Fiat On-Ramp","sidebarTitle":"Create Virtual Account","openapi":"openapi/spherepay.yaml POST /v2/virtual-account","href":"/api-reference/virtual-account/post"},{"title":"List All Onramper Virtual Bank Accounts","sidebarTitle":"List Virtual Accounts","openapi":"openapi/spherepay.yaml GET /v2/virtual-account","href":"/api-reference/virtual-account/get"},{"title":"Retrieve an Onramper Account by ID","sidebarTitle":"Get Virtual Account","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}","href":"/api-reference/virtual-account/get-id"},{"title":"Update an Onramper Account Destination Wallet","sidebarTitle":"Update Virtual Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}","href":"/api-reference/virtual-account/patch"},{"title":"List Transfers for an Onramper Account","sidebarTitle":"List Account Transfers","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}/transfer","href":"/api-reference/virtual-account/list-transfers"},{"title":"Deactivate an Onramper Virtual Bank Account","sidebarTitle":"Deactivate Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/deactivate","href":"/api-reference/virtual-account/deactivate"},{"title":"Reactivate a Deactivated Onramper Account","sidebarTitle":"Reactivate Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/reactivate","href":"/api-reference/virtual-account/reactivate"}]},{"group":"Offloader Wallets","icon":"arrow-up-from-line","pages":[{"title":"Create an Offloader Wallet for Crypto Payouts","sidebarTitle":"Create Offloader Wallet","openapi":"openapi/spherepay.yaml POST /v2/offloader-wallet","href":"/api-reference/offloader-wallet/post"},{"title":"List All Offloader Wallets for Your Account","sidebarTitle":"List Offloader Wallets","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet","href":"/api-reference/offloader-wallet/get"},{"title":"Retrieve an Offloader Wallet by ID","sidebarTitle":"Get Offloader Wallet","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet/{id}","href":"/api-reference/offloader-wallet/get-id"},{"title":"Update an Offloader Wallet Bank Destination","sidebarTitle":"Update Offloader Wallet","openapi":"openapi/spherepay.yaml PATCH /v2/offloader-wallet/{id}","href":"/api-reference/offloader-wallet/patch-id"}]}]},{"group":"Webhooks","pages":[{"group":"Webhook Endpoints","icon":"plug","pages":[{"title":"Register a Webhook Endpoint for Event Delivery","sidebarTitle":"Create Webhook Endpoint","openapi":"openapi/spherepay.yaml POST /v2/webhook-endpoints","href":"/api-reference/webhook-endpoints/post"},{"title":"List All Registered Webhook Endpoints","sidebarTitle":"List Webhook Endpoints","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints","href":"/api-reference/webhook-endpoints/get"},{"title":"Retrieve a Webhook Endpoint by ID","sidebarTitle":"Get Webhook Endpoint","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/get-id"},{"title":"Delete a Webhook Endpoint","sidebarTitle":"Delete Webhook Endpoint","openapi":"openapi/spherepay.yaml DELETE /v2/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/delete-id"}]},{"group":"Events","icon":"bell","pages":[{"title":"List Events and Their Delivery Status","sidebarTitle":"List Events","openapi":"openapi/spherepay.yaml GET /v2/events","href":"/api-reference/events/get"},{"title":"Retrieve an Event with Full Delivery History","sidebarTitle":"Get Event","openapi":"openapi/spherepay.yaml GET /v2/events/{id}","href":"/api-reference/events/get-id"},{"title":"Replay a Failed Event Delivery","sidebarTitle":"Replay Delivery","openapi":"openapi/spherepay.yaml POST /v2/events/replay/{eventDeliveryId}","href":"/api-reference/events/replay"}]}]},{"group":"Sandbox Simulation","pages":[{"title":"Advance a Sandbox Customer","sidebarTitle":"Advance Customer","openapi":"openapi/spherepay.yaml POST /v2/sandbox/customer/{id}/advance","href":"/api-reference/sandbox/customer-advance"},{"title":"Advance a Sandbox Transfer","sidebarTitle":"Advance Transfer","openapi":"openapi/spherepay.yaml POST /v2/sandbox/transfer/{id}/advance","href":"/api-reference/sandbox/transfer-advance"},{"title":"Mint Test Tokens","sidebarTitle":"Mint Test Tokens","openapi":"openapi/spherepay.yaml POST /v2/sandbox/faucet","href":"/api-reference/sandbox/faucet-post"},{"title":"Retrieve a Test Token Mint","sidebarTitle":"Get Mint","openapi":"openapi/spherepay.yaml GET /v2/sandbox/faucet/{id}","href":"/api-reference/sandbox/faucet-get-id"}]}]},{"tab":"Releases","pages":[{"title":"Releases","href":"/changelog"}]},{"tab":"FAQ","href":"https://spherepay-knowledge-base.help.usepylon.com/"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/quote/post"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/quote/post"}]}]},"basePath":"","title":"Create a Rate-Locked Quote - SpherePay","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}