Use este endpoint para bloquear uma taxa de câmbio antes de criar uma transferência. As cotações (quote) fornecem ao cliente uma taxa de conversão determinística de origem para destino, válida por uma janela fixa (30, 60 ou 300 segundos). A cotação captura o valor de origem, valor de destino, taxa de câmbio e detalhamento completo de taxas (integrador + plataforma) no momento da emissão. Uma cotação pode ser resgatada exatamente uma vez, passando seu ID ao chamar Criar Transferência.
As cotações são mais úteis para trading e pagamentos cross-border onde o cliente precisa ver a taxa exata que receberá antes de confirmar a transferência. Para transferências com taxa flutuante (ex.: folha de pagamento, rebalanceamento de tesouraria), ignore a cotação e chame /v2/transfer diretamente.
Autorizações
Authorization
string
header
obrigatório
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corpo
application/json
amount
string
obrigatório
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})?$
Exemplo:
"100.00"
customerId
string
obrigatório
The customer's ID.
Pattern: ^customer_[a-z0-9]+$
Exemplo:
"customer_3faa484998f44cfead9668608b9ee1f5"
destination
object
obrigatório
The destination currency and network for the quote.
Show child attributes
source
object
obrigatório
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+$
Exemplo:
"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.
Exemplo:
60
referenceSide
enum<string>
MXN/USD RFQ only. The side denominating amount; defaults to source when omitted.
Opções disponíveis:
source,
destination
Exemplo:
"source"
Resposta
created
string<date-time>
obrigatório
The datetime the quote was created.
Exemplo:
"2025-01-01T00:00:00.000Z"
customerId
string
obrigatório
The customer ID.
Exemplo:
"customer_d243ab2b1de4447d8a046d87fefe58cf"
destination
object
obrigatório
Show child attributes
expiresAt
string<date-time>
obrigatório
The datetime when this quote expires.
Exemplo:
"2025-01-01T00:01:00.000Z"
fees
object
obrigatório
Show child attributes
id
string
obrigatório
A unique identifier for the quote.
Pattern: ^quote_[a-z0-9]+$
Exemplo:
"quote_d243ab2b1de4447d8a046d87fefe58cf"
source
object
obrigatório
Show child attributes
type
enum<string>
obrigatório
The transfer type this quote is for.
Opções disponíveis:
on_ramp,
off_ramp,
fiat_to_fiat
Exemplo:
"off_ramp"
quoteDurationSeconds
integer
RFQ-only quote duration in seconds.
Intervalo obrigatório: x > 0
Exemplo:
45
referenceSide
enum<string>
RFQ-only side whose amount was referenced for pricing.
Opções disponíveis:
source,
destination
Exemplo:
"source"
status
enum<string>
The current status of the quote.
Opções disponíveis:
active,
used,
expired
Exemplo:
"active"
Última modificação em 22 de junho de 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":"6ae4e40af8344a2328cd117d","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"en","tag":"API Reference","count":52},{"language":"es","tag":"Referencia de la API","count":52},{"language":"pt-BR","tag":"Referência da API","count":52},{"language":"en","tag":"Concepts","count":29},{"language":"es","tag":"Conceptos","count":29},{"language":"pt-BR","tag":"Conceitos","count":29},{"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":"llms-txt-v2","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":"pt-BR/api-reference/quote/post","slug":"/pt-BR/api-reference/quote/post","pageMetadata":{"title":"Criar uma Cotação com Taxa Bloqueada","sidebarTitle":"Criar Cotação","openapi":"openapi/spherepay.yaml POST /v2/quote","source_file":"api-reference/quote/post.mdx","source_language":"en","translation_language":"pt-BR","source_commit":"6c9107b","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":"/pt-BR/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 este endpoint para bloquear uma taxa de câmbio antes de criar uma transferência. As cotações (`,_jsx(_components.code,{children:`quote`}),`) fornecem ao cliente uma taxa de conversão determinística de origem para destino, válida por uma janela fixa (30, 60 ou 300 segundos). A cotação captura o valor de origem, valor de destino, taxa de câmbio e detalhamento completo de taxas (integrador + plataforma) no momento da emissão. Uma cotação pode ser resgatada exatamente uma vez, passando seu ID ao chamar `,_jsx(_components.a,{href:`/pt-BR/api-reference/transfer/post`,children:`Criar Transferência`}),`.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`As cotações são mais úteis para `,_jsx(_components.strong,{children:`trading`}),` e `,_jsx(_components.strong,{children:`pagamentos cross-border`}),` onde o cliente precisa ver a taxa exata que receberá antes de confirmar a transferência. Para transferências com taxa flutuante (ex.: folha de pagamento, rebalanceamento de tesouraria), ignore a cotação e chame `,_jsx(_components.code,{children:`/v2/transfer`}),` diretamente.`]})})]})}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":"Criar uma Cotação com Taxa Bloqueada","sidebarTitle":"Criar Cotação","openapi":"openapi/spherepay.yaml POST /v2/quote","source_file":"api-reference/quote/post.mdx","source_language":"en","translation_language":"pt-BR","source_commit":"6c9107b","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":"/pt-BR/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":"f8e74003-65b4-43df-872e-e1663e3368ed","responses":{"201":"148ae7d9-63e4-4a3a-a3b4-25897e5255e8","400":"82b8f267-ce1d-4ca2-a1fe-297e20fb5e6e","404":"b7ac76ca-a517-4e76-bb19-4b1698677339","422":"1cf15f0f-59ff-47f9-99e2-345caf84cfd9"},"summary":"Create a Quote","method":"post","type":"path","servers":["b5036787-7020-43a8-8dee-cb8b0d270e6a"],"security":["d8f4bc21-1820-4e73-bc5e-ea3b587aeee8"],"path":"/v2/quote","baseUrlOptions":["https://api.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":{"148ae7d9-63e4-4a3a-a3b4-25897e5255e8":{"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"},"82b8f267-ce1d-4ca2-a1fe-297e20fb5e6e":{"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"},"b7ac76ca-a517-4e76-bb19-4b1698677339":{"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"},"1cf15f0f-59ff-47f9-99e2-345caf84cfd9":{"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":{"d8f4bc21-1820-4e73-bc5e-ea3b587aeee8":{"bearer":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"}}},"servers":{"b5036787-7020-43a8-8dee-cb8b0d270e6a":{"description":"Production","url":"https://api.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":"Criar uma Cotação com Taxa Bloqueada - SpherePay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/quote/post","matchLevel":1},"es":{"href":"/es/api-reference/quote/post","matchLevel":1},"pt-BR":{"href":"/pt-BR/api-reference/quote/post","matchLevel":0}}},"lastModified":"2026-06-18T02:06:48.699Z","gitLastModified":"2026-06-22T23:09:36.000Z","originalFileLocation":"pt-BR/api-reference/quote/post.mdx","locale":"pt-BR"},"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=\"Criar uma Cotação com Taxa Bloqueada - 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/pt-BR/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=Cota%C3%A7%C3%B5es\u0026amp;title=Criar+uma+Cota%C3%A7%C3%A3o+com+Taxa+Bloqueada\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=61eac4cb45412acffc05b73c906a48c699e1922ad0a4d09fb3323ee3b1b2c7ab\">\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=\"Criar uma Cotação com Taxa Bloqueada - 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=Cota%C3%A7%C3%B5es\u0026amp;title=Criar+uma+Cota%C3%A7%C3%A3o+com+Taxa+Bloqueada\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=61eac4cb45412acffc05b73c906a48c699e1922ad0a4d09fb3323ee3b1b2c7ab\">\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/pt-BR/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=\"/pt-BR/api-reference/quote/post.md\">\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=\"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=\"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/pt-BR/api-reference/quote/post#webpage\",\"url\":\"https://docs.spherepay.co/pt-BR/api-reference/quote/post\",\"name\":\"Criar uma Cotação com Taxa Bloqueada\",\"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-22T23:09:36.000Z\",\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spherepay.co/pt-BR/api-reference/quote/post#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spherepay.co/pt-BR/api-reference/quote/post#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Movimentação de dinheiro\",\"item\":\"https://docs.spherepay.co/pt-BR/api-reference/transfer/post\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Criar uma Cotação com Taxa Bloqueada\",\"item\":\"https://docs.spherepay.co/pt-BR/api-reference/quote/post\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.spherepay.co/pt-BR/api-reference/quote/post#apireference\",\"headline\":\"Criar uma Cotação com Taxa Bloqueada\",\"name\":\"Criar uma Cotação com Taxa Bloqueada\",\"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/pt-BR/api-reference/quote/post\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spherepay.co/pt-BR/api-reference/quote/post#webpage\"},\"dateModified\":\"2026-06-22T23:09:36.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":"/pt-BR/api-reference/quote/post.md","siteName":"SpherePay","nav":{"global":null,"languages":[{"language":"en","default":true,"pages":[{"title":"en","href":"/api-reference/quote/post"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/quote/post"}]},{"language":"pt-BR","tabs":[{"tab":"Começar","pages":[{"title":"Começar","href":"/pt-BR/introduction"}]},{"tab":"Conceitos","pages":[{"title":"Conceitos","href":"/pt-BR/concepts/overview"}]},{"tab":"Guias","pages":[{"title":"Guias","href":"/pt-BR/implementation-guides/overview"}]},{"tab":"Soluções","pages":[{"title":"Soluções","href":"/pt-BR/solutions/overview"}]},{"tab":"Referência da API","groups":[{"group":"Onboarding","pages":[{"group":"Clientes","icon":"user","pages":[{"title":"Criar um Cliente Individual ou Empresarial","sidebarTitle":"Criar Cliente","openapi":"openapi/spherepay.yaml POST /v2/customer","href":"/pt-BR/api-reference/customer/post"},{"title":"Listar Clientes com Filtros e Paginação","sidebarTitle":"Listar Clientes","openapi":"openapi/spherepay.yaml GET /v2/customer","href":"/pt-BR/api-reference/customer/get"},{"title":"Recuperar um Cliente com Status de Verificação","sidebarTitle":"Obter Cliente","openapi":"openapi/spherepay.yaml GET /v2/customer/{id}","href":"/pt-BR/api-reference/customer/get-id"},{"title":"Atualizar Endereço, Telefone ou E-mail do Cliente","sidebarTitle":"Atualizar Cliente","openapi":"openapi/spherepay.yaml PATCH /v2/customer/{id}","href":"/pt-BR/api-reference/customer/patch-id"}]},{"group":"Links de Onboarding","icon":"link","pages":[{"title":"Criar Cliente via Link","sidebarTitle":"Criar Cliente via Link","openapi":"openapi/spherepay.yaml POST /v2/customer/kyc-link","href":"/pt-BR/api-reference/customer/kyc-link"},{"title":"Regenerar o Link KYC de um Cliente","sidebarTitle":"Regenerar Link KYC","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/kyc-link","href":"/pt-BR/api-reference/customer/kyc"}]},{"group":"Documentos e Verificação","icon":"file-check","pages":[{"title":"Enviar Documentos de Identidade KYC e KYB","sidebarTitle":"Enviar Documento","openapi":"openapi/spherepay.yaml POST /v2/document","href":"/pt-BR/api-reference/document/post"},{"title":"Gerar Link de Verificação Facial para Cliente","sidebarTitle":"Link de Verificação Facial","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/face-verification-link","href":"/pt-BR/api-reference/enhanced-due-diligence/face-verification-link"},{"title":"Gerar Link de Verificação Facial para UBO no KYB","sidebarTitle":"Link de Verificação Facial UBO","openapi":"openapi/spherepay.yaml POST /v2/business-representative/{id}/face-verification-link","href":"/pt-BR/api-reference/enhanced-due-diligence/ubo-face-verification-link"},{"title":"Enviar Código OTP para Verificação do Cliente","sidebarTitle":"Enviar Código de Verificação","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-send","href":"/pt-BR/api-reference/enhanced-due-diligence/send-verification-code"},{"title":"Verificar Código OTP do Cliente para E-mail ou Telefone","sidebarTitle":"Verificar Código OTP","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-verify","href":"/pt-BR/api-reference/enhanced-due-diligence/verify-verification-code"},{"title":"Registrar Aceite dos Termos de Serviço do Cliente","sidebarTitle":"Aceitar Termos de Serviço","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/tos-link","href":"/pt-BR/api-reference/enhanced-due-diligence/tos"}]},{"group":"Representantes Empresariais","icon":"users","pages":[{"title":"Registrar um UBO Empresarial para Verificação KYB","sidebarTitle":"Registrar Representante","openapi":"openapi/spherepay.yaml POST /v2/business-representative","href":"/pt-BR/api-reference/business-representative/post"},{"title":"Listar Todos os Representantes Empresariais e UBOs","sidebarTitle":"Listar Representantes","openapi":"openapi/spherepay.yaml GET /v2/business-representative","href":"/pt-BR/api-reference/business-representative/get"},{"title":"Recuperar um Representante Empresarial por ID","sidebarTitle":"Obter Representante","openapi":"openapi/spherepay.yaml GET /v2/business-representative/{id}","href":"/pt-BR/api-reference/business-representative/get-id"},{"title":"Atualizar um Representante Empresarial Antes do KYB","sidebarTitle":"Atualizar Representante","openapi":"openapi/spherepay.yaml PATCH /v2/business-representative/{id}","href":"/pt-BR/api-reference/business-representative/patch-id"},{"title":"Remover um Representante Empresarial ou UBO","sidebarTitle":"Excluir Representante","openapi":"openapi/spherepay.yaml DELETE /v2/business-representative/{id}","href":"/pt-BR/api-reference/business-representative/delete-id"}]}]},{"group":"Contas","pages":[{"group":"Contas Bancárias","icon":"landmark","pages":[{"title":"Registrar uma Conta Bancária do Cliente para Transferências","sidebarTitle":"Registrar Conta Bancária","openapi":"openapi/spherepay.yaml POST /v2/bank-account","href":"/pt-BR/api-reference/bank-account/post"},{"title":"Listar Todas as Contas Bancárias Registradas do Cliente","sidebarTitle":"Listar Contas Bancárias","openapi":"openapi/spherepay.yaml GET /v2/bank-account","href":"/pt-BR/api-reference/bank-account/get"},{"title":"Recuperar uma Conta Bancária por ID","sidebarTitle":"Obter Conta Bancária","openapi":"openapi/spherepay.yaml GET /v2/bank-account/{id}","href":"/pt-BR/api-reference/bank-account/get-id"},{"title":"Atualizar Configurações de Rail da Conta Bancária","sidebarTitle":"Atualizar Conta Bancária","openapi":"openapi/spherepay.yaml PATCH /v2/bank-account/{id}","href":"/pt-BR/api-reference/bank-account/patch-id"},{"title":"Excluir uma Conta Bancária Registrada do Cliente","sidebarTitle":"Excluir Conta Bancária","openapi":"openapi/spherepay.yaml DELETE /v2/bank-account/{id}","href":"/pt-BR/api-reference/bank-account/delete-id"}]},{"group":"Carteiras","icon":"wallet","pages":[{"title":"Registrar uma Carteira Cripto do Cliente para Transferências","sidebarTitle":"Registrar Carteira","openapi":"openapi/spherepay.yaml POST /v2/wallet","href":"/pt-BR/api-reference/wallet/post"},{"title":"Listar Todas as Carteiras Cripto Registradas do Cliente","sidebarTitle":"Listar Carteiras","openapi":"openapi/spherepay.yaml GET /v2/wallet","href":"/pt-BR/api-reference/wallet/get"},{"title":"Recuperar uma Carteira Cripto do Cliente por ID","sidebarTitle":"Obter Carteira","openapi":"openapi/spherepay.yaml GET /v2/wallet/{id}","href":"/pt-BR/api-reference/wallet/get-id"},{"title":"Remover uma Carteira Cripto Registrada do Cliente","sidebarTitle":"Excluir Carteira","openapi":"openapi/spherepay.yaml DELETE /v2/wallet/{id}","href":"/pt-BR/api-reference/wallet/delete-id"}]}]},{"group":"Movimentação de dinheiro","pages":[{"group":"Transferências","icon":"arrow-right-left","pages":[{"title":"Criar uma Transferência On-Ramp ou Off-Ramp","sidebarTitle":"Criar Transferência","openapi":"openapi/spherepay.yaml POST /v2/transfer","href":"/pt-BR/api-reference/transfer/post"},{"title":"Listar Transferências On-Ramp e Off-Ramp","sidebarTitle":"Listar Transferências","openapi":"openapi/spherepay.yaml GET /v2/transfer","href":"/pt-BR/api-reference/transfer/get"},{"title":"Recuperar uma Transferência com Instruções de Depósito","sidebarTitle":"Obter Transferência","openapi":"openapi/spherepay.yaml GET /v2/transfer/{id}","href":"/pt-BR/api-reference/transfer/get-id"},{"title":"Cancelar uma Transferência Pendente Não Financiada","sidebarTitle":"Cancelar Transferência","openapi":"openapi/spherepay.yaml DELETE /v2/transfer/{id}","description":"Cancel a specific transfer.","href":"/pt-BR/api-reference/transfer/delete-id"}]},{"group":"Cotações","icon":"calculator","pages":[{"title":"Criar uma Cotação com Taxa Bloqueada","sidebarTitle":"Criar Cotação","openapi":"openapi/spherepay.yaml POST /v2/quote","href":"/pt-BR/api-reference/quote/post"},{"title":"Listar Todas as Cotações com Taxa Bloqueada da Sua Conta","sidebarTitle":"Listar Cotações","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":"/pt-BR/api-reference/quote/get"},{"title":"Recuperar uma Cotação por ID","sidebarTitle":"Obter Cotação","openapi":"openapi/spherepay.yaml GET /v2/quote/{id}","href":"/pt-BR/api-reference/quote/get-id"},{"title":"Atualizar Status da Cotação","sidebarTitle":"Atualizar Cotação","openapi":"openapi/spherepay.yaml PUT /v2/quote/{id}","href":"/pt-BR/api-reference/quote/put-id"}]},{"group":"Contas Virtuais","icon":"credit-card","pages":[{"title":"Criar uma Conta Bancária Virtual para On-Ramp de Fiat","sidebarTitle":"Criar Conta Virtual","openapi":"openapi/spherepay.yaml POST /v2/virtual-account","href":"/pt-BR/api-reference/virtual-account/post"},{"title":"Listar Todas as Contas Bancárias Virtuais Onramper","sidebarTitle":"Listar Contas Virtuais","openapi":"openapi/spherepay.yaml GET /v2/virtual-account","href":"/pt-BR/api-reference/virtual-account/get"},{"title":"Recuperar uma Onramper Account por ID","sidebarTitle":"Obter Conta Virtual","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}","href":"/pt-BR/api-reference/virtual-account/get-id"},{"title":"Atualizar a Carteira de Destino de uma Onramper Account","sidebarTitle":"Atualizar Conta Virtual","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}","href":"/pt-BR/api-reference/virtual-account/patch"},{"title":"Listar Transferências de uma Onramper Account","sidebarTitle":"Listar Transferências da Conta","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}/transfer","href":"/pt-BR/api-reference/virtual-account/list-transfers"},{"title":"Desativar uma Conta Bancária Virtual Onramper","sidebarTitle":"Desativar Conta","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/deactivate","href":"/pt-BR/api-reference/virtual-account/deactivate"},{"title":"Reativar uma Onramper Account Desativada","sidebarTitle":"Reativar Conta","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/reactivate","href":"/pt-BR/api-reference/virtual-account/reactivate"}]},{"group":"Offloader Wallets","icon":"arrow-up-from-line","pages":[{"title":"Criar uma Offloader Wallet para Pagamentos em Cripto","sidebarTitle":"Criar Offloader Wallet","openapi":"openapi/spherepay.yaml POST /v2/offloader-wallet","href":"/pt-BR/api-reference/offloader-wallet/post"},{"title":"Listar Todas as Offloader Wallets da Sua Conta","sidebarTitle":"Listar Offloader Wallets","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet","href":"/pt-BR/api-reference/offloader-wallet/get"},{"title":"Recuperar uma Offloader Wallet por ID","sidebarTitle":"Obter Offloader Wallet","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet/{id}","href":"/pt-BR/api-reference/offloader-wallet/get-id"},{"title":"Atualizar o Destino Bancário de uma Offloader Wallet","sidebarTitle":"Atualizar Offloader Wallet","openapi":"openapi/spherepay.yaml PATCH /v2/offloader-wallet/{id}","href":"/pt-BR/api-reference/offloader-wallet/patch-id"}]}]},{"group":"Webhooks","pages":[{"group":"Endpoints de Webhook","icon":"plug","pages":[{"title":"Registrar um Endpoint de Webhook para Entrega de Eventos","sidebarTitle":"Criar Endpoint de Webhook","openapi":"openapi/spherepay.yaml POST /v2/webhook-endpoints","href":"/pt-BR/api-reference/webhook-endpoints/post"},{"title":"Listar Todos os Endpoints de Webhook Registrados","sidebarTitle":"Listar Endpoints de Webhook","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints","href":"/pt-BR/api-reference/webhook-endpoints/get"},{"title":"Recuperar um Endpoint de Webhook por ID","sidebarTitle":"Obter Endpoint de Webhook","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints/{id}","href":"/pt-BR/api-reference/webhook-endpoints/get-id"},{"title":"Excluir um Endpoint de Webhook","sidebarTitle":"Excluir Endpoint de Webhook","openapi":"openapi/spherepay.yaml DELETE /v2/webhook-endpoints/{id}","href":"/pt-BR/api-reference/webhook-endpoints/delete-id"}]},{"group":"Eventos","icon":"bell","pages":[{"title":"Listar Eventos e seu Status de Entrega","sidebarTitle":"Listar Eventos","openapi":"openapi/spherepay.yaml GET /v2/events","href":"/pt-BR/api-reference/events/get"},{"title":"Recuperar um Evento com o Histórico Completo de Entregas","sidebarTitle":"Obter Evento","openapi":"openapi/spherepay.yaml GET /v2/events/{id}","href":"/pt-BR/api-reference/events/get-id"},{"title":"Reenviar uma Entrega de Evento com Falha","sidebarTitle":"Reenviar Entrega","openapi":"openapi/spherepay.yaml POST /v2/events/replay/{eventDeliveryId}","href":"/pt-BR/api-reference/events/replay"}]}]}]},{"tab":"Notas","pages":[{"title":"Notas","href":"/pt-BR/changelog"}]},{"tab":"FAQ","href":"https://spherepay-knowledge-base.help.usepylon.com/"}]}]},"basePath":"","title":"Criar uma Cotação com Taxa Bloqueada - SpherePay","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}