Developer guide for embedding the AgentPMT hosted crypto on-off-ramp widget with branding, prefills, theme options, and production-ready iframe examples.
Use the AgentPMT hosted crypto on-off-ramp widget when you want users to buy or sell crypto directly from your site.
https://www.agentpmt.com/embed/crypto-on-off-ramp
Paste this iframe into your site:
<iframe
src="https://www.agentpmt.com/embed/crypto-on-off-ramp"
title="AgentPMT Crypto On-Off-Ramp Widget"
style="width:100%;max-width:440px;height:760px;border:0;border-radius:24px;overflow:hidden"
allow="payment; clipboard-write"
loading="lazy"
></iframe>Recommended size:
100%440px760px minimum, 1000px if you want the widget visible without scrolling after the user clicks NextUse this when you are embedding the widget directly into a static site or a server-rendered page.
<iframe
src="https://www.agentpmt.com/embed/crypto-on-off-ramp"
title="AgentPMT Crypto On-Off-Ramp Widget"
style="width:100%;max-width:440px;height:760px;border:0;border-radius:24px;overflow:hidden"
allow="payment; clipboard-write"
loading="lazy"
></iframe>Use this when you want to render the widget from a React component.
export function FundsWidget() {
const src =
"https://www.agentpmt.com/embed/crypto-on-off-ramp?theme=dark&crypto=USDC&chain=base";
return (
<iframe
src={src}
title="AgentPMT Crypto On-Off-Ramp Widget"
style={{
width: "100%",
maxWidth: "440px",
height: "760px",
border: 0,
borderRadius: "24px",
overflow: "hidden",
}}
allow="payment; clipboard-write"
loading="lazy"
/>
);
}Add an Embed block and paste this:
<div style="width:100%;display:flex;justify-content:center;">
<iframe
src="https://www.agentpmt.com/embed/crypto-on-off-ramp?theme=light"
title="AgentPMT Crypto On-Off-Ramp Widget"
style="width:100%;max-width:440px;height:760px;border:0;border-radius:24px;overflow:hidden"
allow="payment; clipboard-write"
loading="lazy"
></iframe>
</div>Add a Custom HTML block and paste this:
<iframe
src="https://www.agentpmt.com/embed/crypto-on-off-ramp?theme=light&crypto=USDC&chain=base"
title="AgentPMT Crypto On-Off-Ramp Widget"
style="width:100%;max-width:440px;height:760px;border:0;border-radius:24px;overflow:hidden"
allow="payment; clipboard-write"
loading="lazy"
></iframe>Example configuration:
{
"theme": "dark",
"walletAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"email": "ops@example.com",
"crypto": "ETH",
"chain": "arbitrum",
"title": "Manage Your Funds",
"subtitle": "Deposit and Withdraw Cryptocurrency From Your Wallet"
}Available parameters:
theme
Example: theme=dark
Allowed values: light, dark
Controls light mode or dark mode.
walletAddress
Example: walletAddress=0x71C7656EC7ab88b098defB751B7401B5f6d8976F
Prefills the wallet address.
wallet
Example: wallet=0x71C7656EC7ab88b098defB751B7401B5f6d8976F
Alias for walletAddress.
email
Example: email=ops@example.com
Prefills the email address.
crypto
Example: crypto=ETH
Sets the starting cryptocurrency.
chain
Example: chain=arbitrum
Sets the starting chain.
Supported values: base, ethereum, arbitrum, optimism, polygon
title
Example: title=Manage%20Treasury
Replaces the default heading.
subtitle
Example: subtitle=Deposit%20and%20Withdraw%20Cryptocurrency%20From%20Your%20Wallet
Replaces the default subheading.
https://www.agentpmt.com/embed/crypto-on-off-ramp?theme=lighthttps://www.agentpmt.com/embed/crypto-on-off-ramp?theme=darkhttps://www.agentpmt.com/embed/crypto-on-off-ramp?walletAddress=0x71C7656EC7ab88b098defB751B7401B5f6d8976F&email=ops%40example.comhttps://www.agentpmt.com/embed/crypto-on-off-ramp?crypto=ETH&chain=ethereumhttps://www.agentpmt.com/embed/crypto-on-off-ramp?crypto=USDC&chain=base<iframe
src="https://www.agentpmt.com/embed/crypto-on-off-ramp?theme=dark&walletAddress=0x71C7656EC7ab88b098defB751B7401B5f6d8976F&email=ops%40example.com&crypto=ETH&chain=arbitrum&title=Manage%20Your%20Funds&subtitle=Deposit%20and%20Withdraw%20Cryptocurrency%20From%20Your%20Wallet"
title="AgentPMT Crypto On-Off-Ramp Widget"
style="width:100%;max-width:440px;height:760px;border:0;border-radius:24px;overflow:hidden"
allow="payment; clipboard-write"
loading="lazy"
></iframe>If your platform only wants a URL, or if you want to open the widget in its own tab, use the full standalone widget URL:
https://www.agentpmt.com/embed/crypto-on-off-ramp?theme=dark&walletAddress=0x71C7656EC7ab88b098defB751B7401B5f6d8976F&email=ops%40example.com&crypto=ETH&chain=arbitrum&title=Manage%20Your%20Funds&subtitle=Deposit%20and%20Withdraw%20Cryptocurrency%20From%20Your%20WalletUsers first see the AgentPMT setup screen. After they click Next, the widget opens.
USD and card paymentPoint your iframe src to https://www.agentpmt.com/embed/crypto-on-off-ramp.
Add theme, walletAddress, email, crypto, chain, title, or subtitle if needed.
Use at least 760px of height. For the full widget to display without scrolling after the user clicks Next, use 1000px.
Open the exact production iframe URL you plan to ship and test both buy and sell.
<iframe
src="https://www.agentpmt.com/embed/crypto-on-off-ramp?theme=light&crypto=USDC&chain=base"
title="AgentPMT Funds Widget"
style="width:100%;max-width:440px;height:760px;border:0;border-radius:24px;overflow:hidden"
allow="payment; clipboard-write"
loading="lazy"
></iframe>