Withdraw Onchain

Withdraw your Cashramp balance to an external wallet as a supported stablecoin.

Create the Withdrawal

mutation {
  withdrawOnchain(
    address: "0xc8802fEaB2FaFb48B7d1aDe77e197002c210f391"
    amountUsd: 200
    network: "BASE"
    symbol: "USDC"
    metadata: { payoutId: "payout_123" }
  ) {
    id # Track this ID or wait for the webhook (see below)
    quantity
    symbol
    network
    fee
    status
  }
}

Arguments

Name	Type	Required	Description
address	String!	Yes	Destination wallet address. It must be valid for the selected network.
amountUsd	Decimal!	Yes	USD amount to withdraw. The minimum, maximum, and network fee depend on the selected stablecoin-network pair.
network	String	No	Destination network code. Defaults to OP.
symbol	String	No	Stablecoin to send. Defaults to USDT.
metadata	JSON	No	Your own key-value data for reconciliation. Cashramp includes it in onchain_tx.updated webhooks.
travelRuleInfo	TravelRuleInfoInput	No	Destination ownership information. It contains selfOwned, beneficiaryName, and vaspName.

Supported Networks

Network	Code	Supported stablecoins	Network fee
Optimism	OP	USDT, USDC	$1.00
Celo	CELO	USDT, USDC, CUSD	$0.50
Base	BASE	USDC	$0.10
Polygon	MATIC	USDC	$0.50
Binance Smart Chain	BSC	USDT, USDC	$0.50
Solana	SOL	USDT, USDC	$1.00

symbol and network are validated together. Specify both when you do not want the default USDT on OP route. Fees and withdrawal limits vary by pair; the transaction response includes the applied fee.

The mutation fails if:

• The stablecoin or stablecoin-network pair is unsupported.

• address is invalid on the selected network.

• amountUsd is outside the selected pair's withdrawal limits.

• Your Cashramp balance cannot cover amountUsd plus the returned fee.

---

Receive Status Updates

You’ll get a onchain_tx.updated webhook as the transaction progresses.

{
  "event_type": "onchain_tx.updated",
  "data": {
    "id": "VHlwZXM6Ok9uY2hhaW5UeC1hYzNmODk2Mi1jNzRkLTRmNWMtYTQ5ZC1kYmIzMWM1MDc5Mzc=",
    "address": "0xc8802fEaB2FaFb48B7d1aDe77e197002c210f391",
    "status": "completed",
    "quantity": 200,
    "fee": 0.1,
    "symbol": "USDC",
    "network": "BASE",
    "txhash": "0x8e473aa19bcb2ce3107fc16b88effda50a21d6853a7db67e357abf312c26eaf7",
    "metadata": {
      "payoutId": "payout_123"
    }
  }
}

The withdrawal status is pending, processing, completed, failed, or canceled. Use the webhook (or poll onchainWithdrawal(id)) to confirm finality before updating your ledger.