{
"code": "INVALID_SOURCE_ASSET",
"message": "The source asset identifier is not a valid CAIP-19 asset.",
"request_id": "req_123456789",
"payment_id": "0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c",
"docs_url": "<string>",
"domain": "PAYMENT_GATEWAY",
"retry_classification": "RECONCILE_THEN_DECIDE",
"request_id_reusable": false
}
{
"code": "INVALID_SOURCE_ASSET",
"message": "The source asset identifier is not a valid CAIP-19 asset.",
"request_id": "req_123456789",
"payment_id": "0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c",
"docs_url": "<string>",
"domain": "PAYMENT_GATEWAY",
"retry_classification": "RECONCILE_THEN_DECIDE",
"request_id_reusable": false
}
{
"code": "INVALID_SOURCE_ASSET",
"message": "The source asset identifier is not a valid CAIP-19 asset.",
"request_id": "req_123456789",
"payment_id": "0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c",
"docs_url": "<string>",
"domain": "PAYMENT_GATEWAY",
"retry_classification": "RECONCILE_THEN_DECIDE",
"request_id_reusable": false
}
Payment Gateway
Get chain defaults
Fetch the Payment Gateway’s live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.
GET
/
v1
/
defaults
Get chain defaults
curl --request GET \
--url https://payment-gw.production-mainnet.atum.xyz/v1/defaults
{
"code": "INVALID_SOURCE_ASSET",
"message": "The source asset identifier is not a valid CAIP-19 asset.",
"request_id": "req_123456789",
"payment_id": "0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c",
"docs_url": "<string>",
"domain": "PAYMENT_GATEWAY",
"retry_classification": "RECONCILE_THEN_DECIDE",
"request_id_reusable": false
}
{
"code": "INVALID_SOURCE_ASSET",
"message": "The source asset identifier is not a valid CAIP-19 asset.",
"request_id": "req_123456789",
"payment_id": "0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c",
"docs_url": "<string>",
"domain": "PAYMENT_GATEWAY",
"retry_classification": "RECONCILE_THEN_DECIDE",
"request_id_reusable": false
}
{
"code": "INVALID_SOURCE_ASSET",
"message": "The source asset identifier is not a valid CAIP-19 asset.",
"request_id": "req_123456789",
"payment_id": "0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c",
"docs_url": "<string>",
"domain": "PAYMENT_GATEWAY",
"retry_classification": "RECONCILE_THEN_DECIDE",
"request_id_reusable": false
}
Fetch these addresses at startup rather than hardcoding them — they change when a chain’s contracts are redeployed. With no chain_id you get every chain the gateway serves, which also makes this the simplest check that the gateway is reachable. A chain that isn’t fully configured is left out of that listing, and an empty address is a chain you cannot pay on. See Contract addresses.
CAIP-2 chain identifier. Omit it, or send it empty, to receive every chain the gateway serves, keyed by chain id.
Response
Chain defaults. A single object when chain_id was supplied, otherwise an object keyed by CAIP-2 chain id.
Option 1
Option 2
Either one chain's defaults or every chain keyed by CAIP-2 chain id, depending on whether chain_id was supplied. A top-level chain_id identifies the first.
The contract that pays the receiver. Read this from the DESTINATION chain's defaults, not the source chain's. Empty when the chain is not fully configured.
The Permit2 this chain's escrow verifies against, sent only when it is not the canonical deployment. When absent, use the canonical Permit2 address for the chain. EVM and Tron only.
The depositRequestHash version to sign for a deposit from this chain: 1 is keccak256 of the request_id, 2 is the hash of the payment terms, computed over the request body exactly as it is then posted. Absent means 1. Kept for clients that predate deposit_request_hash_versions, which a client should read instead: a deposit signed with version 1 is still accepted unless that list omits 1. It stays 2 once version 1 is no longer accepted, so a client that reads only this member keeps signing version 2.
The depositRequestHash versions a deposit from this chain may be signed with, ascending: [1] before version 2, [1, 2] once the gateway publishes 2 in deposit_request_hash_version, and [2] once it no longer accepts version 1. A merchant lists exactly these in an x402 or MPP challenge. Absent means [1, 2] when deposit_request_hash_version is 2 and [1] otherwise, which is what a gateway that predates this member implies. Ignore a version you do not know.
Minimum array length: 1
Required range: x >= 1
Example:
[1, 2]
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Atum Docs","description":"Documentation for Atum, an open payments network for tokenized-currency payments. You submit a signed payment request; Atum selects a settlement operator's price quote, the operator delivers on the destination rail, and Atum verifies delivery.","colors":{"primary":"#24450d","light":"#b3e78d","dark":"#7fcb49"},"logo":{"light":"https://mintcdn.com/atumlabs/eBwMdhd0uJ6cwbY0/images/assets/wordmark-light.svg?fit=max\u0026auto=format\u0026n=eBwMdhd0uJ6cwbY0\u0026q=85\u0026s=6ba7458a7e4528e698e48cbf8e15c375","dark":"https://mintcdn.com/atumlabs/eBwMdhd0uJ6cwbY0/images/assets/wordmark-dark.svg?fit=max\u0026auto=format\u0026n=eBwMdhd0uJ6cwbY0\u0026q=85\u0026s=023ac107f39c390813f415746157f405"},"favicon":"https://mintcdn.com/atumlabs/eBwMdhd0uJ6cwbY0/favicon.svg?fit=max\u0026auto=format\u0026n=eBwMdhd0uJ6cwbY0\u0026q=85\u0026s=0d5cc391c59a2f5739384e8520536a1a","api":{"playground":{"display":"simple"}},"appearance":{"default":"dark"},"background":{"color":{"light":"#f1f0e9","dark":"#171d15"}},"navbar":{"primary":{"type":"button","label":"Community chat","href":"https://discord.gg/a5mbNjnDNj"}},"footer":{"socials":{"discord":"https://discord.gg/a5mbNjnDNj"},"links":[{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://atum.xyz/privacy-policy"}]}]},"fonts":{"heading":{"family":"Newsreader"},"body":{"family":"Public Sans"}},"styling":{"codeblocks":{"theme":"github-dark"},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"interaction":{"drilldown":false},"variables":{"paymentGatewayTestnet":"https://payment-gw.production-testnet.atum.xyz","paymentGatewayMainnet":"https://payment-gw.production-mainnet.atum.xyz","x402FacilitatorTestnet":"https://payment-gw.production-testnet.atum.xyz/x402/v1","x402FacilitatorMainnet":"https://payment-gw.production-mainnet.atum.xyz/x402/v1","veriFillTestnet":"https://veri-fill.production-testnet.atum.xyz","veriFillMainnet":"https://veri-fill.production-mainnet.atum.xyz"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"atumlabs","hasAudioNarration":false,"actualSubdomain":"atumlabs","customDomains":["docs.atum.xyz"],"gitSource":{"type":"github","owner":"atum-labs","repo":"atum-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae8b017ca78e468455a2e68","collectionId":"f90bb902-a0bb-4b51-a5f6-05f506a97595","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae8b017ca78e468455a2e68"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aed33e649d4102da1fae20b","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"Get started","count":35},{"language":"default","tag":"Overview","count":24},{"language":"default","tag":"Settle payments","count":21},{"language":"default","tag":"API Reference","count":17},{"language":"default","tag":"Core concepts","count":15},{"language":"default","tag":"Start building","count":14},{"language":"default","tag":"Payment protocols","count":13},{"language":"default","tag":"Payment Gateway","count":8},{"language":"default","tag":"Settlement Reference","count":6},{"language":"default","tag":"Configuration","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@import url(\"https://fonts.googleapis.com/css2?family=Host+Grotesk:wght@300..800\u0026display=swap\");@import url(\"https://use.typekit.net/xnt1dnq.css\");:root{--color-dark-charcoal: #2b2a28;--color-tofu: #f1f0e9;--color-tofu-light: #f1efe7;--color-young-green: #97e162;--color-young-green-deep: #7fcb49;--color-green-house: #24450d;--color-dark-teal: #2f6460;--color-pale-green: #f0fbe8;--color-full-white: #ffffff;--color-dark-charcoal-12: rgb(43 42 40 / 12%);--color-dark-charcoal-40: rgb(43 42 40 / 40%);--color-dark-charcoal-65: rgb(43 42 40 / 65%);--ink: #171d15;--ink-2: #1e261c;--ink-line: #2c342b;--ink-muted: #9aa396;--ink-dim: #6b7266;--ink-green: #b3e78d;--ink-fg: #f7f6f2;--font-display: \"hardcover-vf\", \"Newsreader\", \"Iowan Old Style\", Georgia, serif;--font-ui: \"Host Grotesk\", \"host-grotesk\", ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", sans-serif;--font-prose: \"Public Sans\", \"public-sans\", var(--font-ui);--font-mono: ui-monospace, \"SF Mono\", SFMono-Regular, Menlo, Consolas, monospace;--ring: 0 0 0 3px rgb(151 225 98 / 45%);--radius-field: 6px;--fg: var(--color-dark-charcoal);--fg-2: #3a3936;--fg-3: #605f5b;--fg-muted: #83827c;--fg-dim: #b0afa8;--bg: var(--color-tofu);--bg-nav: var(--color-tofu);--hairline: var(--color-dark-charcoal-12);--surface: var(--color-full-white);--surface-line: var(--color-dark-charcoal-12);--label-fg: var(--color-dark-charcoal-65);--link-fg: var(--color-dark-teal);--link-hover: var(--color-green-house);--accent-text: var(--color-green-house);--inline-code-bg: var(--color-full-white);--ok-fg: var(--color-green-house);--ok-bg: var(--color-pale-green);--ok-line: rgb(36 69 13 / 22%);--info-fg: var(--color-dark-teal);--info-bg: #e9f0ef;--info-line: rgb(47 100 96 / 25%);--warn-fg: #7a4e00;--warn-bg: #fbf3e0;--warn-line: rgb(122 78 0 / 25%);--err-fg: #9b2c2c;--err-bg: #fbeae7;--err-line: rgb(155 44 44 / 25%);--muted-fg: var(--color-dark-charcoal-65);--muted-line: var(--color-dark-charcoal-12);--shadow-lg: 0 24px 48px rgb(43 42 40 / 18%)}html.dark{--fg: var(--ink-fg);--fg-2: #e3e4dd;--fg-3: #c9ccc2;--fg-muted: var(--ink-muted);--fg-dim: var(--ink-dim);--bg: var(--ink);--bg-nav: var(--ink-2);--hairline: var(--ink-line);--surface: var(--ink-2);--surface-line: var(--ink-line);--label-fg: var(--ink-muted);--link-fg: var(--ink-green);--link-hover: var(--color-young-green);--accent-text: var(--ink-green);--inline-code-bg: var(--ink-2);--ok-fg: var(--ink-green);--ok-bg: rgb(151 225 98 / 12%);--ok-line: rgb(151 225 98 / 35%);--info-fg: #9fd3ce;--info-bg: rgb(47 100 96 / 25%);--info-line: rgb(47 100 96 / 60%);--warn-fg: #f0c674;--warn-bg: rgb(122 78 0 / 28%);--warn-line: rgb(240 198 116 / 40%);--err-fg: #f3b7b7;--err-bg: rgb(155 44 44 / 30%);--err-line: rgb(243 183 183 / 40%);--muted-fg: var(--ink-muted);--muted-line: var(--ink-line);--shadow-lg: 0 24px 48px rgb(0 0 0 / 45%)}body{-webkit-font-smoothing:antialiased;font-family:var(--font-ui)}::selection{background:var(--color-young-green);color:var(--color-dark-charcoal)}:root{--gray-50: 247 246 242;--gray-100: 241 239 231;--gray-200: 229 228 221;--gray-300: 215 214 207;--gray-400: 176 175 168;--gray-500: 131 130 124;--gray-600: 96 95 91;--gray-700: 58 57 54;--gray-800: 43 42 40;--gray-900: 30 29 27;--gray-950: 21 20 18}html.dark{--gray-50: 247 246 242;--gray-100: 227 228 221;--gray-200: 201 204 194;--gray-300: 181 185 174;--gray-400: 154 163 150;--gray-500: 107 114 102;--gray-600: 76 84 73;--gray-700: 58 67 56;--gray-800: 44 52 43;--gray-900: 30 38 28;--gray-950: 23 29 21}#content,#content .prose,#header .prose{font-family:var(--font-prose);font-weight:400}#content a.link,#header .prose a{color:var(--link-fg);border-bottom:0;text-decoration:underline;text-decoration-thickness:1px;text-underline-offset:2px}#content a.link:hover,#header .prose a:hover{color:var(--link-hover)}#page-title,#content h1,#content h2:not([data-component-part]),#content h3:not([data-component-part]){font-family:var(--font-display);font-weight:300;letter-spacing:-0.02em;color:var(--fg)}#content h4,#content h5,#content h6{font-family:var(--font-ui);font-weight:600;letter-spacing:-0.01em;color:var(--fg)}#page-title{font-size:clamp(2rem, 4vw, 2.75rem);line-height:1.08}#page-title::before{content:\"\";display:block;width:28px;height:3px;margin-bottom:16px;background:var(--color-young-green)}#page-title code{font:500 0.68em/1 var(--font-mono);letter-spacing:0;background:transparent;border:0;padding:0;vertical-align:0.06em}#content h2:not([data-component-part]){font-size:1.75rem;margin-top:2.5rem;padding-top:1.25rem;border-top:1px solid var(--hairline)}#content h2#overview:not([data-component-part]){margin-top:0;padding-top:0;border-top:0}#content h3:not([data-component-part]){font-size:1.35rem}#content :is(h2,h3,h4)>div>a>div{background:transparent;box-shadow:none;--tw-ring-color: transparent;color:var(--label-fg)}#content :is(h2,h3,h4)>div>a>div svg{display:none}#content :is(h2,h3,h4)>div>a>div::before{content:\"¶\";font:400 0.9rem/1 var(--font-ui)}#content :is(h2,h3,h4)>div>a:hover>div::before{color:var(--color-young-green-deep)}#header .prose p{font-family:var(--font-prose);font-weight:300;color:var(--fg-3)}.eyebrow{font:600 10.5px/1.3 var(--font-mono);letter-spacing:0.08em;text-transform:uppercase;color:var(--accent-text)!important;height:auto}.sidebar-group-header,#table-of-contents h2 button,#content th{font:600 10.5px/1.3 var(--font-mono)!important;letter-spacing:0.08em;text-transform:uppercase;color:var(--label-fg)!important}#navbar>div:first-child{background:var(--bg-nav)!important;border-bottom:1px solid var(--hairline)!important;backdrop-filter:none}#navbar a:has(img.nav-logo){display:inline-flex;align-items:center;gap:12px;text-decoration:none;white-space:nowrap}#navbar img.nav-logo,#footer img.nav-logo{height:20px!important;width:auto!important;max-width:none}#navbar a:has(img.nav-logo)::after{content:\"Docs\";display:inline-block;font:600 10.5px/1 var(--font-mono);letter-spacing:0.08em;text-transform:uppercase;color:var(--label-fg);border:1px solid var(--surface-line);border-radius:999px;padding:6px 10px;white-space:nowrap}@media (max-width: 50rem){#navbar a:has(img.nav-logo)::after{display:none}}#navbar .nav-tabs-item,#navbar .navbar-link,#navbar a,#navbar button{font-family:var(--font-ui)}#navbar .nav-tabs-item{font-weight:500;text-shadow:none!important}#navbar .nav-tabs-item[class*=\"text-gray-800\"]{color:var(--fg)}#navbar .nav-tabs-item>div[class*=\"bg-primary\"],#navbar .nav-tabs-item>span[class*=\"bg-primary\"]{background:var(--color-young-green)!important}#search-bar-entry,#search-bar-entry-mobile{background:var(--surface)!important;border:1px solid var(--surface-line);border-radius:999px;color:var(--label-fg);box-shadow:none!important;--tw-ring-color: transparent !important;filter:none!important}#search-bar-entry:hover{border-color:var(--color-dark-charcoal-40)}html.dark #search-bar-entry:hover{border-color:var(--ink-dim)}#search-bar-entry kbd{background:transparent;border:1px solid var(--surface-line);font-family:var(--font-mono)}#topbar-cta-button a{font-family:var(--font-ui);font-weight:500;letter-spacing:-0.01em}#topbar-cta-button a>span[class*=\"absolute\"]{background:var(--color-young-green)!important;border-radius:999px!important;opacity:1!important}#topbar-cta-button a:hover>span[class*=\"absolute\"]{background:var(--color-young-green-deep)!important}#topbar-cta-button a span[class*=\"text-white\"],#topbar-cta-button a svg{color:var(--color-dark-charcoal)!important}#sidebar{border-inline-end:1px solid var(--hairline)}.sidebar-group-header{padding-top:0.4rem;padding-bottom:0.4rem}#sidebar-content a,#sidebar-content button{font-family:var(--font-ui);border-radius:0!important}#sidebar-content a{color:var(--fg-3)}#sidebar-content a[aria-current=\"page\"],#sidebar-content a[aria-current=\"page\"]:hover,#sidebar-content a[aria-current=\"page\"]:focus{background:transparent!important;box-shadow:inset 3px 0 0 var(--color-young-green);color:var(--fg)!important;font-weight:500;text-shadow:none!important}#sidebar-content a:hover:not([aria-current=\"page\"]){background:transparent!important;color:var(--fg);box-shadow:inset 3px 0 0 var(--hairline)}#sidebar-content [class*=\"border-l\"],#sidebar-content ul ul{border-color:var(--hairline)}#table-of-contents-layout{border-inline-start:1px solid var(--hairline)}#table-of-contents a{font-family:var(--font-ui);color:var(--fg-3);text-shadow:none!important}#table-of-contents li[data-active]>a{color:var(--fg)!important;font-weight:500}#table-of-contents h2 button svg{color:var(--label-fg)}#page-context-menu>button,#page-context-menu>div>button{background:var(--surface)!important;border-color:var(--surface-line)!important;color:var(--fg);font:500 13px/1.2 var(--font-ui);letter-spacing:-0.01em}#page-context-menu>button:first-child{border-radius:999px 0 0 999px!important}#page-context-menu>:last-child,#page-context-menu>:last-child button{border-radius:0 999px 999px 0!important}#page-context-menu button:hover{border-color:var(--color-young-green-deep)!important}.code-block,.code-block [data-component-part=\"code-block-root\"],.code-block pre.shiki,.code-group{border-radius:0!important;box-shadow:none!important}.code-block{border:1px solid var(--ink-line);background-color:var(--ink)!important;--tw-ring-color: transparent !important}.code-block [data-component-part=\"code-block-root\"],.code-block pre.shiki,.code-block pre.shiki code{background-color:var(--ink)!important;--shiki-dark-bg: var(--ink) !important;color:var(--ink-fg)}.code-block pre.shiki,.code-block pre.shiki code,.code-block .font-mono{font-family:var(--font-mono)!important;font-size:0.85rem;line-height:1.65}.code-block pre.shiki ::selection{background:rgb(151 225 98 / 30%);color:inherit}.code-block [data-component-part=\"code-block-header\"],.code-group>div:first-child{background:var(--ink-2)!important;border-bottom:1px solid var(--ink-line);border-radius:0!important;color:var(--ink-muted);font:500 0.75rem/1.4 var(--font-ui)}.code-group [role=\"tab\"][aria-selected=\"true\"]{color:var(--ink-fg)!important;box-shadow:inset 0 2px 0 var(--color-young-green)}.code-block-copy-button button,.code-block [data-floating-buttons] button{border-radius:999px!important;background:var(--ink-2)!important;border:1px solid var(--ink-line);color:#c9ccc2!important}.code-block [data-floating-buttons] button:hover{border-color:var(--color-young-green-deep)}#ask-assistant-code-block-button{border-radius:999px!important}#content code:not(pre code),#header .prose code{font-family:var(--font-mono);font-size:0.86em;font-weight:500;color:var(--fg)!important;background:var(--inline-code-bg)!important;border:1px solid var(--surface-line);border-radius:4px;padding:0.1em 0.35em}#content code:not(pre code)::before,#content code:not(pre code)::after{content:none}#content .callout{position:relative;display:grid;grid-template-columns:16px minmax(0, 1fr);column-gap:0.55rem;row-gap:0.45rem;align-items:center;margin-block:1.25rem;padding:0.9rem 1.1rem 0.9rem 1.25rem;border:1px solid var(--aside-line)!important;border-inline-start:3px solid var(--aside-rule)!important;border-radius:0!important;background:var(--aside-bg)!important;color:var(--fg)!important;--aside-rule: var(--color-dark-teal);--aside-fg: var(--info-fg);--aside-bg: var(--info-bg);--aside-line: var(--info-line);--aside-glyph: \"i\";--aside-badge-fg: #fff}#content .callout[data-callout-type=\"tip\"],#content .callout[data-callout-type=\"check\"]{--aside-rule: var(--color-young-green-deep);--aside-fg: var(--ok-fg);--aside-bg: var(--ok-bg);--aside-line: var(--ok-line);--aside-glyph: \"✓\";--aside-badge-fg: var(--color-dark-charcoal)}#content .callout[data-callout-type=\"warning\"]{--aside-rule: #d99a2b;--aside-fg: var(--warn-fg);--aside-bg: var(--warn-bg);--aside-line: var(--warn-line);--aside-glyph: \"!\"}#content .callout[data-callout-type=\"danger\"]{--aside-rule: #c94c4c;--aside-fg: var(--err-fg);--aside-bg: var(--err-bg);--aside-line: var(--err-line);--aside-glyph: \"✕\"}#content .callout>[data-component-part=\"callout-icon\"]{grid-column:1;grid-row:1;width:16px;height:16px;margin:0;border-radius:999px;background:var(--aside-rule);color:var(--aside-badge-fg);font:700 10px/16px var(--font-ui);text-align:center}#content .callout>[data-component-part=\"callout-icon\"] svg{display:none}#content .callout>[data-component-part=\"callout-icon\"]::before{content:var(--aside-glyph)}#content .callout::before{content:attr(aria-label);grid-column:2;grid-row:1;font:600 10.5px/1.3 var(--font-mono);letter-spacing:0.08em;text-transform:uppercase;color:var(--aside-fg)}#content .callout>[data-component-part=\"callout-content\"]{grid-column:1 / -1;grid-row:2;color:var(--fg)!important;font-size:0.875rem;line-height:1.6}#content .callout a{color:var(--link-fg)!important;border-color:currentColor}#content .callout a:hover{color:var(--link-hover)!important}#content .callout strong{color:var(--fg)!important}#content .callout code:not(pre code){background:var(--surface)!important}#content .card,.card{position:relative;border-radius:0!important;background:var(--surface)!important;border:1px solid var(--surface-line)!important;box-shadow:none!important;--tw-ring-color: transparent !important;transition:border-color 0.15s}.card::before{content:\"\";position:absolute;top:10px;left:10px;width:5px;height:5px;background:var(--surface-line);z-index:1}.card:hover{border-color:var(--color-young-green-deep)!important}.card h2,.card h3,.card [class*=\"font-semibold\"]{font-family:var(--font-ui);font-weight:600;letter-spacing:-0.01em;color:var(--fg)}.card [data-component-part=\"card-icon\"] svg,.card svg[style*=\"mask\"]{background-color:var(--accent-text)}details.accordion,.accordion-group{border-radius:0!important;border:1px solid var(--surface-line)!important;background:var(--surface)!important;box-shadow:none!important}.accordion-group details.accordion{border:0!important;border-top:1px solid var(--surface-line)!important}.accordion-group details.accordion:first-child{border-top:0!important}details.accordion>summary{font:500 0.875rem/1.4 var(--font-ui);color:var(--fg);background:transparent!important}details.accordion>summary:hover{color:var(--link-hover)}details.accordion>summary [data-component-part=\"accordion-title\"]{font:inherit;color:inherit}details.accordion>summary [data-component-part=\"accordion-caret-right\"]{color:var(--color-young-green-deep)}details.accordion>summary::after{content:\"show\";margin-left:auto;font:600 10.5px/1 var(--font-mono);letter-spacing:0.08em;text-transform:uppercase;color:var(--label-fg)}details.accordion[open]>summary::after{content:\"hide\"}details.accordion[open]>summary{border-bottom:1px solid var(--surface-line)}details.accordion>[data-component-part=\"accordion-content\"]{padding-top:0.9rem}.tabs [role=\"tablist\"]{border-color:var(--hairline)!important}.tabs [data-component-part=\"tab-button\"]{font-family:var(--font-ui);font-weight:500;color:var(--fg-3)}.tabs [data-component-part=\"tab-button\"][data-active=\"true\"]{color:var(--fg)!important;border-color:var(--color-young-green)!important;border-bottom-width:2px}.steps [data-component-part=\"step-indicator\"]{background:var(--surface)!important;border:1px solid var(--surface-line);color:var(--fg)!important;font:600 11px/1 var(--font-mono)}.steps [data-component-part=\"step-line\"]{background:var(--hairline)!important}.steps [data-component-part=\"step-title\"]{font-family:var(--font-ui);font-weight:600;letter-spacing:-0.01em;color:var(--fg)!important}#content table{font-family:var(--font-ui);font-size:0.875rem;border-collapse:collapse}#content th,#content td{border:0;border-bottom:1px solid var(--hairline);padding:0.6rem 1rem 0.6rem 0;vertical-align:top}#content th{white-space:nowrap}#content tr:nth-child(2n){background:transparent}#content tbody tr:hover{background:transparent}.frame,#content img,.expandable,.tile{border-radius:0!important}.frame{background:var(--surface)!important;border:1px solid var(--surface-line)!important;box-shadow:none!important}#pagination{font-family:var(--font-ui);font-weight:500}#pagination [data-component-part=\"pagination-title\"]{color:var(--fg-3)}#pagination a:hover [data-component-part=\"pagination-title\"]{color:var(--fg)!important}.feedback-toolbar button,#feedback-thumbs-up,#feedback-thumbs-down{border-radius:999px!important;border:1px solid var(--surface-line);background:var(--surface);color:var(--fg-3)}.method-pill,.method-nav-pill{font-family:var(--font-mono);letter-spacing:0.04em;border-radius:999px!important}#footer{background:var(--bg-nav);border-top:1px solid var(--hairline)!important;font-family:var(--font-ui);position:relative;z-index:25}#footer .footer-inner>.h-px,#footer .footer-inner>[class*=\"h-[1px]\"]{display:none!important}#footer .footer-inner,footer .footer-inner{max-width:none!important;width:100%;padding-top:1.25rem!important;padding-bottom:1.25rem!important;gap:0!important}#footer .footer-divider,footer .footer-divider{display:none!important}#footer .footer-mintlify,footer .footer-mintlify{display:flex!important;flex-direction:row!important;align-items:center!important;justify-content:flex-end!important;gap:0.75rem!important;flex:0 0 auto!important;width:auto!important;min-width:0!important}#footer .footer-row,footer .footer-row{display:flex!important;flex-direction:row!important;flex-wrap:wrap;align-items:center!important;justify-content:flex-start!important;gap:1rem 1.5rem!important;width:100%}#footer .footer-row>:not(.audited-by),footer .footer-row>:not(.audited-by){flex:0 0 auto!important;min-width:0!important;max-width:none!important;width:auto!important}#footer .footer-row>:nth-child(3),footer .footer-row>:nth-child(3){margin-left:auto}.audited-by{display:flex;flex-wrap:nowrap;align-items:center;justify-content:flex-start;gap:0.75rem 1rem;flex:0 0 auto;width:auto;min-width:0;padding:0}.audited-by-label{font:600 10.5px/1.3 var(--font-mono);letter-spacing:0.08em;text-transform:uppercase;color:var(--label-fg);text-decoration:none;box-shadow:none}a.audited-by-label:hover{color:var(--fg);opacity:1}.audited-by a[data-auditor]{display:inline-flex;align-items:center;line-height:0;opacity:0.9;text-decoration:none;box-shadow:none}.audited-by a[data-auditor] button,.audited-by a[data-auditor]+button,.audited-by button{display:none}.audited-by a[data-auditor]:hover{opacity:1}.audited-by-logo{width:auto;max-width:none}.audited-by a[data-auditor=\"cantina\"] .audited-by-logo{height:22px}.audited-by a[data-auditor=\"cyfrin\"] .audited-by-logo{height:28px}.audited-by .logo-dark{display:none}.dark .audited-by .logo-light,[data-theme=\"dark\"] .audited-by .logo-light{display:none}.dark .audited-by .logo-dark,[data-theme=\"dark\"] .audited-by .logo-dark{display:block}.pay-timeline{--p1: 12.5%;--p2: 37.5%;--p3: 62.5%;--p4: 87.5%;--rail: var(--fg-dim);--dot-event: var(--fg);--dot-quote: var(--warn-fg);--dot-delivery: var(--err-fg);--bar-quote: var(--ok-fg);--bar-process: var(--warn-fg);--bar-settle: var(--info-fg);margin:1.25rem 0 1.5rem;padding:1.5rem 1.25rem 1.2rem;background:var(--surface);border:1px solid var(--surface-line);border-radius:16px}.pay-timeline-title{margin:0 0 1.75rem;text-align:center;font-family:var(--font-ui);font-size:1.05rem;font-weight:600;color:var(--fg)}.pay-timeline-stage{position:relative;height:196px}.pay-timeline-label,.pay-timeline-caption{position:absolute;margin:0;transform:translateX(-50%);text-align:center;font-family:var(--font-ui);font-weight:500;line-height:1.25}.pay-timeline-label{top:0;font-size:0.78rem;color:var(--fg-2)}.pay-timeline-label--1{left:var(--p1)}.pay-timeline-label--2{left:var(--p2)}.pay-timeline-label--3{left:var(--p3)}.pay-timeline-label--4{left:var(--p4)}.pay-timeline-guide{position:absolute;top:36px;bottom:52px;width:0;border-left:1px dashed var(--fg-dim)}.pay-timeline-guide--1{left:var(--p1)}.pay-timeline-guide--2{left:var(--p2);border-left-color:var(--dot-quote)}.pay-timeline-guide--3{left:var(--p3);border-left-color:var(--dot-delivery)}.pay-timeline-guide--4{left:var(--p4)}.pay-timeline-rail{position:absolute;top:70px;left:var(--p1);width:calc(var(--p4) - var(--p1));height:3px;background:var(--rail);border-radius:2px}.pay-timeline-dot{position:absolute;top:64px;z-index:2;width:14px;height:14px;border-radius:50%;transform:translateX(-50%);background:var(--dot-event)}.pay-timeline-dot--1{left:var(--p1)}.pay-timeline-dot--2{left:var(--p2);background:var(--dot-quote)}.pay-timeline-dot--3{left:var(--p3);background:var(--dot-delivery)}.pay-timeline-dot--4{left:var(--p4)}.pay-timeline-bar{position:absolute;top:92px;height:14px;border-radius:3px}.pay-timeline-bar--quote{left:var(--p1);width:calc(var(--p2) - var(--p1));background:var(--bar-quote)}.pay-timeline-bar--process{left:var(--p2);width:calc(var(--p3) - var(--p2));background:var(--bar-process)}.pay-timeline-bar--settle{left:var(--p3);width:calc(var(--p4) - var(--p3));background:var(--bar-settle)}.pay-timeline-caption{top:114px;font-size:0.75rem;color:var(--fg-3)}.pay-timeline-caption--quote{left:calc((var(--p1) + var(--p2)) / 2)}.pay-timeline-caption--process{left:calc((var(--p2) + var(--p3)) / 2)}.pay-timeline-caption--settle{left:calc((var(--p3) + var(--p4)) / 2)}.pay-timeline-note{margin:0.5rem 0 0;text-align:left;font-family:var(--font-ui);font-size:0.86rem;line-height:1.45;color:var(--fg-3)}.pay-timeline-note p{margin:0}.pay-timeline-note ul{margin:0.4rem 0 0;padding-left:1.15rem}.pay-timeline-note li{margin:0.35rem 0 0}.pay-timeline-note li:first-child{margin-top:0}.changelog-toc{margin:0.25rem 0 0.5rem 1.75rem;padding-left:0.75rem;border-left:1px solid var(--surface-line);list-style:none}.changelog-toc-date{margin:0.6rem 0 0.2rem;font-family:var(--font-ui);font-size:0.72rem;letter-spacing:0.04em;color:var(--fg-muted)}.changelog-toc-date:first-child{margin-top:0.2rem}.changelog-toc a{display:block;padding:0.2rem 0;font-size:0.82rem;line-height:1.35;color:var(--fg-2)}.changelog-toc a:hover{color:var(--accent-text)}.update-container [data-component-part=\"update-tag\"]{padding:0.1rem 0.55rem;border:1px solid var(--surface-line);border-radius:999px;font-family:var(--font-ui);font-size:0.78rem;white-space:nowrap;color:var(--fg-2);cursor:pointer;transition:border-color 120ms ease, color 120ms ease}.update-container [data-component-part=\"update-tag\"]:hover{border-color:var(--accent-text);color:var(--accent-text)}.update-container [data-component-part=\"update-tag\"][aria-pressed=\"true\"]{border-color:rgb(var(--primary));background:rgb(var(--primary));color:rgb(255 255 255 / 0.9)}.update-container [data-component-part=\"update-tag\"]:focus-visible{outline:none;box-shadow:var(--ring)}@media (min-width: 1280px){[class*=\"max-w-8xl\"]{max-width:1600px!important}body:has(#table-of-contents,#changelog-filters) #content-area{width:calc(100% - 20rem)!important;max-width:none!important}}#header :is(h1,p),#content :is(p,ul,ol,blockquote,h1,h2,h3,h4,h5,h6):not(td *,th *,li *){max-width:38em}@media (min-width: 1024px){.update-container>div:first-child{width:150px!important}}.update-container .prose-sm{font-size:1rem;line-height:1.75}"}],"page":{"pagePath":"api-reference/payment-gateway/chain-defaults","slug":"/api-reference/payment-gateway/chain-defaults","pageMetadata":{"title":"Get chain defaults","description":"Fetch the Payment Gateway's live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.","openapi":"GET /v1/defaults","href":"/api-reference/payment-gateway/chain-defaults"},"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: \"Fetch the Payment Gateway’s live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsx(Note,{children:_jsxs(_components.p,{children:[`Fetch these addresses at startup rather than hardcoding them — they change when a chain’s contracts are redeployed. With no `,_jsx(_components.code,{children:`chain_id`}),` you get every chain the gateway serves, which also makes this the simplest check that the gateway is reachable. A chain that isn’t fully configured is left out of that listing, and an empty address is a chain you cannot pay on. See `,_jsx(_components.a,{href:`/get-started/reference/contract-addresses`,children:`Contract addresses`}),`.`]})})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":"github-dark"},"config":{},"pageMetadata":{"title":"Get chain defaults","description":"Fetch the Payment Gateway's live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.","openapi":"GET /v1/defaults","href":"/api-reference/payment-gateway/chain-defaults"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/atumlabs/ea8598561a186193/audited-by.js","/_mintlify/custom/atumlabs/946086a3f73c7db3/webmcp.js","/_mintlify/custom/atumlabs/28a7e63cae1e14fd/changelog-tags.js","/_mintlify/custom/atumlabs/f97675e153f577c9/changelog-toc.js"],"openApiReferenceData":{"operation":{"summary":"Get chain defaults","description":"Fetch the Payment Gateway's live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.","operationId":"getDefaults","tags":["Chain Defaults"],"parameters":["159f915e-9aa0-4dc1-ab5a-a488105229f6"],"responses":{"200":"307d04d5-95bd-45a9-ba86-c52829fd8488","400":"4f4e4556-854f-4449-b750-ef0741c7d104","404":"6db23cb9-8123-436b-a238-a5f90016195f","503":"afad94e8-a5cb-44ac-859d-8210310fe90d"},"method":"get","type":"path","servers":["33df3309-b84e-48a9-94c1-aac200cf674f","fa558170-4e9e-4663-9e9b-39906523216e"],"security":[],"path":"/v1/defaults","baseUrlOptions":["https://payment-gw.production-mainnet.atum.xyz","https://payment-gw.production-testnet.atum.xyz"],"title":"Get chain defaults","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"159f915e-9aa0-4dc1-ab5a-a488105229f6":{"name":"chain_id","in":"query","required":false,"description":"CAIP-2 chain identifier. Omit it, or send it empty, to receive every chain the gateway serves, keyed by chain id.","schema":{"type":"string","isRequired":false,"description":"CAIP-2 chain identifier. Omit it, or send it empty, to receive every chain the gateway serves, keyed by chain id.","uniqueKey":"","typeLabel":"string"},"example":"eip155:84532"}},"responses":{"307d04d5-95bd-45a9-ba86-c52829fd8488":{"description":"Chain defaults. A single object when `chain_id` was supplied, otherwise an object keyed by CAIP-2 chain id.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","description":"Either one chain's defaults or every chain keyed by CAIP-2 chain id, depending on whether `chain_id` was supplied. A top-level `chain_id` identifies the first.","required":["chain_id","quote_selector","escrow_contract","fulfillment_proxy","fulfillment_verifier"],"properties":{"chain_id":{"type":"string","description":"CAIP-2 identifier of the chain these defaults describe, normalised to lower case.","example":"eip155:84532","isRequired":true,"uniqueKey":"oneOf.0.chain_id","typeLabel":"string"},"quote_selector":{"type":"string","description":"The account named as the reserver in the deposit authorization. Sign against this exact value; a deposit reserved by anyone else is rejected.","example":"0xd0f080E23F95571D26eEb1FAD24a5F3d66835195","isRequired":true,"uniqueKey":"oneOf.0.quote_selector","typeLabel":"string"},"escrow_contract":{"type":"string","description":"The escrow the deposit is made into, and the spender of the token approval. Empty when the chain is not fully configured.","example":"0xa61a0C025943Aa79B73D8D07E3aDbEe1873738b4","isRequired":true,"uniqueKey":"oneOf.0.escrow_contract","typeLabel":"string"},"fulfillment_proxy":{"type":"string","description":"The contract that pays the receiver. Read this from the DESTINATION chain's defaults, not the source chain's. Empty when the chain is not fully configured.","example":"0x09A5a0d6955E5394A661Cd9E7007076fa63B4158","isRequired":true,"uniqueKey":"oneOf.0.fulfillment_proxy","typeLabel":"string"},"fulfillment_verifier":{"type":"object","description":"The service that attests settlement, and the account it signs with.","required":["account","endpoint"],"properties":{"account":{"type":"string","description":"The account named as the releaser in the deposit authorization. Sign against this exact value.","example":"0x27050EE47befC43F4dF7807a7AA8073039e5fa89","isRequired":true,"uniqueKey":"oneOf.0.fulfillment_verifier.account","typeLabel":"string"},"endpoint":{"type":"string","format":"uri","description":"Base URL of the fulfillment verifier serving this chain.","example":"https://veri-fill.example.com","isRequired":true,"uniqueKey":"oneOf.0.fulfillment_verifier.endpoint","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"oneOf.0.fulfillment_verifier","typeLabel":"object"},"permit2_contract":{"type":"string","minLength":1,"description":"The Permit2 this chain's escrow verifies against, sent only when it is not the canonical deployment. When absent, use the canonical Permit2 address for the chain. EVM and Tron only.","example":"0x000000000022D473030F116dDEE9F6B43aC78BA3","uniqueKey":"oneOf.0.permit2_contract","typeLabel":"string"},"tokens":{"type":"array","description":"Tokens this chain's escrow accepts for deposit. Absent when the gateway has no listing for the chain, which does not mean no token is accepted.","items":{"type":"object","required":["symbol","address","decimals"],"properties":{"symbol":{"type":"string","example":"USDC","isRequired":true,"uniqueKey":"oneOf.0.tokens.items.[INDEX].symbol","typeLabel":"string"},"address":{"type":"string","description":"Token contract address, in the chain's native address format.","example":"0x036cbd53842c5426634e7929541ec2318f3dcf7e","isRequired":true,"uniqueKey":"oneOf.0.tokens.items.[INDEX].address","typeLabel":"string"},"decimals":{"type":"integer","description":"Decimal places, for converting a human amount to base units.","example":6,"isRequired":true,"uniqueKey":"oneOf.0.tokens.items.[INDEX].decimals","typeLabel":"integer"}},"uniqueKey":"oneOf.0.tokens.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.0.tokens","typeLabel":"object[]"},"svm_signature_cluster_id":{"type":"string","description":"Solana only. The cluster the escrow's signing domain is bound to, needed to build the deposit hash. Absent for EVM and Tron.","example":"devnet","uniqueKey":"oneOf.0.svm_signature_cluster_id","typeLabel":"string"},"svm_signature_domain_version":{"type":"integer","minimum":1,"description":"Solana only. The escrow's signature domain version, which the deposit hash commits to. Absent for EVM and Tron.","example":5,"uniqueKey":"oneOf.0.svm_signature_domain_version","typeLabel":"integer"},"deposit_request_hash_version":{"type":"integer","minimum":1,"description":"The depositRequestHash version to sign for a deposit from this chain: 1 is keccak256 of the request_id, 2 is the hash of the payment terms, computed over the request body exactly as it is then posted. Absent means 1. Kept for clients that predate `deposit_request_hash_versions`, which a client should read instead: a deposit signed with version 1 is still accepted unless that list omits 1. It stays 2 once version 1 is no longer accepted, so a client that reads only this member keeps signing version 2.","example":2,"uniqueKey":"oneOf.0.deposit_request_hash_version","typeLabel":"integer"},"deposit_request_hash_versions":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"integer","minimum":1,"uniqueKey":"oneOf.0.deposit_request_hash_versions.items.[INDEX]","typeLabel":"integer"},"description":"The depositRequestHash versions a deposit from this chain may be signed with, ascending: `[1]` before version 2, `[1, 2]` once the gateway publishes 2 in `deposit_request_hash_version`, and `[2]` once it no longer accepts version 1. A merchant lists exactly these in an x402 or MPP challenge. Absent means `[1, 2]` when `deposit_request_hash_version` is 2 and `[1]` otherwise, which is what a gateway that predates this member implies. Ignore a version you do not know.","example":[1,2],"uniqueKey":"oneOf.0.deposit_request_hash_versions","typeLabel":"integer[]"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","description":"Either one chain's defaults or every chain keyed by CAIP-2 chain id, depending on whether `chain_id` was supplied. A top-level `chain_id` identifies the first.","example":{"eip155:84532":{"chain_id":"eip155:84532","quote_selector":"0xd0f080E23F95571D26eEb1FAD24a5F3d66835195","escrow_contract":"0xa61a0C025943Aa79B73D8D07E3aDbEe1873738b4","fulfillment_proxy":"0x09A5a0d6955E5394A661Cd9E7007076fa63B4158","fulfillment_verifier":{"account":"0x27050EE47befC43F4dF7807a7AA8073039e5fa89","endpoint":"https://veri-fill.example.com"}}},"additionalProperties":{"type":"object","description":"The addresses for one chain. Optional fields appear only where they apply to that\nchain; an absent optional field is not an error.\n","required":["chain_id","quote_selector","escrow_contract","fulfillment_proxy","fulfillment_verifier"],"properties":{"chain_id":{"type":"string","description":"CAIP-2 identifier of the chain these defaults describe, normalised to lower case.","example":"eip155:84532","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.chain_id","typeLabel":"string"},"quote_selector":{"type":"string","description":"The account named as the reserver in the deposit authorization. Sign against this exact value; a deposit reserved by anyone else is rejected.","example":"0xd0f080E23F95571D26eEb1FAD24a5F3d66835195","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.quote_selector","typeLabel":"string"},"escrow_contract":{"type":"string","description":"The escrow the deposit is made into, and the spender of the token approval. Empty when the chain is not fully configured.","example":"0xa61a0C025943Aa79B73D8D07E3aDbEe1873738b4","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.escrow_contract","typeLabel":"string"},"fulfillment_proxy":{"type":"string","description":"The contract that pays the receiver. Read this from the DESTINATION chain's defaults, not the source chain's. Empty when the chain is not fully configured.","example":"0x09A5a0d6955E5394A661Cd9E7007076fa63B4158","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.fulfillment_proxy","typeLabel":"string"},"fulfillment_verifier":{"type":"object","description":"The service that attests settlement, and the account it signs with.","required":["account","endpoint"],"properties":{"account":{"type":"string","description":"The account named as the releaser in the deposit authorization. Sign against this exact value.","example":"0x27050EE47befC43F4dF7807a7AA8073039e5fa89","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.fulfillment_verifier.account","typeLabel":"string"},"endpoint":{"type":"string","format":"uri","description":"Base URL of the fulfillment verifier serving this chain.","example":"https://veri-fill.example.com","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.fulfillment_verifier.endpoint","typeLabel":"string\u003curi>"}},"isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.fulfillment_verifier","typeLabel":"object"},"permit2_contract":{"type":"string","minLength":1,"description":"The Permit2 this chain's escrow verifies against, sent only when it is not the canonical deployment. When absent, use the canonical Permit2 address for the chain. EVM and Tron only.","example":"0x000000000022D473030F116dDEE9F6B43aC78BA3","uniqueKey":"oneOf.1.additionalProperties.permit2_contract","typeLabel":"string"},"tokens":{"type":"array","description":"Tokens this chain's escrow accepts for deposit. Absent when the gateway has no listing for the chain, which does not mean no token is accepted.","items":{"type":"object","required":["symbol","address","decimals"],"properties":{"symbol":{"type":"string","example":"USDC","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.tokens.items.[INDEX].symbol","typeLabel":"string"},"address":{"type":"string","description":"Token contract address, in the chain's native address format.","example":"0x036cbd53842c5426634e7929541ec2318f3dcf7e","isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.tokens.items.[INDEX].address","typeLabel":"string"},"decimals":{"type":"integer","description":"Decimal places, for converting a human amount to base units.","example":6,"isRequired":true,"uniqueKey":"oneOf.1.additionalProperties.tokens.items.[INDEX].decimals","typeLabel":"integer"}},"uniqueKey":"oneOf.1.additionalProperties.tokens.items.[INDEX]","typeLabel":"object"},"uniqueKey":"oneOf.1.additionalProperties.tokens","typeLabel":"object[]"},"svm_signature_cluster_id":{"type":"string","description":"Solana only. The cluster the escrow's signing domain is bound to, needed to build the deposit hash. Absent for EVM and Tron.","example":"devnet","uniqueKey":"oneOf.1.additionalProperties.svm_signature_cluster_id","typeLabel":"string"},"svm_signature_domain_version":{"type":"integer","minimum":1,"description":"Solana only. The escrow's signature domain version, which the deposit hash commits to. Absent for EVM and Tron.","example":5,"uniqueKey":"oneOf.1.additionalProperties.svm_signature_domain_version","typeLabel":"integer"},"deposit_request_hash_version":{"type":"integer","minimum":1,"description":"The depositRequestHash version to sign for a deposit from this chain: 1 is keccak256 of the request_id, 2 is the hash of the payment terms, computed over the request body exactly as it is then posted. Absent means 1. Kept for clients that predate `deposit_request_hash_versions`, which a client should read instead: a deposit signed with version 1 is still accepted unless that list omits 1. It stays 2 once version 1 is no longer accepted, so a client that reads only this member keeps signing version 2.","example":2,"uniqueKey":"oneOf.1.additionalProperties.deposit_request_hash_version","typeLabel":"integer"},"deposit_request_hash_versions":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"integer","minimum":1,"uniqueKey":"oneOf.1.additionalProperties.deposit_request_hash_versions.items.[INDEX]","typeLabel":"integer"},"description":"The depositRequestHash versions a deposit from this chain may be signed with, ascending: `[1]` before version 2, `[1, 2]` once the gateway publishes 2 in `deposit_request_hash_version`, and `[2]` once it no longer accepts version 1. A merchant lists exactly these in an x402 or MPP challenge. Absent means `[1, 2]` when `deposit_request_hash_version` is 2 and `[1]` otherwise, which is what a gateway that predates this member implies. Ignore a version you do not know.","example":[1,2],"uniqueKey":"oneOf.1.additionalProperties.deposit_request_hash_versions","typeLabel":"integer[]"}},"uniqueKey":"oneOf.1.additionalProperties","typeLabel":"object"},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"chain_id":"eip155:84532","quote_selector":"0xd0f080E23F95571D26eEb1FAD24a5F3d66835195","escrow_contract":"0xa61a0C025943Aa79B73D8D07E3aDbEe1873738b4","fulfillment_proxy":"0x09A5a0d6955E5394A661Cd9E7007076fa63B4158","fulfillment_verifier":{"account":"0x27050EE47befC43F4dF7807a7AA8073039e5fa89","endpoint":"https://veri-fill.example.com"},"permit2_contract":"0x000000000022D473030F116dDEE9F6B43aC78BA3","tokens":[{"symbol":"USDC","address":"0x036cbd53842c5426634e7929541ec2318f3dcf7e","decimals":6}],"svm_signature_cluster_id":"devnet","svm_signature_domain_version":5,"deposit_request_hash_version":2,"deposit_request_hash_versions":[1,2]}}},"exampleType":"generated"}},"exampleType":"generated"},"4f4e4556-854f-4449-b750-ef0741c7d104":{"description":"The `chain_id` is not a valid CAIP-2 chain identifier","content":{"application/json":{"schema":{"type":"object","description":"Safe, outward-facing error. Derived from an internal error through the shared error catalog. The public code identifies the category and the message is a curated, safe description.\n\nA panic is caught by shared middleware that responds `{\"error\": \"Internal server error occurred\"}` instead, so a 500 is not guaranteed to carry this shape.","required":["code","message"],"properties":{"code":{"type":"string","description":"Public, machine-readable error category in SCREAMING_SNAKE_CASE.","pattern":"^[A-Z][A-Z0-9_]*$","example":"INVALID_SOURCE_ASSET","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Curated, safe, human-readable message.","maxLength":500,"example":"The source asset identifier is not a valid CAIP-19 asset.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id to quote to support to locate the internal error record.","example":"req_123456789","uniqueKey":"request_id","typeLabel":"string"},"payment_id":{"type":"string","description":"The payment this error was raised against. Absent when the error is not about a specific payment.","example":"0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c","uniqueKey":"payment_id","typeLabel":"string"},"docs_url":{"type":"string","format":"uri","description":"Link to the documentation page for this public code.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"},"domain":{"type":"string","description":"Originating service domain.","example":"PAYMENT_GATEWAY","uniqueKey":"domain","typeLabel":"string"},"retry_classification":{"type":"string","description":"What the caller should do next. Absent means the condition has not been classified, which is not the same as safe to retry.\nRe-sending the same `request_id` is an idempotent replay and always safe. This value is about submitting a new one, which starts a new operation. See https://docs.atum.xyz/errors for the value set.","example":"RECONCILE_THEN_DECIDE","uniqueKey":"retry_classification","typeLabel":"string"},"request_id_reusable":{"type":"boolean","description":"Whether the caller may re-send this same request_id. True means no payment was created for it, so the id is still free. False means a payment exists for it, so the id is spent and re-sending only replays this outcome. Absent means undetermined, which a caller should read as false. Separate from retry_classification, which answers what the caller must change rather than whether the id survived.","example":false,"uniqueKey":"request_id_reusable","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"INVALID_SOURCE_ASSET","message":"The source asset identifier is not a valid CAIP-19 asset.","request_id":"req_123456789","payment_id":"0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c","docs_url":"\u003cstring>","domain":"PAYMENT_GATEWAY","retry_classification":"RECONCILE_THEN_DECIDE","request_id_reusable":false}}},"exampleType":"generated"}},"exampleType":"generated"},"6db23cb9-8123-436b-a238-a5f90016195f":{"description":"The requested chain is not served by this gateway, or - when `chain_id` was omitted - no chain could be resolved at all","content":{"application/json":{"schema":{"type":"object","description":"Safe, outward-facing error. Derived from an internal error through the shared error catalog. The public code identifies the category and the message is a curated, safe description.\n\nA panic is caught by shared middleware that responds `{\"error\": \"Internal server error occurred\"}` instead, so a 500 is not guaranteed to carry this shape.","required":["code","message"],"properties":{"code":{"type":"string","description":"Public, machine-readable error category in SCREAMING_SNAKE_CASE.","pattern":"^[A-Z][A-Z0-9_]*$","example":"INVALID_SOURCE_ASSET","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Curated, safe, human-readable message.","maxLength":500,"example":"The source asset identifier is not a valid CAIP-19 asset.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id to quote to support to locate the internal error record.","example":"req_123456789","uniqueKey":"request_id","typeLabel":"string"},"payment_id":{"type":"string","description":"The payment this error was raised against. Absent when the error is not about a specific payment.","example":"0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c","uniqueKey":"payment_id","typeLabel":"string"},"docs_url":{"type":"string","format":"uri","description":"Link to the documentation page for this public code.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"},"domain":{"type":"string","description":"Originating service domain.","example":"PAYMENT_GATEWAY","uniqueKey":"domain","typeLabel":"string"},"retry_classification":{"type":"string","description":"What the caller should do next. Absent means the condition has not been classified, which is not the same as safe to retry.\nRe-sending the same `request_id` is an idempotent replay and always safe. This value is about submitting a new one, which starts a new operation. See https://docs.atum.xyz/errors for the value set.","example":"RECONCILE_THEN_DECIDE","uniqueKey":"retry_classification","typeLabel":"string"},"request_id_reusable":{"type":"boolean","description":"Whether the caller may re-send this same request_id. True means no payment was created for it, so the id is still free. False means a payment exists for it, so the id is spent and re-sending only replays this outcome. Absent means undetermined, which a caller should read as false. Separate from retry_classification, which answers what the caller must change rather than whether the id survived.","example":false,"uniqueKey":"request_id_reusable","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"INVALID_SOURCE_ASSET","message":"The source asset identifier is not a valid CAIP-19 asset.","request_id":"req_123456789","payment_id":"0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c","docs_url":"\u003cstring>","domain":"PAYMENT_GATEWAY","retry_classification":"RECONCILE_THEN_DECIDE","request_id_reusable":false}}},"exampleType":"generated"}},"exampleType":"generated"},"afad94e8-a5cb-44ac-859d-8210310fe90d":{"description":"A dependency is temporarily unavailable","content":{"application/json":{"schema":{"type":"object","description":"Safe, outward-facing error. Derived from an internal error through the shared error catalog. The public code identifies the category and the message is a curated, safe description.\n\nA panic is caught by shared middleware that responds `{\"error\": \"Internal server error occurred\"}` instead, so a 500 is not guaranteed to carry this shape.","required":["code","message"],"properties":{"code":{"type":"string","description":"Public, machine-readable error category in SCREAMING_SNAKE_CASE.","pattern":"^[A-Z][A-Z0-9_]*$","example":"INVALID_SOURCE_ASSET","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Curated, safe, human-readable message.","maxLength":500,"example":"The source asset identifier is not a valid CAIP-19 asset.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id to quote to support to locate the internal error record.","example":"req_123456789","uniqueKey":"request_id","typeLabel":"string"},"payment_id":{"type":"string","description":"The payment this error was raised against. Absent when the error is not about a specific payment.","example":"0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c","uniqueKey":"payment_id","typeLabel":"string"},"docs_url":{"type":"string","format":"uri","description":"Link to the documentation page for this public code.","uniqueKey":"docs_url","typeLabel":"string\u003curi>"},"domain":{"type":"string","description":"Originating service domain.","example":"PAYMENT_GATEWAY","uniqueKey":"domain","typeLabel":"string"},"retry_classification":{"type":"string","description":"What the caller should do next. Absent means the condition has not been classified, which is not the same as safe to retry.\nRe-sending the same `request_id` is an idempotent replay and always safe. This value is about submitting a new one, which starts a new operation. See https://docs.atum.xyz/errors for the value set.","example":"RECONCILE_THEN_DECIDE","uniqueKey":"retry_classification","typeLabel":"string"},"request_id_reusable":{"type":"boolean","description":"Whether the caller may re-send this same request_id. True means no payment was created for it, so the id is still free. False means a payment exists for it, so the id is spent and re-sending only replays this outcome. Absent means undetermined, which a caller should read as false. Separate from retry_classification, which answers what the caller must change rather than whether the id survived.","example":false,"uniqueKey":"request_id_reusable","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"INVALID_SOURCE_ASSET","message":"The source asset identifier is not a valid CAIP-19 asset.","request_id":"req_123456789","payment_id":"0xc7108e200d11580e7e75185991084b42a535af588ba8267cd0d1e7df089e5c9c","docs_url":"\u003cstring>","domain":"PAYMENT_GATEWAY","retry_classification":"RECONCILE_THEN_DECIDE","request_id_reusable":false}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"33df3309-b84e-48a9-94c1-aac200cf674f":{"url":"https://payment-gw.production-mainnet.atum.xyz","description":"Mainnet"},"fa558170-4e9e-4663-9e9b-39906523216e":{"url":"https://payment-gw.production-testnet.atum.xyz","description":"Testnet"}}},"originalFileLocation":"api-reference/payment-gateway/openapi.yaml"},"subdomain":"atumlabs","siteName":"Atum Docs","title":"Get chain defaults - Atum Docs","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"automatic"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-22T00:03:17.741Z","originalFileLocation":"api-reference/payment-gateway/chain-defaults.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=\"dark\"}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=\"Fetch the Payment Gateway\u0026#x27;s live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Atum 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/atumlabs/Pqh0GSDdyRfy-YKa/_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/atumlabs/Pqh0GSDdyRfy-YKa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/atumlabs/Pqh0GSDdyRfy-YKa/_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/atumlabs/Pqh0GSDdyRfy-YKa/_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/atumlabs/Pqh0GSDdyRfy-YKa/_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/atumlabs/Pqh0GSDdyRfy-YKa/_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/atumlabs/Pqh0GSDdyRfy-YKa/_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/atumlabs/Pqh0GSDdyRfy-YKa/_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/atumlabs/Pqh0GSDdyRfy-YKa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get chain defaults - Atum Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch the Payment Gateway\u0026#x27;s live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Atum Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://atumlabs.mintlify.site/_mintlify/api/og/v2?division=Payment+Gateway\u0026amp;title=Get+chain+defaults\u0026amp;description=Fetch+the+Payment+Gateway%27s+live+chain+defaults%3A+contract+addresses+per+CAIP-2+chain%2C+and+which+chains+you+can+actually+pay+on%2C+instead+of+hardcoding+them.\u0026amp;theme=2455e481a76f39e16fb336fe\u0026amp;signature=aa1541a1d6ac9f5a542b7bf47ae540daf64abcc15bdfc059dd7b867476d5c88b\">\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=\"Get chain defaults - Atum Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch the Payment Gateway\u0026#x27;s live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://atumlabs.mintlify.site/_mintlify/api/og/v2?division=Payment+Gateway\u0026amp;title=Get+chain+defaults\u0026amp;description=Fetch+the+Payment+Gateway%27s+live+chain+defaults%3A+contract+addresses+per+CAIP-2+chain%2C+and+which+chains+you+can+actually+pay+on%2C+instead+of+hardcoding+them.\u0026amp;theme=2455e481a76f39e16fb336fe\u0026amp;signature=aa1541a1d6ac9f5a542b7bf47ae540daf64abcc15bdfc059dd7b867476d5c88b\">\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/atumlabs/Pqh0GSDdyRfy-YKa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Atum Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#24450d\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/payment-gateway/chain-defaults.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.atum.xyz/#organization\",\"name\":\"Atum Docs\",\"url\":\"https://docs.atum.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/atumlabs/eBwMdhd0uJ6cwbY0/images/assets/wordmark-light.svg?fit=max\u0026auto=format\u0026n=eBwMdhd0uJ6cwbY0\u0026q=85\u0026s=6ba7458a7e4528e698e48cbf8e15c375\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.atum.xyz#website\",\"name\":\"Atum Docs\",\"url\":\"https://docs.atum.xyz\",\"publisher\":{\"@id\":\"https://docs.atum.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults#webpage\",\"url\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults\",\"name\":\"Get chain defaults\",\"description\":\"Fetch the Payment Gateway's live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.\",\"dateModified\":\"2026-09-22T00:03:17.741Z\",\"isPartOf\":{\"@id\":\"https://docs.atum.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Payment Gateway\",\"item\":\"https://docs.atum.xyz/api-reference/payment-gateway/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get chain defaults\",\"item\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults#apireference\",\"headline\":\"Get chain defaults\",\"name\":\"Get chain defaults\",\"description\":\"Fetch the Payment Gateway's live chain defaults: contract addresses per CAIP-2 chain, and which chains you can actually pay on, instead of hardcoding them.\",\"url\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults\",\"mainEntityOfPage\":{\"@id\":\"https://docs.atum.xyz/api-reference/payment-gateway/chain-defaults#webpage\"},\"dateModified\":\"2026-09-22T00:03:17.741Z\",\"publisher\":{\"@id\":\"https://docs.atum.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.atum.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Atum Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Atum Docs","nav":{"global":null,"tabs":[{"tab":"Get started","icon":"rocket","pages":[{"title":"Get started","href":"/get-started/overview/what-is-atum"}]},{"tab":"Payment protocols","icon":"route","pages":[{"title":"Payment protocols","href":"/payment-protocols/overview"}]},{"tab":"Settle payments","icon":"handshake","pages":[{"title":"Settle payments","href":"/settle-payments/what-is-an-atum-settlement"}]},{"tab":"API Reference","icon":"code","groups":[{"group":"Introduction","pages":[{"title":"API Reference","sidebarTitle":"Overview","icon":"code","href":"/api-reference/overview"},{"title":"auth.md","sidebarTitle":"How agents authenticate","hidden":true,"href":"/auth"},{"title":"Idempotency","sidebarTitle":"Idempotency","icon":"arrows-rotate","href":"/api-reference/idempotency"}]},{"group":"Error handling","icon":"circle-exclamation","pages":[{"title":"Error codes","icon":"circle-exclamation","href":"/errors"},{"title":"Decline reasons","icon":"hand","href":"/decline-reasons"}]},{"group":"Payment Gateway","pages":[{"title":"Overview","href":"/api-reference/payment-gateway/introduction"},{"title":"Submit payment request","openapi":"POST /v1/payments","href":"/api-reference/payment-gateway/submit-payment"},{"title":"Get payment status","openapi":"GET /v1/payments/{paymentId}/status","href":"/api-reference/payment-gateway/get-payment-status"},{"title":"Resolve a payment request","openapi":"GET /v1/payments/resolve","href":"/api-reference/payment-gateway/resolve-payment"},{"title":"Get payment timeline","openapi":"GET /v1/payments/{paymentId}/timeline","href":"/api-reference/payment-gateway/payment-timeline"},{"title":"Create a quote-request","openapi":"POST /v1/payments/quote-requests","href":"/api-reference/payment-gateway/create-quote-request"},{"title":"Get quote-request status","description":"Read a quote-request batch and the quotes collected for it so far.","openapi":"GET /v1/payments/quote-requests/{quoteRequestId}","href":"/api-reference/payment-gateway/quote-request-status"},{"title":"Get chain defaults","openapi":"GET /v1/defaults","href":"/api-reference/payment-gateway/chain-defaults"}]},{"group":"x402 Facilitator","pages":[{"title":"Overview","description":"The standard x402 v2 facilitator interface served by atum-escrow","href":"/api-reference/x402/introduction"},{"title":"Verify payment","openapi":"POST /verify","href":"/api-reference/x402/verify"},{"title":"Settle payment","openapi":"POST /settle","href":"/api-reference/x402/settle"},{"title":"Supported kinds","openapi":"GET /supported","href":"/api-reference/x402/supported"}]},{"group":"Veri-Fill","pages":[{"title":"Veri-Fill API","sidebarTitle":"Overview","href":"/api-reference/veri-fill/introduction"}]}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get chain defaults - Atum Docs","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}