Skip to main content
POST
/
accounts
/
{account_id}
/
plan
/
transfer
Plan Transfer
curl --request POST \
  --url https://api.example.com/accounts/{account_id}/plan/transfer

Plan Transfer

Creates a plan to transfer assets from the sub-account’s wallet to another address. Returns a plan ID and EIP-712 digest for signing.

Request

POST /accounts/:account_id/plan/transfer

Body parameters

ParameterTypeRequiredDescription
amountstringYesAmount to transfer in the asset’s smallest unit
assetstringYesAsset symbol (e.g., "USDC")
networkstringYesTarget network for the transfer. Funds on other chains are bridged automatically.
recipientstringYesDestination Ethereum address (0x-prefixed)

Examples

curl -X POST https://prime-api.legend.xyz/accounts/acc_2o0yiljtp378/plan/transfer \
  -H "Authorization: Bearer $LEGEND_QUERY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1000000",
    "asset": "USDC",
    "network": "base",
    "recipient": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72"
  }'
Response (201 Created)
{
  "plan_id": "pln_t4r2x9v6j8s1",
  "details": {
    "quark_operation_actions": [...],
    "eip712_data": {
      "digest": "0x3c7a...e9d4"
    }
  },
  "expires_at": "2025-06-15T10:32:00Z"
}
The response format is identical to Plan Earn. Sign the digest and call Execute Plan to proceed.