CoinVoyage API rate limits, 429 responses, and retry behavior
Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.
CoinVoyage applies rate limits to keep payment flows reliable during traffic spikes, retries, and abusive request patterns. Limits vary by endpoint and credential type.
429 responses
When a request exceeds a limit, CoinVoyage returns 429 Too Many Requests:
HTTP/1.1 429 Too Many RequestsRetry-After: <seconds>
{ "error": "Too Many Requests", "message": "Rate limit exceeded. Please try again later.", "code": 429}
If Retry-After is present, wait at least that many seconds before retrying.
Retry guidance
Respect Retry-After instead of retrying immediately.
Add jitter when multiple workers or browser tabs may retry the same operation.
Use bounded exponential backoff for network failures and 5xx responses.
Retry reads more freely than create or mutation requests.
Keep fulfillment and reconciliation idempotent by CoinVoyage order ID.
Use webhooks for payment state changes. Polling is useful for dashboard views and reconciliation jobs, but webhooks should be the primary completion signal.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CoinVoyage","description":"CoinVoyage enables seamless crypto payments into your app from any supported chain and coin.","colors":{"primary":"#d6296f","light":"#e688bd","dark":"#fc1777"},"logo":{"light":"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=2b6b11284d0d65d96596f7018cd0b7a5","dark":"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/logo.svg?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=85255bd9be1e06b981fc529f59ec164a"},"favicon":"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/favicon.ico?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=6f48ac74892e40e9ff118ec7b80a3520","api":{"playground":{"display":"interactive"}},"navbar":{"links":[{"icon":"twitter","href":"https://x.com/Coin_Voyage","label":"X"},{"href":"https://github.com/coin-voyage/","label":"Github"}],"primary":{"type":"github","href":"https://github.com/coin-voyage"}},"footer":{"socials":{"x":"https://x.com/Coin_Voyage"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"coinvoyage-3c99945b","hasAudioNarration":false,"actualSubdomain":"coinvoyage-3c99945b","customDomains":["docs.coinvoyage.io"],"gitSource":{"type":"github","owner":"coin-voyage","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"agentFeedback":true,"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af32744734ccd78509c2e8b","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API reference","count":50},{"language":"default","tag":"Documentation","count":45},{"language":"default","tag":"API integration","count":13},{"language":"default","tag":"ApiClient reference","count":10},{"language":"default","tag":"off-ramp","count":9},{"language":"default","tag":"Dashboard","count":7},{"language":"default","tag":"onramp","count":7},{"language":"default","tag":"orders","count":7},{"language":"default","tag":"invoices","count":6},{"language":"default","tag":"Core concepts","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"help@coinvoyage.io","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"resources/rate-limits","slug":"/resources/rate-limits","pageMetadata":{"title":"CoinVoyage API rate limits, 429 responses, and retry behavior","sidebarTitle":"Rate limits","description":"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.","layout":{"description":{"visible":false}},"href":"/resources/rate-limits"},"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: \"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.\"\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={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Tip}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`CoinVoyage applies rate limits to keep payment flows reliable during traffic spikes, retries, and abusive request patterns. Limits vary by endpoint and credential type.`}),`\n`,_jsx(Heading,{level:`2`,id:`429-responses`,children:`429 responses`}),`\n`,_jsxs(_components.p,{children:[`When a request exceeds a limit, CoinVoyage returns `,_jsx(_components.code,{children:`429 Too Many Requests`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`http`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`http`,children:_jsxs(_components.code,{language:`http`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`HTTP`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1.1`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 429`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Too Many Requests`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#569CD6`},children:`Retry-After`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \u003cseconds>`})]}),`\n`]})})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"error\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Too Many Requests\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Rate limit exceeded. Please try again later.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`429`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`If `,_jsx(_components.code,{children:`Retry-After`}),` is present, wait at least that many seconds before retrying.`]}),`\n`,_jsx(Heading,{level:`2`,id:`retry-guidance`,children:`Retry guidance`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Respect `,_jsx(_components.code,{children:`Retry-After`}),` instead of retrying immediately.`]}),`\n`,_jsx(_components.li,{children:`Add jitter when multiple workers or browser tabs may retry the same operation.`}),`\n`,_jsxs(_components.li,{children:[`Use bounded exponential backoff for network failures and `,_jsx(_components.code,{children:`5xx`}),` responses.`]}),`\n`,_jsx(_components.li,{children:`Retry reads more freely than create or mutation requests.`}),`\n`,_jsx(_components.li,{children:`Keep fulfillment and reconciliation idempotent by CoinVoyage order ID.`}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Use webhooks for payment state changes. Polling is useful for dashboard views and reconciliation jobs, but webhooks should be the primary completion signal.`})})]})}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":{"config":{},"pageMetadata":{"title":"CoinVoyage API rate limits, 429 responses, and retry behavior","sidebarTitle":"Rate limits","description":"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.","layout":{"description":{"visible":false}},"href":"/resources/rate-limits"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"429 responses","slug":"429-responses","depth":2,"children":[]},{"title":"Retry guidance","slug":"retry-guidance","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"coinvoyage-3c99945b","siteName":"CoinVoyage","title":"CoinVoyage API rate limits, 429 responses, and retry behavior - CoinVoyage","navMaps":{"firstHrefInVersion":{"v3":{"href":"/resources/rate-limits","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-06-26T08:27:59.947Z","originalFileLocation":"resources/rate-limits.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=\"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CoinVoyage\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"CoinVoyage API rate limits, 429 responses, and retry behavior - CoinVoyage\">\u003cmeta data-mint-head property=\"og:description\" content=\"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CoinVoyage\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.coinvoyage.io/resources/rate-limits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://coinvoyage-3c99945b.mintlify.site/_mintlify/api/og/v2?division=API+integration\u0026amp;title=CoinVoyage+API+rate+limits%2C+429+responses%2C+and+retry+behavior\u0026amp;description=Understand+CoinVoyage+API+rate+limits%2C+how+to+handle+429+Too+Many+Requests+responses%2C+and+recommended+retry+and+backoff+behavior+for+production+integrations.\u0026amp;theme=4cc65740291881c9362fb0cc\u0026amp;signature=4c15e7679727994861b18db7b0baad301e16cfa0ecaca2cce142f9365c3d47af\">\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=\"CoinVoyage API rate limits, 429 responses, and retry behavior - CoinVoyage\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://coinvoyage-3c99945b.mintlify.site/_mintlify/api/og/v2?division=API+integration\u0026amp;title=CoinVoyage+API+rate+limits%2C+429+responses%2C+and+retry+behavior\u0026amp;description=Understand+CoinVoyage+API+rate+limits%2C+how+to+handle+429+Too+Many+Requests+responses%2C+and+recommended+retry+and+backoff+behavior+for+production+integrations.\u0026amp;theme=4cc65740291881c9362fb0cc\u0026amp;signature=4c15e7679727994861b18db7b0baad301e16cfa0ecaca2cce142f9365c3d47af\">\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/coinvoyage-3c99945b/mD1PGld3WSyNJF_d/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CoinVoyage\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#d6296f\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.coinvoyage.io/resources/rate-limits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/resources/rate-limits.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.coinvoyage.io/#organization\",\"name\":\"CoinVoyage\",\"url\":\"https://docs.coinvoyage.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/coinvoyage-3c99945b/k1rKznLxzrSYSaFy/assets/logo-light.svg?fit=max\u0026auto=format\u0026n=k1rKznLxzrSYSaFy\u0026q=85\u0026s=2b6b11284d0d65d96596f7018cd0b7a5\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.coinvoyage.io#website\",\"name\":\"CoinVoyage\",\"url\":\"https://docs.coinvoyage.io\",\"publisher\":{\"@id\":\"https://docs.coinvoyage.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.coinvoyage.io/resources/rate-limits#webpage\",\"url\":\"https://docs.coinvoyage.io/resources/rate-limits\",\"name\":\"CoinVoyage API rate limits, 429 responses, and retry behavior\",\"description\":\"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.\",\"dateModified\":\"2026-06-26T08:27:59.947Z\",\"isPartOf\":{\"@id\":\"https://docs.coinvoyage.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.coinvoyage.io/resources/rate-limits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.coinvoyage.io/resources/rate-limits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API integration\",\"item\":\"https://docs.coinvoyage.io/api/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"CoinVoyage API rate limits, 429 responses, and retry behavior\",\"item\":\"https://docs.coinvoyage.io/resources/rate-limits\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.coinvoyage.io/resources/rate-limits#article\",\"headline\":\"CoinVoyage API rate limits, 429 responses, and retry behavior\",\"name\":\"CoinVoyage API rate limits, 429 responses, and retry behavior\",\"description\":\"Understand CoinVoyage API rate limits, how to handle 429 Too Many Requests responses, and recommended retry and backoff behavior for production integrations.\",\"url\":\"https://docs.coinvoyage.io/resources/rate-limits\",\"mainEntityOfPage\":{\"@id\":\"https://docs.coinvoyage.io/resources/rate-limits#webpage\"},\"dateModified\":\"2026-06-26T08:27:59.947Z\",\"publisher\":{\"@id\":\"https://docs.coinvoyage.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.coinvoyage.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CoinVoyage\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CoinVoyage\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/resources/rate-limits.md","siteName":"CoinVoyage","nav":{"global":null,"versions":[{"version":"v3","default":true,"tabs":[{"tab":"Documentation","groups":[{"group":"Get started","pages":[{"title":"CoinVoyage: non-custodial cross-chain crypto payments","sidebarTitle":"Introduction","href":"/introduction"},{"title":"CoinVoyage integration flows","sidebarTitle":"Choose an integration","href":"/flows/overview"},{"title":"Quickstart: install CoinVoyage and accept payments","sidebarTitle":"PayKit quickstart","href":"/quickstart"}]},{"group":"Core concepts","pages":[{"title":"How CoinVoyage routes and settles cross-chain payments","sidebarTitle":"How it works","href":"/concepts/how-it-works"},{"title":"Orders: DEPOSIT, SALE, REFUND modes and statuses","sidebarTitle":"Orders","href":"/concepts/pay-orders"},{"title":"Hosted payment links","href":"/guides/hosted-payment-links"},{"title":"Blockchain networks and chain IDs supported by CoinVoyage","sidebarTitle":"Supported networks","href":"/concepts/supported-networks"},{"title":"Fiat off-ramp regions, currencies, and payment rails","sidebarTitle":"Supported regions","href":"/concepts/supported-regions"}]},{"group":"PayKit","pages":[{"title":"CoinVoyage PayKit SDK — SALE and DEPOSIT payments","sidebarTitle":"PayKit overview","href":"/sdk/overview"},{"title":"WalletProvider — configure multi-chain wallet connectors","sidebarTitle":"WalletProvider","href":"/sdk/walletprovider"},{"title":"PayKitProvider — set up your global payment context","sidebarTitle":"PayKitProvider","href":"/sdk/paykitprovider"},{"title":"PayButton — ready-made crypto payment UI component","sidebarTitle":"PayButton","href":"/sdk/paybutton"},{"title":"useOrderStatusWS - order status WebSocket hook","sidebarTitle":"useOrderStatusWS","href":"/sdk/useorderstatusws"}]},{"group":"SwapKit","pages":[{"title":"CoinVoyage SwapKit — embeddable token swaps","sidebarTitle":"SwapKit","href":"/sdk/swapkit"}]},{"group":"Styling / Theme","pages":[{"title":"PayKit styling and theming","sidebarTitle":"PayKit","href":"/sdk/styling/paykit"},{"title":"SwapKit styling and theming","sidebarTitle":"SwapKit","href":"/sdk/styling/swapkit"}]},{"group":"Invoices","pages":[{"title":"CoinVoyage invoices","sidebarTitle":"Overview","href":"/invoices/overview"},{"title":"Invoices API","sidebarTitle":"REST API guide","href":"/invoices/api"}]},{"group":"API integration","pages":[{"title":"CoinVoyage API overview","sidebarTitle":"API overview","href":"/api/overview"},{"group":"ApiClient reference","root":{"title":"ApiClient - server-side CoinVoyage REST API client","sidebarTitle":"Overview","href":"/sdk/apiclient"},"expanded":false,"pages":[{"title":"ApiClient authentication and authorization signatures","sidebarTitle":"Authentication","href":"/sdk/apiclient/authentication"},{"title":"ApiClient order methods","sidebarTitle":"Orders","href":"/sdk/apiclient/orders"},{"title":"Swap API — quote and execute standalone swaps","sidebarTitle":"Swaps","href":"/sdk/apiclient/swaps"},{"title":"ApiClient wallet and currency search methods","sidebarTitle":"Wallet and search","href":"/sdk/apiclient/wallets-and-search"},{"title":"ApiClient on-ramp methods","sidebarTitle":"On-ramp","href":"/sdk/apiclient/on-ramp"},{"title":"ApiClient off-ramp methods","sidebarTitle":"Off-ramp","href":"/sdk/apiclient/off-ramp"},{"title":"ApiClient invoice methods","sidebarTitle":"Invoices","href":"/sdk/apiclient/invoices"},{"title":"ApiClient fee methods","sidebarTitle":"Fees","href":"/sdk/apiclient/fees"},{"title":"ApiClient webhooks and WebSocket subscriptions","sidebarTitle":"Webhooks and WebSockets","href":"/sdk/apiclient/webhooks-and-websockets"},{"title":"ApiClient core types","sidebarTitle":"Core types","description":"Reference the core CoinVoyage order, status, payment, and funding types returned by ApiClient.","href":"/sdk/apiclient/types"}]},{"title":"CoinVoyage API rate limits, 429 responses, and retry behavior","sidebarTitle":"Rate limits","href":"/resources/rate-limits"},{"title":"PayKit Headless (Preview) - x402 payments for agents and servers","sidebarTitle":"PayKit Headless (Preview)","description":"Use the Preview @coin-voyage/paykit-headless package to satisfy CoinVoyage x402 PAYMENT-REQUIRED challenges without browser wallet UI.","href":"/sdk/paykit-headless"}]},{"group":"Going live","pages":[{"title":"Set up webhooks for real-time payment notifications","sidebarTitle":"Set up webhooks","href":"/webhooks/overview"},{"title":"CoinVoyage webhook event types and payload reference","sidebarTitle":"Webhook events","href":"/webhooks/events"},{"title":"Production checklist","sidebarTitle":"Production checklist","href":"/guides/production-checklist"}]},{"group":"Dashboard","pages":[{"title":"CoinVoyage Dashboard: manage payments and settings","sidebarTitle":"Overview","href":"/dashboard/overview"},{"title":"Transactions: search, inspect, and refund payments","sidebarTitle":"Transactions","href":"/dashboard/transactions"},{"title":"Settlement currencies: choose your payout asset and chain","sidebarTitle":"Settlement","href":"/dashboard/settlement"},{"title":"Withdrawals: off-ramp crypto settlement balances to fiat","sidebarTitle":"Withdrawals","href":"/dashboard/withdrawals"},{"title":"Custom fees: charge an extra percentage on every payment","sidebarTitle":"Custom fees","href":"/dashboard/custom-fees"},{"title":"Invoices: send crypto payment requests to customers","sidebarTitle":"Invoices","href":"/dashboard/invoices"},{"title":"Manage API keys and webhooks in the Developers tab","sidebarTitle":"Developers","href":"/dashboard/developers"}]},{"group":"Resources","pages":[{"title":"CoinVoyage pricing: transaction fees and volume plans","sidebarTitle":"Pricing","href":"/resources/pricing"},{"title":"CoinVoyage SDK and API changelog — release notes","sidebarTitle":"Changelog","href":"/resources/changelog"},{"title":"CoinVoyage integration FAQ: auth, testing, and flows","sidebarTitle":"FAQs","href":"/resources/faqs"},{"title":"CoinVoyage support: contact, examples, and resources","sidebarTitle":"Support","href":"/resources/support"}]}]},{"tab":"API reference","icon":"square-terminal","pages":[{"title":"API reference","href":"/api-reference/api-keys/list-api-keys"}]}]}]},"basePath":"","title":"CoinVoyage API rate limits, 429 responses, and retry behavior - CoinVoyage","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}