Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote
that must be referenced in POST /v1/payouts via quoteId. Quotes expire at expiresAt.
Specify either from.amount (exact-in: debit a fixed USDC amount) or to.amount
(exact-out: deliver a fixed fiat amount). Exactly one must be set.
When to.rail is omitted, one quote per available live rail is returned. When to.rail
is specified, only that rail is quoted.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Circle Docs","description":"Developer documentation for Circle's developer tools","colors":{"primary":"#0073C3","light":"#90D2FF","dark":"#0073C3"},"logo":{"light":"https://mintcdn.com/circle-167b8d39/K2XWSLhaeRomzNa1/logo/light.svg?fit=max\u0026auto=format\u0026n=K2XWSLhaeRomzNa1\u0026q=85\u0026s=decfb42837e0eb7c32dd425866902e78","dark":"https://mintcdn.com/circle-167b8d39/K2XWSLhaeRomzNa1/logo/dark.svg?fit=max\u0026auto=format\u0026n=K2XWSLhaeRomzNa1\u0026q=85\u0026s=8b863d97bf31467e8adedf4cb3263012"},"favicon":"https://mintcdn.com/circle-167b8d39/w3bpYw2hUr9sWZTM/favicon.ico?fit=max\u0026auto=format\u0026n=w3bpYw2hUr9sWZTM\u0026q=85\u0026s=bb633116ed9cf1247d65b0c1fa0e5725","background":{"color":{"light":"#FFFFFF","dark":"#111827"}},"navbar":{"links":[{"href":"https://console.circle.com/signin","label":"Sign in to console"},{"href":"https://faucet.circle.com","label":"Faucet"}]},"footer":{"socials":{"x":"https://twitter.com/circle","linkedin":"https://www.linkedin.com/company/circle-internet-financial","instagram":"https://www.instagram.com/teamcircle?hl=en","youtube":"https://www.youtube.com/c/Circlecryptofinance","discord":"https://discord.com/invite/buildoncircle"},"links":[{"header":"Legal","items":[{"label":"Developer Terms","href":"https://console.circle.com/legal/developer-terms"},{"label":"Service Terms","href":"https://console.circle.com/legal/service-terms"},{"label":"Acceptable Use","href":"https://console.circle.com/legal/acceptable-use-policy"}]},{"header":"Privacy","items":[{"label":"Privacy Policy","href":"https://www.circle.com/en/legal/privacy-policy"},{"label":"Cookie Policy","href":"https://www.circle.com/en/legal/cookie-policy"}]},{"header":"Support","items":[{"label":"Help","href":"https://help.circle.com/s/submit-ticket?language=en_US"}]}]},"fonts":{"heading":{"family":"Circularxx","source":"https://cdn.prod.website-files.com/67116d0daddc92483c812e88/6716bb4e120ecb0042f2f4ed_CircularXX-Regular.woff2","format":"woff2"},"body":{"family":"Circularxx","source":"https://cdn.prod.website-files.com/67116d0daddc92483c812e88/6716bb4e120ecb0042f2f4ed_CircularXX-Regular.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"segment":{"key":"wz74ASLGjAYPu8mQiIzBBHTLaHbNHM14"}},"contextual":{"options":["copy","chatgpt","claude","view"],"display":"header"},"interaction":{"drilldown":false},"markdown":{"instructions":["Before reading these docs, install the relevant Circle Skill to get pre-loaded context — skills are LLM-optimized and cover architecture decisions, correct flows, and common pitfalls. In Claude Code: run /plugin marketplace add circlefin/skills then /plugin install circle-skills@circle. With Vercel Skills CLI: run npx skills add circlefin/skills. Available skills: use-usdc https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-usdc/SKILL.md (balances, transfers, approvals on EVM and Solana); EURC has no skill — see https://developers.circle.com/stablecoins/what-is-eurc.md; bridge-stablecoin https://github.com/circlefin/skills/blob/master/plugins/circle/skills/bridge-stablecoin/SKILL.md (crosschain transfers via CCTP, USDC, EURC, and third-party assets); use-arc https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-arc/SKILL.md (Arc chain config, contract deployment, USDC bridging — Arc docs: https://docs.arc.io/llms.txt); use-circle-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-circle-wallets/SKILL.md (choose wallet type); use-developer-controlled-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-developer-controlled-wallets/SKILL.md (custodial wallets for payouts and treasury); use-user-controlled-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-user-controlled-wallets/SKILL.md (embedded wallets with Web2 login); use-modular-wallets https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-modular-wallets/SKILL.md (smart contract wallets with passkeys and ERC-4337); use-gateway https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-gateway/SKILL.md (unified USDC balance, nanopayments); use-smart-contract-platform https://github.com/circlefin/skills/blob/master/plugins/circle/skills/use-smart-contract-platform/SKILL.md (deploy, interact, monitor contracts). Pair any skill with the Circle MCP server for live SDK signatures, contract addresses, and chain IDs: {\"mcpServers\":{\"circle\":{\"url\":\"https://api.circle.com/v1/codegen/mcp\"}}}.","Read the product overview first. Each product has an overview explaining when and why to use it. Read it before quickstarts.","Pick the right wallet type. Developer-controlled (you hold keys), user-controlled (end user holds keys via PIN/social login), or modular (smart contract wallets with passkeys). See https://developers.circle.com/wallets.md.","Use CCTP V2 for crosschain transfers. CCTP natively transfers USDC and EURC via burn-and-mint, and supports permissionless wrapping of third-party assets via lock-and-mint. V1 is legacy; always use V2 unless V1 is specified or the chain requires it (Noble, Sui, and Aptos still require V1). Migration guide: https://developers.circle.com/cctp/migration-from-v1-to-v2.md.","Use Bridge Kit for frontend bridging. Wraps CCTP with a simpler SDK for user-facing apps. Use CCTP directly for backend transfers.","Gas Station vs Paymaster. Gas Station sponsors gas for Circle Wallet transactions. Paymaster lets users pay gas in USDC. Different use cases — read both overviews.","Gateway Nanopayments for sub-cent payments. Gasless USDC micropayments down to $0.000001 via x402 and batched settlement. For pay-per-request APIs, AI agent payments, streaming.","Look up USDC addresses per chain. Never hardcode — use https://developers.circle.com/stablecoins/usdc-contract-addresses.md.","Prefer SDKs over raw API calls. Node.js and Python SDKs handle auth, retries, and errors.","API key required. Bearer token in Authorization header. Testnet and mainnet use separate keys and may use different base URLs depending on the product.","Set up webhooks when available. Most operations are async. Webhooks deliver transaction confirmations and state changes.","When calling list endpoints, paginate using pageSize and pageAfter until no nextPageAfter cursor is returned—stopping at the first page silently misses records.","Building an AI agent? Start with the Agent Stack—Circle CLI, agent wallets, and nanopayments built for autonomous use cases: https://developers.circle.com/agent-stack.md."]},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"circle-167b8d39","hasAudioNarration":false,"actualSubdomain":"circle-167b8d39","customDomains":["developers.circle.com"],"gitSource":{"type":"github","owner":"crcl-main","repo":"circle-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af34022926281184455f8e1","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API reference","count":603},{"language":"default","tag":"Circle Payments Network","count":166},{"language":"default","tag":"Wallets","count":159},{"language":"default","tag":"Mint and Custody","count":131},{"language":"default","tag":"StableFX","count":108},{"language":"default","tag":"Liquidity services","count":105},{"language":"default","tag":"Digital Asset Accounts","count":104},{"language":"default","tag":"Crosschain transfers","count":102},{"language":"default","tag":"Payments","count":94},{"language":"default","tag":"Managed Payments","count":86}]},"assistantConfig":{"enableAskAiButton":false,"enableAskAiSearchBar":false},"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instinct-self-updating-docs","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"snippets/SDKCard.css","content":".cb-card{border:1px solid #e5e7eb;border-radius:12px;background:white;box-shadow:0 1px 3px 0 rgba(0, 0, 0, 0.1)}.cb-icon-circle{display:flex;align-items:center;justify-content:center;border-radius:50%;flex-shrink:0}.accent-orange{background-color:#fff7ed;color:#ea580c}.accent-blue{background-color:#eff6ff;color:#2563eb}.accent-green{background-color:#f0fdf4;color:#16a34a}.accent-purple{background-color:#faf5ff;color:#9333ea}.accent-violet{background-color:#f5f3ff;color:#7c3aed}.type-header-xs{font-size:18px;font-weight:600;line-height:1.4;color:#111827}.type-body-base{font-size:14px;line-height:1.5;color:#6b7280}.type-body-xs-bold{font-size:12px;font-weight:600;text-transform:uppercase;letter-spacing:0.05em;color:#6b7280}.type-body-sm{font-size:14px;line-height:1.5;color:#374151}.type-body-sm-bold{font-size:14px;font-weight:600;line-height:1.5}.text-neutral-subtle{color:#6b7280}.text-icon-neutral{color:#6b7280}.cb-button{display:inline-flex;align-items:center;padding:8px 16px;border-radius:8px;font-size:14px;font-weight:500;text-decoration:none;transition:all 0.2s;border:1px solid #e5e7eb;background:white;color:#374151}.cb-button:hover{background:#f9fafb;border-color:#d1d5db}"},{"filePath":"style.css","content":":root{--background-dark: 17 24 39 !important}html.dark .card{background-color:#111827!important}html.dark .accordion{background-color:#111827!important}#navbar [data-component-name=\"theme-toggle\"],#navbar a[href*=\"console.circle.com\"],#navbar a[href*=\"faucet.circle.com\"],#navbar .navbar-link a{background-color:rgba(17, 24, 39, 0.03)!important}#navbar [data-component-name=\"theme-toggle\"]:hover,#navbar a[href*=\"console.circle.com\"]:hover,#navbar a[href*=\"faucet.circle.com\"]:hover,#navbar .navbar-link a:hover{background-color:rgba(17, 24, 39, 0.07)!important}@media (prefers-color-scheme: dark){#navbar [data-component-name=\"theme-toggle\"],#navbar a[href*=\"console.circle.com\"],#navbar a[href*=\"faucet.circle.com\"],#navbar .navbar-link a{background-color:rgba(255, 255, 255, 0.05)!important}#navbar [data-component-name=\"theme-toggle\"]:hover,#navbar a[href*=\"console.circle.com\"]:hover,#navbar a[href*=\"faucet.circle.com\"]:hover,#navbar .navbar-link a:hover{background-color:rgba(255, 255, 255, 0.10)!important}}html.dark #navbar [data-component-name=\"theme-toggle\"],html.dark #navbar a[href*=\"console.circle.com\"],html.dark #navbar a[href*=\"faucet.circle.com\"],html.dark #navbar .navbar-link a{background-color:rgba(255, 255, 255, 0.05)!important}html.dark #navbar [data-component-name=\"theme-toggle\"]:hover,html.dark #navbar a[href*=\"console.circle.com\"]:hover,html.dark #navbar a[href*=\"faucet.circle.com\"]:hover,html.dark #navbar .navbar-link a:hover{background-color:rgba(255, 255, 255, 0.10)!important}html.dark #topbar-cta-button,html.dark #topbar-cta-button a{color:#000000!important}html.dark #feedback-form-submit{color:#000000!important}html.dark tryit-button{color:#000000!important}html.dark chat-assistant-send-button{color:#000000!important}html.dark contextual-feedback-form-submit-button{color:#000000!important}html.dark code-snippet-feedback-form-submit-button{color:#000000!important}html.dark a[class*=\"bg-[#5FBFFF]\"],html.dark a[class*=\"bg-[#90D2FF]\"],html.dark a[class*=\"bg-[#1AA3FF]\"],html.dark a[class*=\"bg-[#0073C3]\"]{color:#000000!important}html.dark a[class*=\"bg-[#5FBFFF]\"] svg,html.dark a[class*=\"bg-[#90D2FF]\"] svg,html.dark a[class*=\"bg-[#1AA3FF]\"] svg,html.dark a[class*=\"bg-[#0073C3]\"] svg{color:#000000!important}.mcp-setup-container{display:flex;flex-wrap:wrap;gap:24px;margin:20px 0 28px}.mcp-setup-section{display:flex;flex-direction:column;gap:8px}.mcp-setup-label{font-size:0.75rem;font-weight:500;text-transform:uppercase;letter-spacing:0.05em;color:#64748b}.dark .mcp-setup-label{color:#94a3b8}.mcp-cta-group{display:flex;flex-wrap:wrap;gap:10px}.mcp-cta{height:40px;border-radius:12px;font-weight:600;font-size:0.875rem;padding:0 16px;text-decoration:none!important;display:inline-flex;align-items:center;gap:8px;border:1px solid rgba(15, 23, 42, 0.15);background-color:#f8fafc;color:#0b0f19;transition:background-color 0.15s ease, border-color 0.15s ease;cursor:pointer}.mcp-cta:hover{background-color:#f1f5f9;border-color:rgba(15, 23, 42, 0.25)}.mcp-cta img{width:20px;height:20px;object-fit:contain;border-radius:6px;flex-shrink:0}.mcp-cta span{white-space:nowrap}.dark .mcp-cta{border-color:rgba(255, 255, 255, 0.2);background-color:rgba(255, 255, 255, 0.08);color:#f8fafc}.dark .mcp-cta:hover{background-color:rgba(255, 255, 255, 0.12);border-color:rgba(255, 255, 255, 0.3)}.mcp-cta-cli{background-color:#f1f5f9;border-color:#e2e8f0}.mcp-cta-cli:hover{background-color:#e2e8f0;border-color:#cbd5e1}.dark .mcp-cta-cli{background-color:rgba(255, 255, 255, 0.06);border-color:rgba(255, 255, 255, 0.15)}.dark .mcp-cta-cli:hover{background-color:rgba(255, 255, 255, 0.1);border-color:rgba(255, 255, 255, 0.25)}.mcp-cli-label{font-weight:600;color:#0f172a}.dark .mcp-cli-label{color:#f1f5f9}.mcp-cli-cmd{font-size:0.75rem;font-family:ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace;color:#64748b;background:transparent!important;padding:0;white-space:nowrap;border:none}.dark .mcp-cli-cmd{color:#94a3b8;background:transparent!important}.mcp-cli-icon-wrap{display:flex;align-items:center;justify-content:center;flex-shrink:0;width:14px;height:14px;position:relative}.mcp-cli-icon-wrap svg{color:#94a3b8;transition:opacity 0.15s ease}.mcp-cta-cli:hover .mcp-cli-icon-wrap svg{color:#64748b}.dark .mcp-cli-icon-wrap svg{color:#64748b}.dark .mcp-cta-cli:hover .mcp-cli-icon-wrap svg{color:#94a3b8}.mcp-icon-check{position:absolute;opacity:0;color:#22c55e!important}.mcp-cta-cli.copied .mcp-icon-copy{opacity:0}.mcp-cta-cli.copied .mcp-icon-check{opacity:1}.dark .mcp-cli-openai-logo{filter:invert(1)}table thead{text-align:left;background-color:#f5f5f8}.dark table thead{text-align:left;background-color:#29233b}table thead th,table td{padding:8px!important}.accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]){background-color:#e1f2ff!important;border-color:#c9e1f5!important}.accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) summary{transition:background-color 0.3s ease!important}.accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) summary:hover{background-color:#c9e1f5!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]){background-color:#1f1a30!important;border-color:#29233b!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) summary{transition:background-color 0.3s ease!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) summary:hover{background-color:#29233b!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) [data-component-part=\"accordion-title\"]{color:#ffffff!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) [data-component-part=\"accordion-content\"]{color:#e5e7eb!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) [data-component-part=\"accordion-content\"] a{color:#1aa3ff!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) [data-component-part=\"accordion-content\"] a:hover{color:#1894e8!important}.dark .accordion:has([data-component-part=\"accordion-icon\"] svg[style*=\"circle-info.svg\"]) [data-component-part=\"accordion-content\"] code{color:#fbbf24!important;background-color:#374151!important}.TryItOutComponent pre,.TryItOutComponent code{background-color:transparent!important}.TryItOutComponent .code-container{background-color:white!important}.dark .TryItOutComponent .code-container{background-color:#29233b!important}.home_code_container .code-block{margin:0!important;height:100%}.home_code_container .code-block .code-block-background{height:100%!important}.home_mint_cards a.card>div{padding:20px!important}.home_mint_cards h2{color:#29233b!important}.home_mint_cards div.prose span{color:#6b6580!important}.dark .home_mint_cards h2{color:#fff!important}.dark .home_mint_cards div.prose span{color:#9ca3af!important}.home_mint_cards a.card svg{background-color:#6b6580!important}.home_mint_cards a.card:hover svg{background:linear-gradient(135deg, #5fbfff 0%, #b090f5 100%)!important}.home_tryitout{background:linear-gradient(\n 89deg,\n var(\n --background-gradient-bg-accent-purple-gradient-bottom-left,\n rgba(241, 235, 255, 0.5)\n )\n 0%,\n var(\n --background-gradient-bg-accent-purple-gradient-top-right,\n rgba(225, 242, 255, 0.5)\n )\n 94.58%\n )}.dark .home_tryitout{background:linear-gradient(\n 89deg,\n var(\n --background-gradient-bg-accent-purple-gradient-bottom-left,\n rgba(44, 44, 44, 0.5)\n )\n 0%,\n var(\n --background-gradient-bg-accent-purple-gradient-top-right,\n rgba(75, 82, 86, 0.5)\n )\n 94.58%\n )}.quickstart-cards-aligned [data-component-part=\"card-group\"]{gap:16px!important}.asset-card-grid{display:grid;grid-template-columns:repeat(auto-fit, minmax(220px, 1fr));gap:1.5rem;margin:1.5rem 0;align-items:stretch}.asset-card{border:1px solid #e5e7eb;border-radius:1rem;background:transparent;padding:1rem 1.25rem 1.5rem;text-decoration:none;color:inherit;display:flex;flex-direction:column;justify-content:space-between;gap:0.45rem;transition:border-color 0.2s ease, box-shadow 0.2s ease, transform 0.2s ease;height:100%}.asset-card:hover{border-color:#cfd3dc;box-shadow:0 12px 24px rgba(15, 23, 42, 0.08);transform:translateY(-2px)}.dark .asset-card{border-color:rgba(148, 163, 184, 0.14);background:transparent;box-shadow:none}.asset-card h3{font-size:1.125rem;font-weight:600;margin:0;color:#0f172a}.dark .asset-card h3{color:#f8fafc}.asset-card p{margin:0;font-weight:300;color:#475569}.dark .asset-card p{color:#b8b8b8}.asset-card-image-wrapper,.asset-card-inline-icon{width:56px;height:56px;border-radius:9999px;margin-bottom:0.6rem;flex-shrink:0}.asset-card-image-wrapper{overflow:hidden;display:flex;align-items:center;justify-content:center;background:rgba(15, 23, 42, 0.05)}.dark .asset-card-image-wrapper{background:rgba(248, 250, 252, 0.08)}.asset-card-image{width:100%;height:100%;object-fit:cover;display:block}.asset-card-inline-icon{padding:10px;display:flex;align-items:center;justify-content:center;background:linear-gradient(\n 135deg,\n rgba(0, 96, 255, 0.18),\n rgba(0, 164, 255, 0.05)\n );color:#0d5be1}.dark .asset-card-inline-icon{background:rgba(255, 255, 255, 0.08);color:#82b7ff}.asset-card-inline-icon svg{width:26px;height:26px}.asset-card.secondary{justify-content:flex-start}.quickstart-cards-aligned a.card,.quickstart-cards-aligned [data-component-part=\"card\"]{display:flex!important;flex-direction:column!important;height:100%!important}.quickstart-cards-aligned a.card>div,.quickstart-cards-aligned [data-component-part=\"card\"]>div{display:flex!important;flex-direction:column!important;height:100%!important}.quickstart-cards-aligned a.card>div>.prose,.quickstart-cards-aligned [data-component-part=\"card\"]>div>.prose{flex-grow:1!important;display:flex!important;flex-direction:column!important}.quickstart-cards-aligned a.card>div>div:last-child,.quickstart-cards-aligned [data-component-part=\"card\"]>div>div:last-child{margin-top:auto!important}@media (max-width: 1024px){div.quickstart-cards-aligned,.quickstart-cards-aligned{display:flex!important;flex-direction:column!important;gap:4px!important}div.quickstart-cards-aligned [data-component-part=\"card-group\"],div.quickstart-cards-aligned>div,.quickstart-cards-aligned [data-component-part=\"card-group\"],.quickstart-cards-aligned>div{display:flex!important;flex-direction:column!important;gap:4px!important;row-gap:4px!important;grid-row-gap:4px!important;width:100%!important}div.quickstart-cards-aligned a.card,.quickstart-cards-aligned a.card,.quickstart-cards-aligned [data-component-part=\"card\"]{margin-bottom:4px!important;width:100%!important}div.quickstart-cards-aligned a.card:last-child,.quickstart-cards-aligned a.card:last-child,.quickstart-cards-aligned [data-component-part=\"card\"]:last-child{margin-bottom:0!important}}footer,footer>div,footer [data-component-part=\"footer\"],footer [data-component-part=\"footer-section\"]{overflow-x:hidden!important;max-width:100%!important;padding-top:1.75rem!important}footer a,footer [data-component-part=\"footer-link\"],footer .footer-link,#your-privacy-choices-button{overflow-wrap:normal!important;word-wrap:normal!important;word-break:keep-all!important;hyphens:none!important;font-size:0.75rem!important;white-space:normal!important;max-width:100%!important;line-height:1.4!important;min-width:0!important}#footer a,#your-privacy-choices-button{color:#6B6580!important}html.dark #footer a,html.dark #your-privacy-choices-button{color:#8A849C!important}#footer a:hover,#your-privacy-choices-button:hover{color:#4E4763!important}html.dark #footer a:hover,html.dark #your-privacy-choices-button:hover{color:#A7A3B5!important}#your-privacy-choices-button{position:relative;align-self:start}footer .md\\:items-center>div:has(>#your-privacy-choices-button){align-self:flex-start!important}#your-privacy-choices-button::after{content:url(\"https://6778953.fs1.hubspotusercontent-na1.net/hubfs/6778953/legal/opt-out-30x14.svg\");right:-34px;position:absolute}#footer>div{gap:12px;padding-bottom:20px}#footer a[href*=\"mintlify\"],#footer a[href*=\"mintlify\"] span,#footer a[href*=\"mintlify\"] svg{color:#6B6580!important;fill:currentColor!important}html.dark #footer a[href*=\"mintlify\"],html.dark #footer a[href*=\"mintlify\"] span,html.dark #footer a[href*=\"mintlify\"] svg{color:#8A849C!important}#footer a[href*=\"mintlify\"]:hover,#footer a[href*=\"mintlify\"]:hover span,#footer a[href*=\"mintlify\"]:hover svg{color:#4E4763!important}html.dark #footer a[href*=\"mintlify\"]:hover,html.dark #footer a[href*=\"mintlify\"]:hover span,html.dark #footer a[href*=\"mintlify\"]:hover svg{color:#A7A3B5!important}#footer .gap-4.min-w-\\[140px\\].max-w-\\[492px\\].flex-wrap.hidden.md\\:flex:has([data-powered-by-relocated]){flex:0 0 auto!important;width:auto!important;max-width:200px!important}#footer [data-powered-by-relocated]{flex:0 0 100%!important;display:flex!important;justify-content:flex-end!important;margin-top:0.25rem!important}#footer [data-powered-by-relocated] a[href*=\"mintlify\"]{font-size:0.75rem!important}#footer [data-powered-by-relocated] a[href*=\"mintlify\"] svg{height:0.75rem!important;width:auto!important}#footer [data-powered-by-relocated]>*:not(:has(a[href*=\"mintlify\"])){display:none!important}@media (max-width: 767px){#footer .gap-4.min-w-\\[140px\\].max-w-\\[492px\\].flex-wrap.hidden.md\\:flex{display:flex!important;justify-content:flex-end!important}#footer .gap-4.min-w-\\[140px\\].max-w-\\[492px\\].flex-wrap.hidden.md\\:flex>a{display:none!important}}#footer svg[style*=\"mask-image\"]{background-color:#6B6580!important}html.dark #footer svg[style*=\"mask-image\"]{background-color:#8A849C!important}#footer a:hover svg[style*=\"mask-image\"]{background-color:#4E4763!important}html.dark #footer a:hover svg[style*=\"mask-image\"]{background-color:#A7A3B5!important}"}],"page":{"pagePath":"api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote","slug":"/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote","pageMetadata":{"openapi":"openapi/managed-payments.yaml post /v1/payouts/quotes","title":"Create a payout quote","description":"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote\nthat must be referenced in `POST /v1/payouts` via `quoteId`. Quotes expire at `expiresAt`.\n\nSpecify either `from.amount` (exact-in: debit a fixed USDC amount) or `to.amount`\n(exact-out: deliver a fixed fiat amount). Exactly one must be set.\n\nWhen `to.rail` is omitted, one quote per available live rail is returned. When `to.rail`\nis specified, only that rail is quoted.\n","href":"/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote\\nthat must be referenced in \", _jsx(_components.code, {\n children: \"POST /v1/payouts\"\n }), \" via \", _jsx(_components.code, {\n children: \"quoteId\"\n }), \". Quotes expire at \", _jsx(_components.code, {\n children: \"expiresAt\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Specify either \", _jsx(_components.code, {\n children: \"from.amount\"\n }), \" (exact-in: debit a fixed USDC amount) or \", _jsx(_components.code, {\n children: \"to.amount\"\n }), \"\\n(exact-out: deliver a fixed fiat amount). Exactly one must be set.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"When \", _jsx(_components.code, {\n children: \"to.rail\"\n }), \" is omitted, one quote per available live rail is returned. When \", _jsx(_components.code, {\n children: \"to.rail\"\n }), \"\\nis specified, only that rail is quoted.\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"openapi/managed-payments.yaml post /v1/payouts/quotes","title":"Create a payout quote","description":"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote\nthat must be referenced in `POST /v1/payouts` via `quoteId`. Quotes expire at `expiresAt`.\n\nSpecify either `from.amount` (exact-in: debit a fixed USDC amount) or `to.amount`\n(exact-out: deliver a fixed fiat amount). Exactly one must be set.\n\nWhen `to.rail` is omitted, one quote per available live rail is returned. When `to.rail`\nis specified, only that rail is quoted.\n","href":"/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/circle-167b8d39/d67aae5e94f8afee/content/gtm.js","/_mintlify/custom/circle-167b8d39/df50992471c6ad37/content/footer-powered-by.js","/_mintlify/custom/circle-167b8d39/749fc460434d1999/circle-fees.js"],"openApiReferenceData":{"operation":{"security":["dbe88f8b-b917-4946-bacb-bcde6b100844"],"summary":"Create a payout quote","description":"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote\nthat must be referenced in `POST /v1/payouts` via `quoteId`. Quotes expire at `expiresAt`.\n\nSpecify either `from.amount` (exact-in: debit a fixed USDC amount) or `to.amount`\n(exact-out: deliver a fixed fiat amount). Exactly one must be set.\n\nWhen `to.rail` is omitted, one quote per available live rail is returned. When `to.rail`\nis specified, only that rail is quoted.\n","operationId":"createPayoutQuote","tags":["Managed Payments Fiat Payouts"],"requestBody":"df5ad04f-3b51-49ed-b1fc-1c6c142d15cb","responses":{"200":"1758673e-527f-453d-bf38-dedd0040a087","400":"90fe2b71-302c-4593-8bc7-359ec50e9edd","401":"ca3f997c-ea07-4911-b74c-416447c0e94e"},"method":"post","type":"path","servers":["b6c955c1-404b-4bc7-957b-9491566c5d61","e22b8e22-0ab1-4051-a872-ffa1093dd77d"],"path":"/v1/payouts/quotes","baseUrlOptions":["https://api-sandbox.circle.com","https://api.circle.com"],"title":"Create a payout quote","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["useCase","from","to"],"properties":{"useCase":{"type":"string","enum":["B2B","B2C","C2B","C2C"],"description":"Use case that describes the originator and recipient relationship.\n- `B2B` — business originator, business recipient.\n- `B2C` — business originator, individual recipient.\n- `C2B` — individual originator, business recipient.\n- `C2C` — individual originator, individual recipient.\n","isRequired":true,"uniqueKey":"useCase","typeLabel":"enum\u003cstring>"},"from":{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","enum":["USDC"],"description":"Source cryptocurrency. Only `USDC` is currently supported.","example":"USDC","isRequired":true,"uniqueKey":"from.currency","typeLabel":"enum\u003cstring>"},"walletId":{"type":"string","description":"Circle wallet to debit. Omit to use the entity's master wallet;\nthe response echoes the actual wallet selected.\n","example":"1000000001","uniqueKey":"from.walletId","typeLabel":"string"},"amount":{"type":"string","description":"Exact-in: debit this amount from the source wallet.\nMutually exclusive with `to.amount`.\n","example":"95.50","uniqueKey":"from.amount","typeLabel":"string"}},"isRequired":true,"uniqueKey":"from","typeLabel":"object"},"to":{"type":"object","required":["currency","country"],"properties":{"currency":{"type":"string","description":"Destination fiat currency code.","example":"MXN","isRequired":true,"uniqueKey":"to.currency","typeLabel":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 destination country code.","example":"MX","isRequired":true,"uniqueKey":"to.country","typeLabel":"string"},"rail":{"type":"string","description":"Payment rail. When omitted, all available rails for the corridor are quoted.\n","example":"SPEI","uniqueKey":"to.rail","typeLabel":"string"},"amount":{"type":"string","description":"Exact-out: deliver this amount to the beneficiary.\nMutually exclusive with `from.amount`.\n","example":"1800.00","uniqueKey":"to.amount","typeLabel":"string"}},"isRequired":true,"uniqueKey":"to","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Exact-out B2C MXN SPEI":{"title":"Exact-out B2C MXN SPEI","value":{"useCase":"B2C","from":{"walletId":"1000000001","currency":"USDC"},"to":{"currency":"MXN","amount":"1800.00","country":"MX","rail":"SPEI"}}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"1758673e-527f-453d-bf38-dedd0040a087":{"description":"Quote(s) locked. Returns an array — one element per rail when `to.rail` is omitted,\none element when `to.rail` is specified.\n","headers":{"X-Request-Id":{"description":"Universally unique identifier (UUID v4) for the request. Helpful for identifying a request when communicating with Circle support.","schema":{"type":"string","format":"uuid","example":"2adba88e-9d63-44bc-b975-9b6ae3440dde"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","required":["id","type","useCase","pair","from","to","rate","fees","expiresAt"],"properties":{"id":{"type":"string","format":"uuid","description":"Quote identifier. Pass as `quoteId` in `POST /v1/payouts`.","example":"66666666-7777-8888-9999-000000000000","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"type":{"type":"string","enum":["tradable","reference"],"description":"Quote type. `tradable` is a binding, executable quote; `reference` is indicative only and cannot be used to create a payout.","isRequired":true,"uniqueKey":"data.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"useCase":{"type":"string","description":"Echoed from request.","isRequired":true,"uniqueKey":"data.items.[INDEX].useCase","typeLabel":"string"},"pair":{"type":"string","description":"Currency pair (e.g. `USDC_MXN`).","example":"USDC_MXN","isRequired":true,"uniqueKey":"data.items.[INDEX].pair","typeLabel":"string"},"from":{"type":"object","properties":{"walletId":{"type":"string","description":"Actual wallet selected (echoed or defaulted).","uniqueKey":"data.items.[INDEX].from.walletId","typeLabel":"string"},"currency":{"type":"string","uniqueKey":"data.items.[INDEX].from.currency","typeLabel":"string"},"amount":{"type":"string","description":"Computed source amount.","uniqueKey":"data.items.[INDEX].from.amount","typeLabel":"string"},"chain":{"type":"string","description":"Funding chain selected by the system.","uniqueKey":"data.items.[INDEX].from.chain","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].from","typeLabel":"object"},"to":{"type":"object","properties":{"currency":{"type":"string","uniqueKey":"data.items.[INDEX].to.currency","typeLabel":"string"},"amount":{"type":"string","description":"Computed destination amount.","uniqueKey":"data.items.[INDEX].to.amount","typeLabel":"string"},"country":{"type":"string","uniqueKey":"data.items.[INDEX].to.country","typeLabel":"string"},"rail":{"type":"string","uniqueKey":"data.items.[INDEX].to.rail","typeLabel":"string"}},"isRequired":true,"uniqueKey":"data.items.[INDEX].to","typeLabel":"object"},"rate":{"type":"string","description":"Locked FX rate (source currency per destination currency unit).","example":"18.848","isRequired":true,"uniqueKey":"data.items.[INDEX].rate","typeLabel":"string"},"fees":{"type":"array","description":"Aggregated fees deducted from the source amount.","items":{"type":"object","properties":{"type":{"type":"string","enum":["FIAT_PAYOUT_FEE"],"uniqueKey":"data.items.[INDEX].fees.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"amount":{"type":"string","uniqueKey":"data.items.[INDEX].fees.items.[INDEX].amount","typeLabel":"string"},"currency":{"type":"string","uniqueKey":"data.items.[INDEX].fees.items.[INDEX].currency","typeLabel":"string"}},"uniqueKey":"data.items.[INDEX].fees.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"data.items.[INDEX].fees","typeLabel":"object[]"},"expiresAt":{"type":"string","format":"date-time","description":"ISO 8601 timestamp when this quote expires.","isRequired":true,"uniqueKey":"data.items.[INDEX].expiresAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Quote response":{"title":"Quote response","value":{"data":[{"id":"66666666-7777-8888-9999-000000000000","type":"tradable","useCase":"B2C","pair":"USDC_MXN","from":{"walletId":"1000000001","currency":"USDC","amount":"95.50","chain":"MATIC"},"to":{"currency":"MXN","amount":"1800.00","country":"MX","rail":"SPEI"},"rate":"18.848","fees":[{"type":"FIAT_PAYOUT_FEE","amount":"1.35","currency":"USDC"}],"expiresAt":"2026-08-12T00:15:00Z"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"90fe2b71-302c-4593-8bc7-359ec50e9edd":{"description":"Invalid request or corridor/rail not available.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"ca3f997c-ea07-4911-b74c-416447c0e94e":{"description":"Unauthorized.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"dbe88f8b-b917-4946-bacb-bcde6b100844":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"b6c955c1-404b-4bc7-957b-9491566c5d61":{"url":"https://api-sandbox.circle.com"},"e22b8e22-0ab1-4051-a872-ffa1093dd77d":{"url":"https://api.circle.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"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":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi/managed-payments.yaml"},"subdomain":"circle-167b8d39","siteName":"Circle Docs","title":"Create a payout quote - Circle Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T16:02:59.207Z","originalFileLocation":"api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote that must be referenced in POST /v1/payouts via quoteId. Quotes expire at expiresAt. Specify either from.amount (exact-in: debit a fixed USDC amount) or to.amount (exact-out: deliver a fixed fiat amount). Exactly one must be set. When to.rail is omitted, one quote per available live rail is returned. When to.rail is specified, only that rail is quoted.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Circle Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_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/circle-167b8d39/NmgH-UQQhRa2ts0q/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a payout quote - Circle Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote that must be referenced in POST /v1/payouts via quoteId. Quotes expire at expiresAt. Specify either from.amount (exact-in: debit a fixed USDC amount) or to.amount (exact-out: deliver a fixed fiat amount). Exactly one must be set. When to.rail is omitted, one quote per available live rail is returned. When to.rail is specified, only that rail is quoted.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Circle Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://circle-167b8d39.mintlify.site/_mintlify/api/og/v2?division=Payout+quotes\u0026amp;title=Create+a+payout+quote\u0026amp;description=Locks+an+FX+rate%2C+fees%2C+and+BFI+selection+for+a+fiat+payout.+Returns+a+binding+quote%0Athat+must+be+referenced+in+%60POST+%2Fv1%2Fpayouts%60+via+%60quoteId%60.+Quotes+expire+\u0026amp;theme=b86ce57c82f364033d1c00f9\u0026amp;signature=14855ba71b34ec3ae0535269056ae836f4a196434e85f44ab51d97e27f10f3ca\">\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 payout quote - Circle Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote that must be referenced in POST /v1/payouts via quoteId. Quotes expire at expiresAt. Specify either from.amount (exact-in: debit a fixed USDC amount) or to.amount (exact-out: deliver a fixed fiat amount). Exactly one must be set. When to.rail is omitted, one quote per available live rail is returned. When to.rail is specified, only that rail is quoted.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://circle-167b8d39.mintlify.site/_mintlify/api/og/v2?division=Payout+quotes\u0026amp;title=Create+a+payout+quote\u0026amp;description=Locks+an+FX+rate%2C+fees%2C+and+BFI+selection+for+a+fiat+payout.+Returns+a+binding+quote%0Athat+must+be+referenced+in+%60POST+%2Fv1%2Fpayouts%60+via+%60quoteId%60.+Quotes+expire+\u0026amp;theme=b86ce57c82f364033d1c00f9\u0026amp;signature=14855ba71b34ec3ae0535269056ae836f4a196434e85f44ab51d97e27f10f3ca\">\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/circle-167b8d39/NmgH-UQQhRa2ts0q/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Circle Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0073C3\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.circle.com/#organization\",\"name\":\"Circle Docs\",\"url\":\"https://developers.circle.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/circle-167b8d39/K2XWSLhaeRomzNa1/logo/light.svg?fit=max\u0026auto=format\u0026n=K2XWSLhaeRomzNa1\u0026q=85\u0026s=decfb42837e0eb7c32dd425866902e78\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.circle.com#website\",\"name\":\"Circle Docs\",\"url\":\"https://developers.circle.com\",\"publisher\":{\"@id\":\"https://developers.circle.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote#webpage\",\"url\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote\",\"name\":\"Create a payout quote\",\"description\":\"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote that must be referenced in POST /v1/payouts via quoteId. Quotes expire at expiresAt. Specify either from.amount (exact-in: debit a fixed USDC amount) or to.amount (exact-out: deliver a fixed fiat amount). Exactly one must be set. When to.rail is omitted, one quote per available live rail is returned. When to.rail is specified, only that rail is quoted.\",\"dateModified\":\"2026-11-10T16:02:59.207Z\",\"isPartOf\":{\"@id\":\"https://developers.circle.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Managed Payments\",\"item\":\"https://developers.circle.com/api-reference/cpn/managed-payments/accounts/list-accounts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Fiat payouts\",\"item\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/list-beneficiary-corridors\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a payout quote\",\"item\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote#apireference\",\"headline\":\"Create a payout quote\",\"name\":\"Create a payout quote\",\"description\":\"Locks an FX rate, fees, and BFI selection for a fiat payout. Returns a binding quote that must be referenced in POST /v1/payouts via quoteId. Quotes expire at expiresAt. Specify either from.amount (exact-in: debit a fixed USDC amount) or to.amount (exact-out: deliver a fixed fiat amount). Exactly one must be set. When to.rail is omitted, one quote per available live rail is returned. When to.rail is specified, only that rail is quoted.\",\"url\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote\",\"mainEntityOfPage\":{\"@id\":\"https://developers.circle.com/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote#webpage\"},\"dateModified\":\"2026-11-10T16:02:59.207Z\",\"publisher\":{\"@id\":\"https://developers.circle.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.circle.com#website\"}}]}\u003c/script>","siteName":"Circle Docs","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":""}]},{"tab":"Assets","pages":[{"title":"Assets","href":"/assets"}]},{"tab":"Build onchain","pages":[{"title":"Build onchain","href":"/build-onchain"}]},{"tab":"Crosschain transfers","pages":[{"title":"Crosschain transfers","href":"/crosschain-transfers"}]},{"tab":"Agent stack","pages":[{"title":"Agent stack","href":"/agent-stack"}]},{"tab":"Payments","pages":[{"title":"Payments","href":"/cpn"}]},{"tab":"Liquidity services","pages":[{"title":"Liquidity services","href":"/liquidity-services"}]},{"tab":"API reference","anchors":[{"anchor":"Home","icon":"home","pages":[{"title":"Home","href":"/api-reference"}]},{"anchor":"Wallets","icon":"wallet","pages":[{"title":"Wallets","href":"/api-reference/wallets"}]},{"anchor":"Contracts","icon":"file-contract","pages":[{"title":"Contracts","href":"/api-reference/contracts"}]},{"anchor":"CCTP","icon":"bridge","pages":[{"title":"CCTP","href":"/api-reference/cctp"}]},{"anchor":"Gateway","icon":"dungeon","pages":[{"title":"Gateway","href":"/api-reference/gateway"}]},{"anchor":"x402 facilitators","icon":"handshake","pages":[{"title":"x402 facilitators","href":"/api-reference/x402-facilitators"}]},{"anchor":"Digital Asset Accounts","icon":"money-bill-1-wave","pages":[{"title":"Digital Asset Accounts","href":"/api-reference/digital-asset-accounts"}]},{"anchor":"End User Onboarding","icon":"user-plus","pages":[{"title":"End User Onboarding","href":"/api-reference/end-user-onboarding"}]},{"anchor":"Mint and Custody","icon":"building-columns","pages":[{"title":"Mint and Custody","href":"/api-reference/circle-mint"}]},{"anchor":"Circle Payments Network","icon":"chart-network","pages":[{"title":"Circle Payments Network API","sidebarTitle":"Overview","href":"/api-reference/cpn"},{"title":"Postman collection","href":"/api-reference/cpn/postman"},{"title":"Error codes","sidebarTitle":"Error codes","href":"/api-reference/cpn/error-codes"},{"group":"API overview","pages":[{"group":"Health","pages":[{"openapi":"openapi/configurations.yaml get /ping","title":"Ping","href":"/api-reference/cpn/common/ping"}]},{"group":"Webhook Subscriptions","pages":[{"openapi":"openapi/configurations.yaml get /v2/cpn/notifications/subscriptions","title":"Get all webhook subscriptions","href":"/api-reference/cpn/common/get-subscriptions"},{"openapi":"openapi/configurations.yaml post /v2/cpn/notifications/subscriptions","title":"Create a webhook subscription","href":"/api-reference/cpn/common/create-subscription"},{"openapi":"openapi/configurations.yaml get /v2/cpn/notifications/subscriptions/{id}","title":"Get a notification subscription","href":"/api-reference/cpn/common/get-subscription"},{"openapi":"openapi/configurations.yaml patch /v2/cpn/notifications/subscriptions/{id}","title":"Update a notification subscription","href":"/api-reference/cpn/common/update-subscription"},{"openapi":"openapi/configurations.yaml delete /v2/cpn/notifications/subscriptions/{id}","title":"Delete a notification subscription","href":"/api-reference/cpn/common/delete-subscription"},{"openapi":"openapi/configurations.yaml get /v2/cpn/notifications/publicKey/{id}","title":"Get a notification signature public key","href":"/api-reference/cpn/common/get-notification-signature"}]}]},{"group":"Fiat payouts","pages":[{"group":"Configurations","pages":[{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/configurations/overview","title":"Get payment configurations","href":"/api-reference/cpn/cpn-platform/get-payment-configurations-overview"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/configurations/routes","title":"Get supported payment routes","href":"/api-reference/cpn/cpn-platform/list-routes"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/configurations/enabledRoutes","title":"Retrieve all ofi-enabled payment routes","href":"/api-reference/cpn/cpn-platform/list-ofi-enabled-routes"}]},{"group":"Quotes","pages":[{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/quotes","title":"Create a quote","href":"/api-reference/cpn/cpn-platform/create-quotes"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/quotes/{quoteId}","title":"Get details of a quote","href":"/api-reference/cpn/cpn-platform/get-quote"}]},{"group":"Payments","pages":[{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments","title":"List payments","href":"/api-reference/cpn/cpn-platform/list-payments"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments","title":"Create a payment","href":"/api-reference/cpn/cpn-platform/create-payment"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/requirements","title":"Get payment requirements for a quote","href":"/api-reference/cpn/cpn-platform/get-payment-requirements"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}","title":"Get a payment","href":"/api-reference/cpn/cpn-platform/get-payment"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}/refunds/{refundId}","title":"Get refund details","href":"/api-reference/cpn/cpn-platform/get-refund"}]},{"group":"Transactions","pages":[{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/transactions","title":"Create a transaction","href":"/api-reference/cpn/cpn-platform/create-transaction"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}/transactions/{transactionId}","title":"Get a transaction","href":"/api-reference/cpn/cpn-platform/get-transaction"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/transactions/{transactionId}/submit","title":"Submit a signed transaction for broadcast","href":"/api-reference/cpn/cpn-platform/submit-transaction"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/transactions/accelerate","title":"Accelerate a stuck transaction","href":"/api-reference/cpn/cpn-platform/accelerate-transaction"},{"openapi":"openapi/cpn-ofi.yaml post /v2/cpn/payments/{paymentId}/transactions","title":"Create a transaction (V2)","href":"/api-reference/cpn/cpn-platform/create-transaction-v2"},{"openapi":"openapi/cpn-ofi.yaml get /v2/cpn/payments/{paymentId}/transactions/{transactionId}","title":"Get a transaction by ID (V2)","href":"/api-reference/cpn/cpn-platform/get-transaction-v2"},{"openapi":"openapi/cpn-ofi.yaml post /v2/cpn/payments/{paymentId}/transactions/{transactionId}/submit","title":"Submit a signed transaction for broadcast (V2)","href":"/api-reference/cpn/cpn-platform/submit-transaction-v2"}]},{"group":"Requests for information","pages":[{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}/rfis/{rfiId}","title":"Get details for an RFI","href":"/api-reference/cpn/cpn-platform/get-rfi"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/rfis/{rfiId}/submit","title":"Submit RFI data","href":"/api-reference/cpn/cpn-platform/submit-rfi"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/rfis/{rfiId}/files","title":"Upload RFI file","href":"/api-reference/cpn/cpn-platform/upload-rfi-file"}]},{"group":"Support tickets","pages":[{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/supportTickets","title":"Create a support ticket","href":"/api-reference/cpn/cpn-platform/create-support-ticket"}]},{"group":"Webhooks","pages":[{"openapi":"openapi/cpn-ofi.yaml webhook paymentCryptoFundsPending","title":"Payment awaiting crypto funds","href":"/api-reference/cpn/cpn-platform/payment-crypto-funds-pending"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentFiatPaymentInitiated","title":"Payment fiat payment initiated","href":"/api-reference/cpn/cpn-platform/payment-fiat-payment-initiated"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentCompleted","title":"Payment completed","href":"/api-reference/cpn/cpn-platform/payment-completed"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentFailed","title":"Payment failed","href":"/api-reference/cpn/cpn-platform/payment-failed"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentDelayed","title":"Payment delayed","href":"/api-reference/cpn/cpn-platform/payment-delayed"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentInManualReview","title":"Payment in manual review","href":"/api-reference/cpn/cpn-platform/payment-in-manual-review"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiInformationRequired","title":"RFI information required","href":"/api-reference/cpn/cpn-platform/rfi-information-required"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiInReview","title":"RFI in review","href":"/api-reference/cpn/cpn-platform/rfi-in-review"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiApproved","title":"RFI approved","href":"/api-reference/cpn/cpn-platform/rfi-approved"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiRejected","title":"RFI rejected","href":"/api-reference/cpn/cpn-platform/rfi-rejected"},{"openapi":"openapi/cpn-ofi.yaml webhook transactionBroadcasted","title":"Transaction broadcasted","href":"/api-reference/cpn/cpn-platform/transaction-broadcasted"},{"openapi":"openapi/cpn-ofi.yaml webhook transactionCompleted","title":"Transaction completed","href":"/api-reference/cpn/cpn-platform/transaction-completed"},{"openapi":"openapi/cpn-ofi.yaml webhook transactionFailed","title":"Transaction failed","href":"/api-reference/cpn/cpn-platform/transaction-failed"},{"openapi":"openapi/cpn-ofi.yaml webhook refundCreated","title":"Refund created","href":"/api-reference/cpn/cpn-platform/refund-created"},{"openapi":"openapi/cpn-ofi.yaml webhook refundFailed","title":"Refund failed","href":"/api-reference/cpn/cpn-platform/refund-failed"},{"openapi":"openapi/cpn-ofi.yaml webhook refundCompleted","title":"Refund completed","href":"/api-reference/cpn/cpn-platform/refund-completed"}]}]},{"group":"Managed Payments","pages":[{"group":"Accounts","pages":[{"openapi":"openapi/accounts.yaml get /v1/accounts","title":"List all accounts","href":"/api-reference/cpn/managed-payments/accounts/list-accounts"},{"openapi":"openapi/accounts.yaml post /v1/accounts","title":"Create an account","href":"/api-reference/cpn/managed-payments/accounts/create-account"},{"openapi":"openapi/accounts.yaml get /v1/accounts/{accountId}","title":"Get an account","href":"/api-reference/cpn/managed-payments/accounts/get-account"},{"openapi":"openapi/accounts.yaml post /v1/accounts/{accountId}/archive","title":"Archive an account","href":"/api-reference/cpn/managed-payments/accounts/archive-account"}]},{"group":"Wires","pages":[{"openapi":"openapi/accounts.yaml get /v1/banks/wires","title":"List all wire bank accounts","href":"/api-reference/cpn/managed-payments/wires/list-account-wire-accounts"},{"openapi":"openapi/accounts.yaml post /v1/banks/wires","title":"Create a wire bank account","href":"/api-reference/cpn/managed-payments/wires/create-account-wire-account"},{"openapi":"openapi/accounts.yaml get /v1/banks/wires/{id}","title":"Get a wire bank account","href":"/api-reference/cpn/managed-payments/wires/get-account-wire-account"},{"openapi":"openapi/accounts.yaml get /v1/banks/wires/{id}/instructions","title":"Get wire instructions","href":"/api-reference/cpn/managed-payments/wires/get-account-wire-account-instructions"}]},{"group":"Deposits","pages":[{"openapi":"openapi/accounts.yaml get /v1/accounts/deposits","title":"List all account bank deposits","href":"/api-reference/cpn/managed-payments/deposits/list-account-deposits"},{"openapi":"openapi/accounts.yaml get /v1/accounts/deposits/{id}","title":"Get an account bank deposit","href":"/api-reference/cpn/managed-payments/deposits/get-account-deposit"}]},{"group":"Withdrawals","pages":[{"openapi":"openapi/accounts.yaml post /v1/accounts/withdrawals","title":"Create an account bank withdrawal","href":"/api-reference/cpn/managed-payments/withdrawals/create-account-withdrawal"},{"openapi":"openapi/accounts.yaml get /v1/accounts/withdrawals","title":"List all account bank withdrawals","href":"/api-reference/cpn/managed-payments/withdrawals/list-account-withdrawals"},{"openapi":"openapi/accounts.yaml get /v1/accounts/withdrawals/{id}","title":"Get an account bank withdrawal","href":"/api-reference/cpn/managed-payments/withdrawals/get-account-withdrawal"}]},{"group":"Internal transfers","pages":[{"openapi":"openapi/managed-payments.yaml post /v1/accounts/transfers","title":"Create an account transfer","href":"/api-reference/cpn/managed-payments/transfers/create-account-transfer"},{"openapi":"openapi/managed-payments.yaml get /v1/accounts/transfers","title":"List all account transfers","href":"/api-reference/cpn/managed-payments/transfers/list-account-transfers"},{"openapi":"openapi/managed-payments.yaml get /v1/accounts/transfers/{id}","title":"Get an account transfer","href":"/api-reference/cpn/managed-payments/transfers/get-account-transfer"}]},{"group":"Credit","pages":[{"openapi":"openapi/managed-payments.yaml post /v1/managedPayments/credit/lines/{lineId}/transfers","title":"Borrow against line of credit","href":"/api-reference/cpn/managed-payments/credit/create-managed-payments-credit-transfer"},{"openapi":"openapi/managed-payments.yaml get /v1/managedPayments/credit/lines","title":"Get credit line details","href":"/api-reference/cpn/managed-payments/credit/get-managed-payments-credit-line"},{"openapi":"openapi/managed-payments.yaml get /v1/managedPayments/credit/lines/{lineId}/transfers/{transferId}","title":"Get a credit transfer","href":"/api-reference/cpn/managed-payments/credit/get-managed-payments-credit-transfer"},{"openapi":"openapi/managed-payments.yaml get /v1/managedPayments/credit/lines/{lineId}/transfers","title":"List credit transfers","href":"/api-reference/cpn/managed-payments/credit/list-managed-payments-credit-transfers"},{"openapi":"openapi/managed-payments.yaml get /v1/managedPayments/credit/lines/{lineId}/wireInstructions","title":"Get repayment wire instructions","href":"/api-reference/cpn/managed-payments/credit/get-managed-payments-credit-wire-instructions"}]},{"group":"Stablecoin payins","pages":[{"group":"Payment intents","pages":[{"openapi":"openapi/payments.yaml get /v1/paymentIntents","title":"List all payment intents","href":"/api-reference/cpn/managed-payments/payment-intents/list-payment-intents"},{"openapi":"openapi/payments.yaml post /v1/paymentIntents","title":"Create a payment intent","href":"/api-reference/cpn/managed-payments/payment-intents/create-payment-intent"},{"openapi":"openapi/payments.yaml get /v1/paymentIntents/{id}","title":"Get a payment intent","href":"/api-reference/cpn/managed-payments/payment-intents/get-payment-intent"},{"openapi":"openapi/payments.yaml post /v1/paymentIntents/{id}/expire","title":"Expire a payment intent","href":"/api-reference/cpn/managed-payments/payment-intents/expire-payment-intent"},{"openapi":"openapi/payments.yaml post /v1/paymentIntents/{id}/refund","title":"Refund a payment intent","href":"/api-reference/cpn/managed-payments/payment-intents/refund-payment-intent"}]},{"group":"Payments","pages":[{"openapi":"openapi/payments.yaml get /v1/payments","title":"List all payments","href":"/api-reference/cpn/managed-payments/payments/list-payments"},{"openapi":"openapi/payments.yaml get /v1/payments/{id}","title":"Get a payment","href":"/api-reference/cpn/managed-payments/payments/get-payment"}]},{"group":"Refund addresses","pages":[{"openapi":"openapi/payments.yaml post /v1/payments/refundAddresses","title":"Create a crypto payment refund address","href":"/api-reference/cpn/managed-payments/refund-addresses/create-payment-refund-address"}]}]},{"group":"Stablecoin payouts","pages":[{"group":"Address book","pages":[{"openapi":"openapi/payouts.yaml get /v1/addressBook/recipients","title":"List all recipients","href":"/api-reference/cpn/managed-payments/address-book/list-address-book-recipients"},{"openapi":"openapi/payouts.yaml post /v1/addressBook/recipients","title":"Create a recipient","href":"/api-reference/cpn/managed-payments/address-book/create-address-book-recipient"},{"openapi":"openapi/payouts.yaml get /v1/addressBook/recipients/{id}","title":"Get a recipient","href":"/api-reference/cpn/managed-payments/address-book/get-address-book-recipient"},{"openapi":"openapi/payouts.yaml patch /v1/addressBook/recipients/{id}","title":"Modify a recipient","href":"/api-reference/cpn/managed-payments/address-book/modify-address-book-recipient"},{"openapi":"openapi/payouts.yaml delete /v1/addressBook/recipients/{id}","title":"Delete a recipient","href":"/api-reference/cpn/managed-payments/address-book/delete-address-book-recipient"}]},{"group":"Payouts","pages":[{"openapi":"openapi/payouts.yaml get /v1/payouts","title":"List all payouts","href":"/api-reference/cpn/managed-payments/payouts/list-payouts"},{"openapi":"openapi/payouts.yaml post /v1/payouts","title":"Create a payout","href":"/api-reference/cpn/managed-payments/payouts/create-payout"},{"openapi":"openapi/payouts.yaml get /v1/payouts/{id}","title":"Get a payout","href":"/api-reference/cpn/managed-payments/payouts/get-payout"}]}]},{"group":"Fiat payouts","pages":[{"group":"Beneficiaries","pages":[{"openapi":"openapi/managed-payments.yaml get /v1/beneficiaries/corridors","title":"List supported beneficiary corridors","href":"/api-reference/cpn/managed-payments/fiat-payouts/list-beneficiary-corridors"},{"openapi":"openapi/managed-payments.yaml get /v1/beneficiaries/requirements","title":"Get beneficiary field requirements","href":"/api-reference/cpn/managed-payments/fiat-payouts/get-beneficiary-requirements"},{"openapi":"openapi/managed-payments.yaml get /v1/beneficiaries","title":"List beneficiaries","href":"/api-reference/cpn/managed-payments/fiat-payouts/list-beneficiaries"},{"openapi":"openapi/managed-payments.yaml post /v1/beneficiaries","title":"Create a beneficiary","href":"/api-reference/cpn/managed-payments/fiat-payouts/create-beneficiary"},{"openapi":"openapi/managed-payments.yaml get /v1/beneficiaries/{id}","title":"Get a beneficiary","href":"/api-reference/cpn/managed-payments/fiat-payouts/get-beneficiary"},{"openapi":"openapi/managed-payments.yaml delete /v1/beneficiaries/{id}","title":"Delete a beneficiary","description":"Soft-deletes a beneficiary: crypto-shreds the stored PII and marks the record `DELETED`.\nIdempotent — deleting an already-deleted record returns `204` with no error.\n\nA deleted beneficiary cannot be used in future payouts. To correct a registration error,\ndelete the beneficiary and register a new one.\n","href":"/api-reference/cpn/managed-payments/fiat-payouts/delete-beneficiary"}]},{"group":"Payout quotes","pages":[{"openapi":"openapi/managed-payments.yaml post /v1/payouts/quotes","title":"Create a payout quote","href":"/api-reference/cpn/managed-payments/fiat-payouts/create-payout-quote"}]}]},{"group":"Reporting","pages":[{"openapi":"openapi/account.yaml get /v1/reports","title":"List reports","description":"Returns a paginated list of the account's previously generated reports for a given report type and date range, each with a pre-signed `downloadUrl`.\nListable report types: `managed_payout_transactions`, `managed_payment_wallet_balances`, `managed_payin_transactions`, `camt_managed`, `camt053`, `camt052`, and `daily_statement_csv`.\nNote: `camt052` reports are generated on demand, so a `camt052` request returns only the dates previously requested with `POST /v1/reports`. A date that was never requested is absent from the list.\nNote: the `id` of each listed report is a storage object key, not the deterministic report UUID. It cannot be passed to `GET /v1/reports/{id}` or `GET /v1/reports/{id}/content`; download a listed report using its `downloadUrl`.\n","href":"/api-reference/circle-mint/account/list-reports"},{"openapi":"openapi/account.yaml post /v1/reports","title":"Request a report","href":"/api-reference/circle-mint/account/request-report"},{"openapi":"openapi/account.yaml get /v1/reports/{id}","title":"Get report by ID","href":"/api-reference/circle-mint/account/get-report-by-id"},{"openapi":"openapi/account.yaml get /v1/reports/{id}/content","title":"Download report content","href":"/api-reference/circle-mint/account/get-report-content"}]},{"group":"Webhooks","pages":[{"openapi":"openapi/managed-payments-webhooks.yaml webhook custodyTransfer","title":"Transfer state change","href":"/api-reference/cpn/managed-payments/webhooks/custody-transfer"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintPaymentIntents","title":"Payment intent state change","href":"/api-reference/cpn/managed-payments/webhooks/mint-payment-intents"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintPayments","title":"Payment state change","href":"/api-reference/cpn/managed-payments/webhooks/mint-payments"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintDeposits","title":"Deposit state change","href":"/api-reference/cpn/managed-payments/webhooks/mint-deposits"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintPayout","title":"Payout state change","href":"/api-reference/cpn/managed-payments/webhooks/mint-payout"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook payoutsBeneficiaryUpdated","title":"Fiat payout beneficiary status change","href":"/api-reference/cpn/managed-payments/webhooks/payouts-beneficiary-updated"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintWire","title":"Wire state change","href":"/api-reference/cpn/managed-payments/webhooks/mint-wire"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintAddressBookRecipients","title":"Recipient address state change","href":"/api-reference/cpn/managed-payments/webhooks/mint-address-book-recipients"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintAccounts","title":"Subaccount status change","href":"/api-reference/cpn/managed-payments/webhooks/mint-accounts"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook mintExternalEntities","title":"External entity compliance decision","href":"/api-reference/cpn/managed-payments/webhooks/mint-external-entities"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook onboardingApplicationApproved","title":"Application approved","href":"/api-reference/cpn/managed-payments/webhooks/onboarding-application-approved"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook onboardingApplicationDenied","title":"Application denied","href":"/api-reference/cpn/managed-payments/webhooks/onboarding-application-denied"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook onboardingApplicationCancelled","title":"Application cancelled","href":"/api-reference/cpn/managed-payments/webhooks/onboarding-application-cancelled"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook onboardingApplicationRfiRequested","title":"Information requested","href":"/api-reference/cpn/managed-payments/webhooks/onboarding-application-rfi-requested"},{"openapi":"openapi/managed-payments-webhooks.yaml webhook onboardingPeriodicReviewRequested","title":"Periodic review requested","href":"/api-reference/cpn/managed-payments/webhooks/onboarding-periodic-review-requested"}]}]},{"group":"Stablecoin payments","pages":[{"group":"Stablecoin payins","pages":[{"group":"Payments","pages":[{"openapi":"openapi/payments.yaml get /v1/payments","title":"List all payments","href":"/api-reference/circle-mint/payments/list-payments"},{"openapi":"openapi/payments.yaml get /v1/payments/{id}","title":"Get a payment","href":"/api-reference/circle-mint/payments/get-payment"}]},{"group":"Payment intents","pages":[{"openapi":"openapi/payments.yaml get /v1/paymentIntents","title":"List all payment intents","href":"/api-reference/circle-mint/payments/list-payment-intents"},{"openapi":"openapi/payments.yaml post /v1/paymentIntents","title":"Create a payment intent","href":"/api-reference/circle-mint/payments/create-payment-intent"},{"openapi":"openapi/payments.yaml get /v1/paymentIntents/{id}","title":"Get a payment intent","href":"/api-reference/circle-mint/payments/get-payment-intent"},{"openapi":"openapi/payments.yaml post /v1/paymentIntents/{id}/expire","title":"Expire a payment intent","href":"/api-reference/circle-mint/payments/expire-payment-intent"},{"openapi":"openapi/payments.yaml post /v1/paymentIntents/{id}/refund","title":"Refund a payment intent","href":"/api-reference/circle-mint/payments/refund-payment-intent"}]},{"group":"Crypto Payment Refund Addresses","pages":[{"openapi":"openapi/payments.yaml post /v1/payments/refundAddresses","title":"Create a crypto payment refund address","href":"/api-reference/circle-mint/payments/create-payment-refund-address"}]}]},{"group":"Stablecoin payouts","pages":[{"group":"Payouts","pages":[{"openapi":"openapi/payouts.yaml get /v1/payouts","title":"List all payouts","href":"/api-reference/circle-mint/payouts/list-payouts"},{"openapi":"openapi/payouts.yaml post /v1/payouts","title":"Create a payout","href":"/api-reference/circle-mint/payouts/create-payout"},{"openapi":"openapi/payouts.yaml get /v1/payouts/{id}","title":"Get a payout","href":"/api-reference/circle-mint/payouts/get-payout"}]},{"group":"Address book","pages":[{"openapi":"openapi/payouts.yaml get /v1/addressBook/recipients","title":"List all recipients","href":"/api-reference/circle-mint/payouts/list-address-book-recipients"},{"openapi":"openapi/payouts.yaml post /v1/addressBook/recipients","title":"Create a recipient","href":"/api-reference/circle-mint/payouts/create-address-book-recipient"},{"openapi":"openapi/payouts.yaml get /v1/addressBook/recipients/{id}","title":"Get a recipient","href":"/api-reference/circle-mint/payouts/get-address-book-recipient"},{"openapi":"openapi/payouts.yaml patch /v1/addressBook/recipients/{id}","title":"Modify a recipient","href":"/api-reference/circle-mint/payouts/modify-address-book-recipient"},{"openapi":"openapi/payouts.yaml delete /v1/addressBook/recipients/{id}","title":"Delete a recipient","href":"/api-reference/circle-mint/payouts/delete-address-book-recipient"},{"openapi":"openapi/payouts.yaml get /v1/addressBook/vasps","title":"List VASPs","href":"/api-reference/circle-mint/payouts/list-address-book-vasps"}]}]}]},{"group":"Circle Payments Network","pages":[{"group":"Configurations","pages":[{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/configurations/overview","title":"Get payment configurations","href":"/api-reference/cpn/cpn-platform/get-payment-configurations-overview"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/configurations/routes","title":"Get supported payment routes","href":"/api-reference/cpn/cpn-platform/list-routes"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/configurations/enabledRoutes","title":"Retrieve all ofi-enabled payment routes","href":"/api-reference/cpn/cpn-platform/list-ofi-enabled-routes"}]},{"group":"Quotes","pages":[{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/quotes","title":"Create a quote","href":"/api-reference/cpn/cpn-platform/create-quotes"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/quotes/{quoteId}","title":"Get details of a quote","href":"/api-reference/cpn/cpn-platform/get-quote"}]},{"group":"Payments","pages":[{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments","title":"List payments","href":"/api-reference/cpn/cpn-platform/list-payments"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments","title":"Create a payment","href":"/api-reference/cpn/cpn-platform/create-payment"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/requirements","title":"Get payment requirements for a quote","href":"/api-reference/cpn/cpn-platform/get-payment-requirements"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}","title":"Get a payment","href":"/api-reference/cpn/cpn-platform/get-payment"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}/refunds/{refundId}","title":"Get refund details","href":"/api-reference/cpn/cpn-platform/get-refund"}]},{"group":"Transactions","pages":[{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/transactions","title":"Create a transaction","href":"/api-reference/cpn/cpn-platform/create-transaction"},{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}/transactions/{transactionId}","title":"Get a transaction","href":"/api-reference/cpn/cpn-platform/get-transaction"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/transactions/{transactionId}/submit","title":"Submit a signed transaction for broadcast","href":"/api-reference/cpn/cpn-platform/submit-transaction"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/transactions/accelerate","title":"Accelerate a stuck transaction","href":"/api-reference/cpn/cpn-platform/accelerate-transaction"},{"openapi":"openapi/cpn-ofi.yaml post /v2/cpn/payments/{paymentId}/transactions","title":"Create a transaction (V2)","href":"/api-reference/cpn/cpn-platform/create-transaction-v2"},{"openapi":"openapi/cpn-ofi.yaml get /v2/cpn/payments/{paymentId}/transactions/{transactionId}","title":"Get a transaction by ID (V2)","href":"/api-reference/cpn/cpn-platform/get-transaction-v2"},{"openapi":"openapi/cpn-ofi.yaml post /v2/cpn/payments/{paymentId}/transactions/{transactionId}/submit","title":"Submit a signed transaction for broadcast (V2)","href":"/api-reference/cpn/cpn-platform/submit-transaction-v2"}]},{"group":"Requests for Information","pages":[{"openapi":"openapi/cpn-ofi.yaml get /v1/cpn/payments/{paymentId}/rfis/{rfiId}","title":"Get details for an RFI","href":"/api-reference/cpn/cpn-platform/get-rfi"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/rfis/{rfiId}/submit","title":"Submit RFI data","href":"/api-reference/cpn/cpn-platform/submit-rfi"},{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/payments/{paymentId}/rfis/{rfiId}/files","title":"Upload RFI file","href":"/api-reference/cpn/cpn-platform/upload-rfi-file"}]},{"group":"Support Tickets","pages":[{"openapi":"openapi/cpn-ofi.yaml post /v1/cpn/supportTickets","title":"Create a support ticket","href":"/api-reference/cpn/cpn-platform/create-support-ticket"}]},{"group":"Webhooks","pages":[{"openapi":"openapi/cpn-ofi.yaml webhook paymentCryptoFundsPending","title":"Payment awaiting crypto funds","href":"/api-reference/cpn/cpn-platform/payment-crypto-funds-pending"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentFiatPaymentInitiated","title":"Payment fiat payment initiated","href":"/api-reference/cpn/cpn-platform/payment-fiat-payment-initiated"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentCompleted","title":"Payment completed","href":"/api-reference/cpn/cpn-platform/payment-completed"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentFailed","title":"Payment failed","href":"/api-reference/cpn/cpn-platform/payment-failed"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentDelayed","title":"Payment delayed","href":"/api-reference/cpn/cpn-platform/payment-delayed"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentInManualReview","title":"Payment in manual review","href":"/api-reference/cpn/cpn-platform/payment-in-manual-review"},{"openapi":"openapi/cpn-ofi.yaml webhook paymentRfiEmailInitiated","title":"Payment RFI email initiated","href":"/api-reference/cpn/cpn-platform/payment-rfi-email-initiated"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiInformationRequired","title":"RFI information required","href":"/api-reference/cpn/cpn-platform/rfi-information-required"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiInReview","title":"RFI in review","href":"/api-reference/cpn/cpn-platform/rfi-in-review"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiApproved","title":"RFI approved","href":"/api-reference/cpn/cpn-platform/rfi-approved"},{"openapi":"openapi/cpn-ofi.yaml webhook rfiRejected","title":"RFI rejected","href":"/api-reference/cpn/cpn-platform/rfi-rejected"},{"openapi":"openapi/cpn-ofi.yaml webhook transactionBroadcasted","title":"Transaction broadcasted","href":"/api-reference/cpn/cpn-platform/transaction-broadcasted"},{"openapi":"openapi/cpn-ofi.yaml webhook transactionCompleted","title":"Transaction completed","href":"/api-reference/cpn/cpn-platform/transaction-completed"},{"openapi":"openapi/cpn-ofi.yaml webhook transactionFailed","title":"Transaction failed","href":"/api-reference/cpn/cpn-platform/transaction-failed"},{"openapi":"openapi/cpn-ofi.yaml webhook refundCreated","title":"Refund created","href":"/api-reference/cpn/cpn-platform/refund-created"},{"openapi":"openapi/cpn-ofi.yaml webhook refundFailed","title":"Refund failed","href":"/api-reference/cpn/cpn-platform/refund-failed"},{"openapi":"openapi/cpn-ofi.yaml webhook refundCompleted","title":"Refund completed","href":"/api-reference/cpn/cpn-platform/refund-completed"}]}]}]},{"anchor":"StableFX","icon":"swap","pages":[{"title":"StableFX","href":"/api-reference/stablefx"}]},{"anchor":"xReserve","icon":"vault","pages":[{"title":"xReserve","href":"/api-reference/xreserve"}]},{"anchor":"Match","pages":[{"title":"Match","href":"/api-reference/circle-match/all/get-account"}]}]},{"tab":"Developer tools","menu":[{"item":"Sample projects","pages":[{"title":"Sample projects","href":"/sample-projects"}]},{"item":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]},{"item":"Release notes","pages":[{"title":"Release notes","href":"/release-notes"}]}],"pages":[{"title":"Developer tools","href":"/sample-projects"}]}]},"basePath":"","title":"Create a payout quote - Circle Docs","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}