Create a pending, bounded Privy spending grant for a hosted wallet.
Surface: Hosted OAuth Mutates state: Creates a pending grant Idempotency: Stable request_id Confirmation:confirmed_by_user=true after reviewing scope and limits
The grant has no spending authority until the owner activates it through the
attached card. Show the raw activation URL only when requested or when the
card is unavailable.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"AgentBank","description":"Use AgentBank through its hosted agent, MCP integration, or Partner API for fiat and crypto payment routes.","colors":{"primary":"#0062FF","light":"#3381FF","dark":"#0050D4"},"logo":{"light":"https://mintcdn.com/agent-bank-5c587c2b/L0nehGwUBEbme6M7/logo/agentbank-wordmark-light.png?fit=max\u0026auto=format\u0026n=L0nehGwUBEbme6M7\u0026q=85\u0026s=eefd492c10a757d95ca2f5d1cab995d1","dark":"https://mintcdn.com/agent-bank-5c587c2b/L0nehGwUBEbme6M7/logo/agentbank-wordmark-dark.png?fit=max\u0026auto=format\u0026n=L0nehGwUBEbme6M7\u0026q=85\u0026s=9cebda151a60e1ae2ef23b15cb863dd5"},"favicon":"https://mintcdn.com/agent-bank-5c587c2b/O-cRtlrroe5S8rAR/favicon.png?fit=max\u0026auto=format\u0026n=O-cRtlrroe5S8rAR\u0026q=85\u0026s=0b8aa178df5d47552ebc10b620fb01c1","navbar":{"links":[{"href":"https://useagentbank.com/SKILL.md","label":"Skill"},{"href":"https://github.com/theagentbank/skills","label":"GitHub"}],"primary":{"type":"button","label":"Open AgentBank","href":"https://app.useagentbank.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"agent-bank-5c587c2b","hasAudioNarration":false,"actualSubdomain":"agent-bank-5c587c2b","customDomains":["docs.useagentbank.com"],"gitSource":{"type":"github","owner":"trunghuynh-humanfx","repo":"agentbank-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6abac2e856dcf939aa49743b","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"MCP reference","count":73},{"language":"default","tag":"Tool reference","count":53},{"language":"default","tag":"AgentBank","count":38},{"language":"default","tag":"Partner API","count":35},{"language":"default","tag":"API reference","count":24},{"language":"default","tag":"Getting started","count":10},{"language":"default","tag":"Signed Partner API","count":10},{"language":"default","tag":"Setup and identity tools","count":10},{"language":"default","tag":"Merchant Portal API","count":9},{"language":"default","tag":"Payment tools","count":9}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"reference/tools/request-spending-grant","slug":"/reference/tools/request-spending-grant","pageMetadata":{"title":"request_spending_grant","description":"Create a pending, bounded Privy spending grant for a hosted wallet.","href":"/reference/tools/request-spending-grant"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Create a pending, bounded Privy spending grant for a hosted wallet.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={br:`br`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Surface:`}),` Hosted OAuth`,_jsx(_components.br,{}),`\n`,_jsx(_components.strong,{children:`Mutates state:`}),` Creates a pending grant`,_jsx(_components.br,{}),`\n`,_jsx(_components.strong,{children:`Idempotency:`}),` Stable `,_jsx(_components.code,{children:`request_id`}),_jsx(_components.br,{}),`\n`,_jsx(_components.strong,{children:`Confirmation:`}),` `,_jsx(_components.code,{children:`confirmed_by_user=true`}),` after reviewing scope and limits`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"stable grant-request ID\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"asset_and_chain_scope\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"per_transaction_limit_atomic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"1000000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rolling_limit_atomic\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5000000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rolling_window_seconds\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`86400`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"confirmed_by_user\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`The grant has no spending authority until the owner activates it through the\nattached card. Show the raw activation URL only when requested or when the\ncard is unavailable.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"request_spending_grant","description":"Create a pending, bounded Privy spending grant for a hosted wallet.","href":"/reference/tools/request-spending-grant"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"subdomain":"agent-bank-5c587c2b","siteName":"AgentBank","title":"request_spending_grant - AgentBank","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-20T03:43:20.458Z","originalFileLocation":"reference/tools/request-spending-grant.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a pending, bounded Privy spending grant for a hosted wallet.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AgentBank\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"request_spending_grant - AgentBank\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a pending, bounded Privy spending grant for a hosted wallet.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AgentBank\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.useagentbank.com/reference/tools/request-spending-grant\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://agent-bank-5c587c2b.mintlify.site/_mintlify/api/og/v2?division=Hosted+OAuth+tools\u0026amp;title=request_spending_grant\u0026amp;description=Create+a+pending%2C+bounded+Privy+spending+grant+for+a+hosted+wallet.\u0026amp;theme=369c423be40813991ab38bcc\u0026amp;signature=f361d2c9beee0c1a78ddb921431e829c5c67f2ddb2285040038dc2faca480c50\">\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=\"request_spending_grant - AgentBank\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a pending, bounded Privy spending grant for a hosted wallet.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://agent-bank-5c587c2b.mintlify.site/_mintlify/api/og/v2?division=Hosted+OAuth+tools\u0026amp;title=request_spending_grant\u0026amp;description=Create+a+pending%2C+bounded+Privy+spending+grant+for+a+hosted+wallet.\u0026amp;theme=369c423be40813991ab38bcc\u0026amp;signature=f361d2c9beee0c1a78ddb921431e829c5c67f2ddb2285040038dc2faca480c50\">\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/agent-bank-5c587c2b/wWRZjzL4rbjV_01J/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AgentBank\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0062FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.useagentbank.com/reference/tools/request-spending-grant\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/tools/request-spending-grant.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.useagentbank.com/#organization\",\"name\":\"AgentBank\",\"url\":\"https://docs.useagentbank.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/agent-bank-5c587c2b/L0nehGwUBEbme6M7/logo/agentbank-wordmark-light.png?fit=max\u0026auto=format\u0026n=L0nehGwUBEbme6M7\u0026q=85\u0026s=eefd492c10a757d95ca2f5d1cab995d1\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.useagentbank.com#website\",\"name\":\"AgentBank\",\"url\":\"https://docs.useagentbank.com\",\"publisher\":{\"@id\":\"https://docs.useagentbank.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant#webpage\",\"url\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant\",\"name\":\"request_spending_grant\",\"description\":\"Create a pending, bounded Privy spending grant for a hosted wallet.\",\"dateModified\":\"2026-09-20T03:43:20.458Z\",\"isPartOf\":{\"@id\":\"https://docs.useagentbank.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tool reference\",\"item\":\"https://docs.useagentbank.com/reference/tools/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Hosted OAuth tools\",\"item\":\"https://docs.useagentbank.com/reference/tools/show-payment-approval\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"request_spending_grant\",\"item\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant#article\",\"headline\":\"request_spending_grant\",\"name\":\"request_spending_grant\",\"description\":\"Create a pending, bounded Privy spending grant for a hosted wallet.\",\"url\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant\",\"mainEntityOfPage\":{\"@id\":\"https://docs.useagentbank.com/reference/tools/request-spending-grant#webpage\"},\"dateModified\":\"2026-09-20T03:43:20.458Z\",\"publisher\":{\"@id\":\"https://docs.useagentbank.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.useagentbank.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"AgentBank\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"AgentBank\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/reference/tools/request-spending-grant.md","siteName":"AgentBank","nav":{"global":null,"tabs":[{"tab":"AgentBank","icon":"robot","pages":[{"title":"AgentBank","href":""}]},{"tab":"MCP reference","icon":"terminal","groups":[{"group":"Overview","pages":[{"title":"MCP overview","href":"/reference/mcp-overview"},{"title":"Core concepts","href":"/introduction/core-concepts"},{"title":"Architecture","href":"/introduction/architecture"}]},{"group":"Setup and configuration","pages":[{"title":"MCP configuration","href":"/reference/configuration"},{"title":"Local authorization flow","href":"/getting-started/authentication"},{"title":"MCP resources and prompt","href":"/reference/resources"},{"title":"Scopes","href":"/reference/scopes"},{"title":"Local approval policy","href":"/reference/approval-policy"}]},{"group":"Tool reference","pages":[{"title":"Tool overview","href":"/reference/tools/overview"},{"group":"Setup and identity tools","pages":[{"title":"begin_agent_onboarding","href":"/reference/tools/begin-agent-onboarding"},{"title":"wait_for_agent_onboarding","href":"/reference/tools/wait-for-agent-onboarding"},{"title":"get_installation_status","href":"/reference/tools/get-installation-status"},{"title":"relogin","href":"/reference/tools/relogin"},{"title":"revoke_agent","href":"/reference/tools/revoke-agent"},{"title":"whoami","href":"/reference/tools/whoami"},{"title":"check_verification_status","href":"/reference/tools/check-verification-status"},{"title":"do_kyc","href":"/reference/tools/do-kyc"},{"title":"get_verification_guidance","href":"/reference/tools/get-verification-guidance"},{"title":"check_my_scopes","href":"/reference/tools/check-my-scopes"}]},{"group":"Currency and quote tools","pages":[{"title":"list_currencies","href":"/reference/tools/list-currencies"},{"title":"get_supported_payment_capabilities","href":"/reference/tools/get-supported-payment-capabilities"},{"title":"list_quote_book_pairs","href":"/reference/tools/list-quote-book-pairs"},{"title":"browse_quote_book","href":"/reference/tools/browse-quote-book"}]},{"group":"Payment tools","pages":[{"title":"get_instructions","href":"/reference/tools/get-instructions"},{"title":"get_account_status","href":"/reference/tools/get-account-status"},{"title":"estimate_payment","href":"/reference/tools/estimate-payment"},{"title":"create_payment","href":"/reference/tools/create-payment"},{"title":"continue_payment","href":"/reference/tools/continue-payment"},{"title":"get_payment","href":"/reference/tools/get-payment"},{"title":"list_payments","href":"/reference/tools/list-payments"},{"title":"cancel_payment","href":"/reference/tools/cancel-payment"},{"title":"correct_payment_recipient","href":"/reference/tools/correct-payment-recipient"}]},{"group":"Payment plan tools","pages":[{"title":"create_payment_plan","href":"/reference/tools/create-payment-plan"},{"title":"review_payment_plan","href":"/reference/tools/review-payment-plan"},{"title":"list_payment_plans","href":"/reference/tools/list-payment-plans"},{"title":"submit_payment_plan","href":"/reference/tools/submit-payment-plan"},{"title":"cancel_payment_plan","href":"/reference/tools/cancel-payment-plan"}]},{"group":"x402 tools","pages":[{"title":"estimate_x402_outbound_payment","href":"/reference/tools/estimate-x402-outbound-payment"},{"title":"confirm_x402_outbound_payment","href":"/reference/tools/confirm-x402-outbound-payment"},{"title":"get_x402_outbound_payment","href":"/reference/tools/get-x402-outbound-payment"},{"title":"list_x402_outbound_payments","href":"/reference/tools/list-x402-outbound-payments"}]},{"group":"Hosted OAuth tools","pages":[{"title":"show_payment_approval","href":"/reference/tools/show-payment-approval"},{"title":"get_payment_instruction","href":"/reference/tools/get-payment-instruction"},{"title":"show_payment_progress","href":"/reference/tools/show-payment-progress"},{"title":"list_spending_grants","href":"/reference/tools/list-spending-grants"},{"title":"get_spending_grant","href":"/reference/tools/get-spending-grant"},{"title":"show_spending_grant","description":"Display the activation or status card for one selected spending grant.","href":"/reference/tools/show-spending-grant"},{"title":"request_spending_grant","href":"/reference/tools/request-spending-grant"},{"title":"fund_payment_with_grant","description":"Fund the current hosted crypto-deposit instruction with an active compatible grant.","href":"/reference/tools/fund-payment-with-grant"}]},{"group":"Recipient tools","pages":[{"title":"get_supported_bank_names","href":"/reference/tools/get-supported-bank-names"},{"title":"list_recipients","href":"/reference/tools/list-recipients"},{"title":"get_recipient","href":"/reference/tools/get-recipient"},{"title":"create_recipient","href":"/reference/tools/create-recipient"},{"title":"update_recipient","href":"/reference/tools/update-recipient"}]},{"group":"Wallet and EVM tools","pages":[{"title":"list_wallets","href":"/reference/tools/list-wallets"},{"title":"verify_agent_kit","href":"/reference/tools/verify-agent-kit"},{"title":"get_wallet_balances","href":"/reference/tools/get-wallet-balances"},{"title":"get_token_allowance","href":"/reference/tools/get-token-allowance"},{"title":"approve_token","href":"/reference/tools/approve-token"},{"title":"execute_payment_instruction","href":"/reference/tools/execute-payment-instruction"},{"title":"get_transaction_receipt","href":"/reference/tools/get-transaction-receipt"}]}]},{"group":"Agent guides","pages":[{"title":"Instructions for your agent","href":"/ai-guides/instructions-for-your-agent"},{"title":"Payment decision guide","href":"/ai-guides/payment-decision-guide"},{"title":"Confirmation and authorization rules","href":"/ai-guides/confirmation-rules"},{"title":"Recipient rules","href":"/ai-guides/recipient-rules"},{"title":"Routing strategy","href":"/ai-guides/routing-strategy"},{"title":"Safety and recovery","href":"/ai-guides/safety-and-recovery"}]},{"group":"Advanced","pages":[{"title":"x402 outbound payments","href":"/payments/x402-payments"},{"title":"Payment statuses","href":"/reference/statuses"},{"title":"Idempotency and request IDs","href":"/reference/idempotency"},{"title":"Limitations","href":"/reference/limitations"}]},{"group":"Troubleshooting","pages":[{"title":"MCP troubleshooting","href":"/reference/troubleshooting"},{"title":"Errors and reason codes","href":"/reference/errors"}]}]},{"tab":"Partner API","icon":"code","pages":[{"title":"Partner API","href":"/partner-api"}]}]},"basePath":"","title":"request_spending_grant - AgentBank","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}