Skip to main content
POST
/
accounts
/
{external_id}
/
plan
/
transfer
Plan Transfer
curl --request POST \
  --url https://api.example.com/accounts/{external_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/:external_id/plan/transfer

Body parameters

ParameterTypeRequiredDescription
amountstringYesAmount to transfer in the asset’s smallest unit
assetstringYesAsset symbol (e.g., "USDC")
networkstringYesNetwork to transfer on
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",
  "chart": {
    "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.