Monitor your transfers and track their status using transfer queries and events.Gets all transfers for the wallet with optional pagination.
getTransfers() includes Spark transfers, Lightning sends/receives, and cooperative exits. For token transaction details, use queryTokenTransactionsWithFilters().
// Get recent transfersconst transfers = await wallet.getTransfers(10);console.log("Recent transfers:", transfers.transfers);// Check specific transfer statusconst recentTransfer = transfers.transfers[0];console.log("Transfer ID:", recentTransfer.id);console.log("Transfer status:", recentTransfer.status);console.log("Amount:", recentTransfer.totalValue, "sats");
Monitor transfer status in real-time using event listeners.
// Listen for incoming transfer eventswallet.on("transfer:claimed", (transferId, updatedBalance) => { console.log(`Incoming transfer ${transferId} claimed! New balance: ${updatedBalance} sats`);});// Note: There are no events for outgoing transfers.// The transfer() method returns immediately when the transfer completes.
The transfer:claimed event only fires for incoming transfers. For outgoing transfers, the transfer() method returns a WalletTransfer object when complete.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Spark","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#151515"},"logo":{"light":"https://mintcdn.com/lightspark/uYWAuFR6Cxtb0uSg/images/logo-black.svg?fit=max\u0026auto=format\u0026n=uYWAuFR6Cxtb0uSg\u0026q=85\u0026s=25372f66a4814d6d53c52af40d4721e3","dark":"https://mintcdn.com/lightspark/uYWAuFR6Cxtb0uSg/images/logo-white.svg?fit=max\u0026auto=format\u0026n=uYWAuFR6Cxtb0uSg\u0026q=85\u0026s=7468254a8804b96e77b2bb4a33bbd8d0","href":"https://docs.spark.money"},"favicon":"https://mintcdn.com/lightspark/9Uoevi-SGmZ4_qMo/images/favicon.svg?fit=max\u0026auto=format\u0026n=9Uoevi-SGmZ4_qMo\u0026q=85\u0026s=247876e19fe2aca2e8ff4725910ccda6","api":{},"navbar":{"links":[{"href":"https://www.spark.money/report","label":"Report a bug"},{"href":"https://www.spark.money/contact","label":"Get in touch"}]},"footer":{"socials":{"x":"https://x.com/spark","github":"https://github.com/buildonspark"},"links":[{"header":"Legal","items":[{"label":"Privacy Policy","href":"https://spark.money/privacy"},{"label":"Terms of Service","href":"https://spark.money/terms-of-use"}]}]},"search":{},"seo":{"metatags":{"canonical":"https://docs.spark.money","og:image":"/images/og/og-spark.png","og:site_name":"Spark Documentation","og:locale":"en_US","twitter:site":"@spark","twitter:card":"summary_large_image","robots":"index, follow","language":"en","author":"Spark","category":"Technology","keywords":"bitcoin layer 2, bitcoin l2, self-custody bitcoin, lightning network, bitcoin stablecoin, stablecoin on bitcoin, bitcoin payments, bitcoin wallet sdk, 0-conf deposits, zero confirmation bitcoin, bitcoin scaling, spark protocol, BTKN tokens, bitcoin native tokens"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-DZD23R72CM"},"segment":{"key":"jj3Pmdv7apJ7K8KZP0JrLQWhGJrRSPgN"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"lightspark","hasAudioNarration":false,"actualSubdomain":"lightspark","customDomains":["docs.spark.money"],"gitSource":{"type":"github","owner":"buildonspark","repo":"spark-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6abb064378859c2eaac739ec","collectionId":"2cde6498-3e4a-4449-b9a6-faf2d2992c26","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6abb064378859c2eaac739ec"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6abb064378859c2eaac739ec","clientVersion":"0.0.3966","searchFilterCounts":[{"language":"default","tag":"API Reference","count":95},{"language":"default","tag":"Wallets","count":86},{"language":"default","tag":"Issuance","count":29},{"language":"default","tag":"Learn","count":21},{"language":"default","tag":"Advanced","count":20},{"language":"default","tag":"Wallet Viewer","count":15},{"language":"default","tag":"Bitcoin","count":15},{"language":"default","tag":"Tokens","count":14},{"language":"default","tag":"Core operations","count":13},{"language":"default","tag":"Introduction","count":12}]},"assistantConfig":{},"hasChatPermissions":false,"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":":root{--black:#0a0a0a;--white:#fafafa;--blue:#15b9eb;--white-pure:#fff;--green:#00c896;--green-bright:#2adf72;--red:#ff4d4d;--yellow:#f2e863;--orange:#ff8c42;--purple:#fafafa;--white-00:rgba(250, 250, 250, 0);--white-01:rgba(250, 250, 250, 0.01);--white-02:rgba(250, 250, 250, 0.02);--white-04:rgba(250, 250, 250, 0.04);--white-08:rgba(250, 250, 250, 0.08);--white-10:rgba(250, 250, 250, 0.1);--white-20:rgba(250, 250, 250, 0.2);--white-30:rgba(250, 250, 250, 0.3);--white-40:rgba(250, 250, 250, 0.4);--white-50:rgba(250, 250, 250, 0.5);--white-60:rgba(250, 250, 250, 0.6);--white-70:rgba(250, 250, 250, 0.7);--white-80:rgba(250, 250, 250, 0.8);--white-90:rgba(250, 250, 250, 0.9);--black-00:rgba(10, 10, 10, 0);--black-01:rgba(10, 10, 10, 0.01);--black-02:rgba(10, 10, 10, 0.02);--black-04:rgba(10, 10, 10, 0.04);--black-08:rgba(10, 10, 10, 0.08);--black-10:rgba(10, 10, 10, 0.1);--black-20:rgba(10, 10, 10, 0.2);--black-30:rgba(10, 10, 10, 0.3);--black-40:rgba(10, 10, 10, 0.4);--black-50:rgba(10, 10, 10, 0.5);--black-60:rgba(10, 10, 10, 0.6);--black-70:rgba(10, 10, 10, 0.7);--black-80:rgba(10, 10, 10, 0.8);--black-90:rgba(10, 10, 10, 0.9)}:not(code):not(pre):not(code *):not(pre *){font-family:\"Helvetica Neue\",Helvetica,Arial,sans-serif!important}.dark article,.dark label,.dark li,.dark p,.dark span,.dark td,.dark th{color:#e5e5e5!important}.prose li,.prose p,article li,article p{font-size:1.0625rem!important;line-height:1.7!important}h4{font-size:1em!important;font-weight:400!important}*{scrollbar-width:none!important;-ms-overflow-style:none!important;-webkit-overflow-scrolling:touch!important}::-webkit-scrollbar{display:none!important}img[src*=\"/icons/icon-activity-lime.svg\"],img[src*=\"/icons/icon-app-brale.svg\"],img[src*=\"/icons/icon-app-sparkscan.svg\"],img[src*=\"/icons/icon-cli-white.svg\"],img[src*=\"/icons/icon-grid-white.svg\"],img[src*=\"/icons/icon-hidden-white.svg\"],img[src*=\"/icons/icon-network-spark.svg\"],img[src*=\"/icons/icon-sign-white.svg\"]{filter:invert(1) brightness(0) saturate(0%)!important}a.bg-primary\\/10 img[src*=\"/icons/icon-activity-lime.svg\"],a.bg-primary\\/10 img[src*=\"/icons/icon-app-brale.svg\"],a.bg-primary\\/10 img[src*=\"/icons/icon-app-sparkscan.svg\"],a.bg-primary\\/10 img[src*=\"/icons/icon-cli-white.svg\"],a.bg-primary\\/10 img[src*=\"/icons/icon-grid-white.svg\"],a.bg-primary\\/10 img[src*=\"/icons/icon-hidden-white.svg\"],a.bg-primary\\/10 img[src*=\"/icons/icon-network-spark.svg\"],a.bg-primary\\/10 img[src*=\"/icons/icon-sign-white.svg\"]{filter:invert(1)!important;opacity:1}.dark img[src*=\"/icons/icon-activity-lime.svg\"],.dark img[src*=\"/icons/icon-app-brale.svg\"],.dark img[src*=\"/icons/icon-app-sparkscan.svg\"],.dark img[src*=\"/icons/icon-cli-white.svg\"],.dark img[src*=\"/icons/icon-grid-white.svg\"],.dark img[src*=\"/icons/icon-hidden-white.svg\"],.dark img[src*=\"/icons/icon-network-spark.svg\"],.dark img[src*=\"/icons/icon-sign-white.svg\"]{filter:invert(0) brightness(100) saturate(0%)!important}.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-activity-lime.svg\"],.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-app-brale.svg\"],.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-app-sparkscan.svg\"],.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-cli-white.svg\"],.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-grid-white.svg\"],.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-hidden-white.svg\"],.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-network-spark.svg\"],.dark a.dark\\:bg-primary-light\\/10 img[src*=\"/icons/icon-sign-white.svg\"]{filter:invert(0)!important;opacity:1}#navigation-items li a,#sidebar-group li button,#sidebar-group li div{background-color:transparent!important;color:var(--black-60)!important;transition:all .2s ease!important}.dark #navigation-items li a,.dark #sidebar-group li button,.dark #sidebar-group li div{background-color:transparent!important;color:var(--white-60)!important;transition:all .2s ease!important}#navigation-items li a:hover,#sidebar-group li button:hover,#sidebar-group li div:hover{background-color:transparent!important;color:var(--black-80)!important}.dark #navigation-items li a:hover,.dark #sidebar-group li button:hover,.dark #sidebar-group li div:hover{background-color:transparent!important;color:var(--white-80)!important}#navigation-items li a.bg-primary\\/10,#sidebar-group li button[aria-expanded=true],#sidebar-group li div[aria-expanded=true]{color:var(--black)!important;font-weight:500!important}.dark #navigation-items li a.dark\\:bg-primary-light\\/10,.dark #sidebar-group li button[aria-expanded=true],.dark #sidebar-group li div[aria-expanded=true]{color:var(--white)!important;font-weight:500!important}#header .eyebrow,li[id=\"https://app.lightspark.com/regtest-faucet\"] svg,li[id=\"https://btkn.info/\"] svg,li[id=\"https://www.sparkscan.io/?network=mainnet\"] svg{display:none!important}.chill{pointer-events:none!important}.grid a[class*=rounded],.not-prose a[class*=block],.not-prose>div>a,.not-prose>div>div>a,[class*=Accordion],[class*=Card_],[class*=Card_card],[class*=CodeBlock],[class*=CodeGroup],[class*=Expandable],[class*=Tab_],[class*=Tabs],[class*=_card],[class*=accordion],[class*=border][class*=rounded],[class*=card_card],[class*=code_],[class*=codeblock],[class*=codegroup],[class*=expandable],[class*=pre_],[class*=rounded-2xl],[class*=rounded-lg],[class*=rounded-xl],[class*=tab_],[class*=tabs],[style*=border-radius],article a[class*=rounded],article div[class*=rounded],code,details,details summary,pre{border-radius:4px!important}.spark-card{background-color:var(--black-02)}.dark .spark-card{background-color:var(--white-02)}.spark-card:hover{background-color:var(--black-04)}.dark .spark-card:hover{background-color:var(--white-04)}.spark-card .icon-light{display:block}.dark .spark-card .icon-light,.spark-card .icon-dark{display:none}.dark .spark-card .icon-dark{display:block}.spark-card .card-description,.spark-card .card-title{color:var(--black);font-size:1rem!important;margin:0!important;padding:0!important}.dark .spark-card .card-title{color:var(--white)}.feature-card h3,.feature-card p,.feature-card span,.spark-card,.spark-card *{border:0!important;border-bottom:none!important}.spark-card .card-description{font-size:.875rem!important;font-weight:400!important;line-height:1.5!important;color:var(--black-50)!important}.dark .spark-card .card-description{color:var(--white-50)!important}.hcard-row,.spark-card .hcard-row{display:flex!important;flex-direction:row!important;flex-wrap:nowrap!important;align-items:center!important;gap:1rem!important}.hcard-icon,.spark-card .hcard-icon{flex-shrink:0!important;order:-1!important;width:40px!important;height:40px!important;min-width:40px!important}.hcard-icon img,.spark-card .hcard-icon img{width:100%!important;height:100%!important;margin:0!important}.hcard-text,.spark-card .hcard-text{order:1!important;gap:.5rem!important}.hcard-text,.spark-card .hcard-text,.spark-card .vcard-col{display:flex!important;flex-direction:column!important}.spark-card .vcard-image{width:100%!important;aspect-ratio:16/9!important;position:relative!important}.spark-card .vcard-image img{width:100%!important;height:100%!important;object-fit:cover!important}.spark-card .vcard-content{display:flex!important;flex-direction:column!important;gap:.5rem!important;padding:1.5rem!important}.spark-tabcard-btn,.spark-tabcard-container{background-color:var(--black-02)}.dark .spark-tabcard-btn,.dark .spark-tabcard-container{background-color:var(--white-02)}.spark-tabcard-item-active{background-color:var(--black-04)}.dark .spark-tabcard-item-active{background-color:var(--white-04)}.spark-tabcard-title{color:var(--black)}.dark .spark-tabcard-title{color:var(--white)}.spark-tabcard-desc{color:var(--black-50)}.dark .spark-tabcard-desc{color:var(--white-50)}.spark-tabcard-img-light{display:block}.dark .spark-tabcard-img-light,.spark-tabcard-img-dark{display:none}.dark .spark-tabcard-img-dark{display:block}.spark-method{background-color:var(--black-02);color:var(--black);border-color:var(--black-04)}.dark .spark-method{background-color:var(--white-02);color:var(--white);border-color:var(--white-04)}.spark-button{background-color:var(--black);color:var(--white)!important;border-radius:6px!important}.dark .spark-button,.dark .spark-button *{background-color:var(--white);color:#000!important}.spark-button:hover{background-color:var(--black-50)}.dark .spark-button:hover{background-color:var(--white-50)}.spark-button-outline{background-color:transparent;border:1px solid #e5e7eb;color:#374151!important;border-radius:6px!important}.dark .spark-button-outline{border-color:rgba(255,255,255,.07);color:#d1d5db!important}.spark-button-outline:hover{background-color:var(--black-02)}.dark .spark-button-outline:hover{background-color:var(--white-02)}.spark-videotile-active{background-color:#f3f4f6}.dark .spark-videotile-active{background-color:rgba(255,255,255,.05)}.spark-videotile-title{color:#000}.dark .spark-videotile-title{color:#fff}.spark-videotile-desc{color:#4b5563}.dark .spark-videotile-desc{color:#9ca3af}.dark .spark-videotile-link,.spark-videotile-link{color:#2563eb}.spark-videotile-link:hover{color:#1d4ed8}.dark .spark-videotile-link:hover{color:#3b82f6}.spark-videotile-container{background-color:#f5f8ff;border-color:#d3e1ff}.dark .spark-videotile-container{background-color:#001033;border-color:#011d5b}.spark-videotile-empty{color:#9ca3af}.dark .spark-videotile-empty{color:#6b7280}.feature-card{border:1px solid var(--black-10)!important;border-radius:6px!important;padding:0!important;overflow:hidden;transition:border-color .2s ease}.dark .feature-card{border-color:var(--white-10)!important}.feature-card:hover{border-color:var(--black-20)!important}.dark .feature-card:hover{border-color:var(--white-20)!important}.feature-card [class*=Zoom],.feature-card [class*=zoom],.feature-card button,a[href*=\"mintlify.com\"][href*=\"utm_campaign=poweredBy\"],a[href*=\"mintlify.com\"][href*=poweredBy]{display:none!important}.feature-card-inner{display:flex!important;flex-direction:column!important;text-decoration:none!important}.feature-card-header{display:flex!important;flex-direction:row!important;align-items:center!important;gap:10px!important;padding:16px 20px!important;border-bottom:1px solid var(--black-08)!important}.dark .feature-card-header{border-bottom-color:var(--white-08)!important}.feature-card-icon{flex-shrink:0;width:20px;height:20px;display:flex;align-items:center;justify-content:center}.feature-card-icon img{width:20px;height:20px;margin:0!important;pointer-events:none}.feature-card .icon-light{display:block}.dark .feature-card .icon-light,.feature-card .icon-dark{display:none}.dark .feature-card .icon-dark{display:block}.feature-card-description,.feature-card-title{font-size:15px!important;font-weight:500!important;line-height:1.3!important;margin:0!important;padding:0!important;color:var(--black)}.dark .feature-card-title{color:var(--white)}.feature-card-description{font-weight:400!important;line-height:1.6!important;padding:16px 20px!important;color:var(--black-50)}.dark .feature-card-description{color:var(--white-50)}.status-badge{display:inline-flex;align-items:center;gap:6px;padding:4px 10px 4px 8px;border-radius:6px;font-size:13px;font-weight:500}.status-badge-live{background-color:rgba(0,200,150,.1);color:#00a67d}.dark .status-badge-live{background-color:rgba(0,200,150,.15);color:#00c896}.status-badge-dev{background-color:rgba(255,140,66,.1);color:#d97316}.dark .status-badge-dev{background-color:rgba(255,140,66,.15);color:#ff8c42}.status-dot{width:8px;height:8px;border-radius:50%}.status-dot-live{background-color:#00c896}.status-dot-dev{background-color:#ff8c42}.chat-assistant-floating-input>div>div,div:has(>div>#chat-assistant-textarea){background-color:var(--white-20)!important;border:1px solid var(--black-10)!important;border-radius:12px!important}.dark .chat-assistant-floating-input>div>div,.dark div:has(>div>#chat-assistant-textarea){background-color:var(--black-10)!important;border:1px solid var(--white-10)!important}.chat-assistant-floating-input>div{transition:transform .2s ease!important}[id^=headlessui-dialog-panel-][class*=rounded]{backdrop-filter:blur(48px)!important;background-color:var(--white-80)!important;border:1px solid var(--black-10)!important;border-radius:12px!important}.dark [id^=headlessui-dialog-panel-][class*=rounded]{background-color:var(--black-20)!important;border:1px solid var(--white-10)!important;border-radius:12px!important}#search-input,#search-input:focus{outline:0!important;outline-width:0!important;outline-color:transparent!important;border:0!important;background-color:var(--black-04)!important}.dark #search-input,.dark #search-input:focus{background-color:var(--white-04)!important}"}],"page":{"pagePath":"wallets/transfer-bitcoin","slug":"/wallets/transfer-bitcoin","pageMetadata":{"title":"Transfer Bitcoin","description":null,"sidebarTitle":"Transfer Bitcoin","keywords":["transfer bitcoin","instant bitcoin","zero fee transfer","instant bitcoin transfers","bitcoin wallet transfer","off-chain bitcoin"],"icon":"/icons/icon-btc.svg","og:image":"/images/og/og-wallet-sdk.png","seo":{"title":"Send Bitcoin on Spark | Instant Zero-Fee Transfers","description":"Transfer Bitcoin between Spark wallets instantly with zero fees. Status tracking and real-time event monitoring."},"href":"/wallets/transfer-bitcoin"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];const Method=({children,className=``})=>{return _jsx(`code`,{className:`spark-method not-prose mint-inline-block mint-px-2 mint-py-1 mint-mt-12 mint-text-sm mint-font-mono mint-font-semibold mint-rounded-md mint-border ${className}`,children})};function _createMdxContent(props){const _components={a:`a`,code:`code`,hr:`hr`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Frame,Heading,Info,OptimizedImage,ResponseField,Warning,_MdxComponentBoundary}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);if(!_MdxComponentBoundary)_missingMdxReference(`_MdxComponentBoundary`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Send Bitcoin instantly between Spark wallets with zero fees.`}),`\n`,_jsxs(Frame,{className:`chill`,children:[_jsx(OptimizedImage,{className:`mint-block dark:mint-hidden`,src:`https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin-light.png?fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=dbdb9ea8267654f3dbeaf308d538b729`,alt:`Transfer Bitcoin`,\"data-og-width\":`3840`,width:`3840`,\"data-og-height\":`2160`,height:`2160`,\"data-path\":`images/wallets/transfer-bitcoin-light.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin-light.png?w=280\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=2ec48840469aa05a4e469944707e49d8 280w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin-light.png?w=560\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=e5169c351977784cb09fd39344432c13 560w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin-light.png?w=840\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=58bc53debaa96a88c4c19ed79160b18f 840w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin-light.png?w=1100\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=8f91645577ece68ea6ef319aca643a45 1100w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin-light.png?w=1650\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=332e32937943f4bbedd7cd298c64ba97 1650w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin-light.png?w=2500\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=7b1f3d585db0c814aca4ccf3d3a79e21 2500w`}),_jsx(OptimizedImage,{className:`mint-hidden dark:mint-block`,src:`https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin.png?fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=d037fa689126ccaf0c80cc13621ad469`,alt:`Transfer Bitcoin`,\"data-og-width\":`3840`,width:`3840`,\"data-og-height\":`2160`,height:`2160`,\"data-path\":`images/wallets/transfer-bitcoin.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin.png?w=280\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=0dd93fc5c53405be97e2c9d27421888b 280w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin.png?w=560\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=a10c5130eb6b6e6751ea5fa9fa6b1941 560w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin.png?w=840\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=63809d7c6c693bee53eb41fd51275506 840w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin.png?w=1100\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=6fdc7bd1709c933d85ca107ef3ea68a7 1100w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin.png?w=1650\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=5893e40298f3925a537d92b6e9e31f85 1650w, https://mintcdn.com/lightspark/RCkJgy8FQAJRUhsh/images/wallets/transfer-bitcoin.png?w=2500\u0026fit=max\u0026auto=format\u0026n=RCkJgy8FQAJRUhsh\u0026q=85\u0026s=dfc228c888c7ef1fba03b589faaff908 2500w`})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`transfer-bitcoin`,children:`Transfer Bitcoin`}),`\n`,_jsx(_components.p,{children:`Send Bitcoin to another Spark wallet using a simple transfer method.`}),`\n`,_jsx(_MdxComponentBoundary,{name:`Method`,children:_jsx(Method,{children:`transfer(params)`})}),`\n`,_jsx(_components.p,{children:`Transfers Bitcoin to another Spark wallet on the Spark network.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`6`,language:`typescript`,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:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` transferResult`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` wallet`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`transfer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` receiverSparkAddress:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"spark1p...\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Recipient's Spark address`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` amountSats:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 50000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Amount in satoshis`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Transfer successful:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`transferResult`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),`\n`,_jsxs(Expandable,{title:`Parameters`,children:[_jsx(ResponseField,{name:`receiverSparkAddress`,type:`string`,required:true,id:`param-receiver-spark-address`,children:_jsx(_components.p,{children:`The recipient’s Spark address`})}),_jsx(ResponseField,{name:`amountSats`,type:`number`,required:true,id:`param-amount-sats`,children:_jsx(_components.p,{children:`The amount in satoshis to transfer`})})]}),`\n`,_jsx(Expandable,{title:`Returns`,children:_jsx(ResponseField,{name:`transfer`,type:`WalletTransfer`,required:true,id:`param-transfer`,children:_jsx(_components.p,{children:`The completed transfer details including transaction ID and status`})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`check-transfer-status`,children:`Check Transfer Status`}),`\n`,_jsx(_components.p,{children:`Monitor your transfers and track their status using transfer queries and events.`}),`\n`,_jsx(_MdxComponentBoundary,{name:`Method`,children:_jsx(Method,{children:`getTransfers(limit?, offset?)`})}),`\n`,_jsx(_components.p,{children:`Gets all transfers for the wallet with optional pagination.`}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`getTransfers()`}),` includes Spark transfers, Lightning sends/receives, and cooperative exits. For token transaction details, use `,_jsx(_components.a,{href:`/api-reference/wallet/query-token-transactions-with-filters`,children:_jsx(_components.code,{children:`queryTokenTransactionsWithFilters()`})}),`.`]})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`9`,language:`typescript`,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:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`9`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Get recent transfers`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` transfers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` wallet`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`getTransfers`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Recent transfers:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`transfers`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`transfers`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Check specific transfer status`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` recentTransfer`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` transfers`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`transfers`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`];`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Transfer ID:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`recentTransfer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Transfer status:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`recentTransfer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`status`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Amount:\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`recentTransfer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`totalValue`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"sats\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`]})})}),`\n`,_jsxs(Expandable,{title:`Parameters`,children:[_jsx(ResponseField,{name:`limit`,type:`number`,required:false,id:`param-limit`,children:_jsx(_components.p,{children:`Maximum number of transfers to return (default: 20)`})}),_jsx(ResponseField,{name:`offset`,type:`number`,required:false,id:`param-offset`,children:_jsx(_components.p,{children:`Offset for pagination (default: 0)`})})]}),`\n`,_jsxs(Expandable,{title:`Returns`,children:[_jsx(ResponseField,{name:`transfers`,type:`WalletTransfer[]`,required:true,id:`param-transfers`,children:_jsx(_components.p,{children:`Array of transfer objects containing transfer details`})}),_jsx(ResponseField,{name:`offset`,type:`number`,required:true,id:`param-offset-1`,children:_jsx(_components.p,{children:`The offset used for this request`})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`real-time-transfer-monitoring`,children:`Real-time Transfer Monitoring`}),`\n`,_jsx(_components.p,{children:`Monitor transfer status in real-time using event listeners.`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`typescript`,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:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Listen for incoming transfer events`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`wallet`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`on`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"transfer:claimed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, (`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`transferId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`updatedBalance`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`=>`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`Incoming transfer \"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`transferId`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` claimed! New balance: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`updatedBalance`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" sats`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Note: There are no events for outgoing transfers.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// The transfer() method returns immediately when the transfer completes.`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`transfer:claimed`}),` event only fires for `,_jsx(_components.strong,{children:`incoming`}),` transfers. For outgoing transfers, the `,_jsx(_components.code,{children:`transfer()`}),` method returns a `,_jsx(_components.code,{children:`WalletTransfer`}),` object when complete.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{Method,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":"Transfer Bitcoin","description":null,"sidebarTitle":"Transfer Bitcoin","keywords":["transfer bitcoin","instant bitcoin","zero fee transfer","instant bitcoin transfers","bitcoin wallet transfer","off-chain bitcoin"],"icon":"/icons/icon-btc.svg","og:image":"/images/og/og-wallet-sdk.png","seo":{"title":"Send Bitcoin on Spark | Instant Zero-Fee Transfers","description":"Transfer Bitcoin between Spark wallets instantly with zero fees. Status tracking and real-time event monitoring."},"href":"/wallets/transfer-bitcoin"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[142,385,")=>null;function _cr"]]},"mdxExtracts":{"tableOfContents":[{"title":"Transfer Bitcoin","slug":"transfer-bitcoin","depth":2,"children":[]},{"title":"Check Transfer Status","slug":"check-transfer-status","depth":2,"children":[]},{"title":"Real-time Transfer Monitoring","slug":"real-time-transfer-monitoring","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"dynamicCss":".mint-mt-12 {\n margin-top: 3rem\n}\n.mint-block {\n display: block\n}\n.mint-inline-block {\n display: inline-block\n}\n.mint-hidden {\n display: none\n}\n.mint-rounded-md {\n border-radius: 0.375rem\n}\n.mint-border {\n border-width: 1px\n}\n.mint-px-2 {\n padding-left: 0.5rem;\n padding-right: 0.5rem\n}\n.mint-py-1 {\n padding-top: 0.25rem;\n padding-bottom: 0.25rem\n}\n.mint-font-mono {\n font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, \"Liberation Mono\", \"Courier New\", monospace\n}\n.mint-text-sm {\n font-size: 0.875rem;\n line-height: 1.25rem\n}\n.mint-font-semibold {\n font-weight: 600\n}\n.dark\\:mint-block:is(.dark *) {\n display: block\n}\n.dark\\:mint-hidden:is(.dark *) {\n display: none\n}","subdomain":"lightspark","siteName":"Spark","title":"Transfer Bitcoin - Spark","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-29T00:29:06.339Z","originalFileLocation":"wallets/transfer-bitcoin.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=\"keywords\" content=\"bitcoin layer 2, bitcoin l2, self-custody bitcoin, lightning network, bitcoin stablecoin, stablecoin on bitcoin, bitcoin payments, bitcoin wallet sdk, 0-conf deposits, zero confirmation bitcoin, bitcoin scaling, spark protocol, BTKN tokens, bitcoin native tokens\">\u003cmeta data-mint-head name=\"application-name\" content=\"Spark\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/lightspark/KbHTQsAQFJB5ca_h/_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/lightspark/KbHTQsAQFJB5ca_h/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/lightspark/KbHTQsAQFJB5ca_h/_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/lightspark/KbHTQsAQFJB5ca_h/_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/lightspark/KbHTQsAQFJB5ca_h/_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/lightspark/KbHTQsAQFJB5ca_h/_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/lightspark/KbHTQsAQFJB5ca_h/_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/lightspark/KbHTQsAQFJB5ca_h/_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/lightspark/KbHTQsAQFJB5ca_h/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Transfer Bitcoin - Spark\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Spark Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spark.money/wallets/transfer-bitcoin\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://lightspark.mintlify.app/images/og/og-wallet-sdk.png\">\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=\"Transfer Bitcoin - Spark\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://lightspark.mintlify.app/images/og/og-wallet-sdk.png\">\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/lightspark/KbHTQsAQFJB5ca_h/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Spark\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"language\" content=\"en\">\u003cmeta data-mint-head name=\"author\" content=\"Spark\">\u003cmeta data-mint-head name=\"category\" content=\"Technology\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spark.money/wallets/transfer-bitcoin\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/wallets/transfer-bitcoin.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spark.money/#organization\",\"name\":\"Spark\",\"url\":\"https://docs.spark.money\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/lightspark/uYWAuFR6Cxtb0uSg/images/logo-black.svg?fit=max\u0026auto=format\u0026n=uYWAuFR6Cxtb0uSg\u0026q=85\u0026s=25372f66a4814d6d53c52af40d4721e3\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spark.money#website\",\"name\":\"Spark\",\"url\":\"https://docs.spark.money\",\"publisher\":{\"@id\":\"https://docs.spark.money/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spark.money/wallets/transfer-bitcoin#webpage\",\"url\":\"https://docs.spark.money/wallets/transfer-bitcoin\",\"name\":\"Transfer Bitcoin\",\"dateModified\":\"2026-09-29T00:29:06.339Z\",\"isPartOf\":{\"@id\":\"https://docs.spark.money#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spark.money/wallets/transfer-bitcoin#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spark.money/wallets/transfer-bitcoin#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transfers\",\"item\":\"https://docs.spark.money/wallets/transfer-tokens\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transfer Bitcoin\",\"item\":\"https://docs.spark.money/wallets/transfer-bitcoin\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.spark.money/wallets/transfer-bitcoin#article\",\"headline\":\"Transfer Bitcoin\",\"name\":\"Transfer Bitcoin\",\"url\":\"https://docs.spark.money/wallets/transfer-bitcoin\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spark.money/wallets/transfer-bitcoin#webpage\"},\"image\":\"https://docs.spark.money/images/og/og-wallet-sdk.png\",\"dateModified\":\"2026-09-29T00:29:06.339Z\",\"keywords\":\"transfer bitcoin, instant bitcoin, zero fee transfer, instant bitcoin transfers, bitcoin wallet transfer, off-chain bitcoin\",\"publisher\":{\"@id\":\"https://docs.spark.money/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spark.money#website\"}}]}\u003c/script>","siteName":"Spark","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/start/overview"}]},{"tab":"Wallets","groups":[{"group":"Introduction","pages":[{"title":"Overview","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-grid-white.svg","mode":"wide","href":"/wallets/overview"}]},{"group":"Installation","pages":[{"title":"React Native SDK","sidebarTitle":"React Native","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-reactnative.svg","href":"/wallets/react-native"},{"title":"TypeScript SDK","sidebarTitle":"TypeScript","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-typescript.svg","href":"/wallets/typescript"},{"title":"API Reference","sidebarTitle":"API Reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-api-red.svg","href":"/wallets/api-reference"}]},{"group":"Wallet","pages":[{"title":"Addressing","sidebarTitle":"Addressing","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-at-blue.svg","href":"/wallets/addressing"},{"title":"Create a Wallet","sidebarTitle":"Create a Wallet","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-wallet-purple.svg","href":"/wallets/create-wallet"},{"title":"Balances \u0026 Activity","sidebarTitle":"Balances \u0026 Activity","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-activity-lime.svg","href":"/wallets/balances"},{"title":"Privacy Mode","sidebarTitle":"Privacy Mode","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-hidden-white.svg","href":"/wallets/privacy"},{"title":"Webhooks","sidebarTitle":"Webhooks","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-activity-lime.svg","href":"/wallets/webhooks"},{"title":"Wallet Viewer","sidebarTitle":"Wallet Viewer","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-data-blue.svg","href":"/wallets/readonly-client"}]},{"group":"Transfers","pages":[{"title":"Transfer Tokens","description":null,"sidebarTitle":"Transfer Tokens","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-btkn.svg","href":"/wallets/transfer-tokens"},{"title":"Transfer Bitcoin","sidebarTitle":"Transfer Bitcoin","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-btc.svg","href":"/wallets/transfer-bitcoin"},{"title":"Spark Invoices","description":null,"sidebarTitle":"Spark Invoices","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-document-purple.svg","href":"/wallets/spark-invoices"}]},{"group":"Deposits","pages":[{"title":"Deposit from L1","sidebarTitle":"Deposit from L1","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-deposit-orange.svg","href":"/wallets/deposit-from-l1"},{"title":"Deposit from Lightning","sidebarTitle":"Deposit from Lightning","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-deposit-purple.svg","href":"/wallets/deposit-from-lightning"}]},{"group":"Withdrawals","pages":[{"title":"Withdraw to L1","sidebarTitle":"Withdraw to L1","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-withdraw-orange.svg","href":"/wallets/withdraw-to-l1"},{"title":"Withdraw to Lightning","sidebarTitle":"Withdraw to Lightning","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-withdraw-purple.svg","href":"/wallets/withdraw-to-lightning"},{"title":"Unilateral Exit","sidebarTitle":"Unilateral Exit","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-withdraw-orange.svg","href":"/wallets/unilateral-exit"}]},{"group":"Fees","pages":[{"title":"Estimate Fees","sidebarTitle":"Estimate Fees","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-math-greenbright.svg","href":"/wallets/estimate-fees"}]},{"group":"Spark Signer Interface","pages":[{"title":"Spark Signer Interface","sidebarTitle":"Spark Signer Interface","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-sign-white.svg","href":"/wallets/spark-signer"},{"title":"Identity Key Derivation","sidebarTitle":"Identity Key Derivation","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-key-red.svg","href":"/wallets/identity-key-derivation"}]},{"group":"Tools","pages":[{"title":"Regtest Faucet","sidebarTitle":"Regtest Faucet","url":"https://app.lightspark.com/regtest-faucet","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-drop-blue.svg","href":"/tools/faucet"},{"title":"Explorer","sidebarTitle":"Explorer","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-globe-greenbright.svg","url":"https://www.sparkscan.io/?network=mainnet","href":"/tools/explorer"},{"title":"Spark CLI","sidebarTitle":"Spark CLI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/lightspark/icons/icon-cli-white.svg","mode":"wide","href":"/wallets/tools/cli"}]}]},{"tab":"Issuance","pages":[{"title":"Issuance","href":"/issuance/overview"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/overview"}]},{"tab":"Learn","pages":[{"title":"Learn","href":"/learn/tldr"}]}]},"title":"Transfer Bitcoin - Spark","buildId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","deploymentId":"dpl_cadrRc5H9XQiJQbDFN5mcYRs2PAj","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-B0bJ23PC.js","DynamicMarkdown-UGQuxDKp.js","zoom-image-lightbox-B0E5HDf_.js","lightbox-handle-r17bVUz3.js"]}