POST

accounts

{account_id}

plan

migrate

Plan Migrate

curl --request POST \
  --url https://api.example.com/accounts/{account_id}/plan/migrate

const options = {method: 'POST'};

fetch('https://api.example.com/accounts/{account_id}/plan/migrate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/accounts/{account_id}/plan/migrate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/accounts/{account_id}/plan/migrate"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/accounts/{account_id}/plan/migrate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Plan Migrate

Creates a plan to migrate a supply position from one DeFi protocol to another. This atomically withdraws from the source protocol and deposits into the destination protocol. Returns a plan ID and an EIP-712 digest that must be signed to authorize execution.

Request

POST /accounts/:account_id/plan/migrate

Path parameters

Parameter	Type	Description
`account_id`	string	The sub-account ID

Body parameters

Parameter	Type	Required	Description
`amount`	string	Yes	Amount to migrate in the asset’s smallest unit
`asset`	string	Yes	Asset to migrate (e.g., `"USDC"`)
`from_protocol`	string	Yes	Source protocol: `"compound"`, `"aave"`, or `"morpho_vault"`
`to_protocol`	string	Yes	Destination protocol: `"compound"`, `"aave"`, or `"morpho_vault"`
`network`	string	Yes	Target network (e.g., `"base"`, `"mainnet"`). Funds on other chains are bridged automatically.
`from_market`	string	No	Source market reference (required for `morpho_vault`)
`to_market`	string	No	Destination market reference (required for `morpho_vault`)
`migrate_only_supply_balances`	boolean	No	If `true`, only migrate supply balances (default: `false`)

Examples

Compound to Aave

curl -X POST https://prime-api.legend.xyz/accounts/acc_2o0yiljtp378/plan/migrate \
  -H "Authorization: Bearer $LEGEND_QUERY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1000000",
    "asset": "USDC",
    "from_protocol": "compound",
    "to_protocol": "aave",
    "network": "base"
  }'

const plan = await client.plan.migrate("acc_2o0yiljtp378", {
  amount: "1000000",
  asset: "USDC",
  fromProtocol: "compound",
  toProtocol: "aave",
  network: "base",
});

plan = await client.plan.migrate(
    "acc_2o0yiljtp378",
    amount="1000000",
    asset="USDC",
    from_protocol="compound",
    to_protocol="aave",
    network="base",
)

use legend_client::MigrateParams;

let plan = client.plan.migrate("acc_2o0yiljtp378", &MigrateParams {
    amount: "1000000".into(),
    asset: "USDC".into(),
    from_protocol: "compound".into(),
    to_protocol: "aave".into(),
    network: "base".into(),
    ..Default::default()
}).await?;

Aave to Morpho Vault

curl -X POST https://prime-api.legend.xyz/accounts/acc_2o0yiljtp378/plan/migrate \
  -H "Authorization: Bearer $LEGEND_QUERY_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1000000",
    "asset": "USDC",
    "from_protocol": "aave",
    "to_protocol": "morpho_vault",
    "to_market": "steakhouse-usdc",
    "network": "base"
  }'

const plan = await client.plan.migrate("acc_2o0yiljtp378", {
  amount: "1000000",
  asset: "USDC",
  fromProtocol: "aave",
  toProtocol: "morpho_vault",
  toMarket: "steakhouse-usdc",
  network: "base",
});

plan = await client.plan.migrate(
    "acc_2o0yiljtp378",
    amount="1000000",
    asset="USDC",
    from_protocol="aave",
    to_protocol="morpho_vault",
    to_market="steakhouse-usdc",
    network="base",
)

use legend_client::MigrateParams;

let plan = client.plan.migrate("acc_2o0yiljtp378", &MigrateParams {
    amount: "1000000".into(),
    asset: "USDC".into(),
    from_protocol: "aave".into(),
    to_protocol: "morpho_vault".into(),
    to_market: Some("steakhouse-usdc".into()),
    network: "base".into(),
    ..Default::default()
}).await?;

Response (201 Created)

{
  "plan_id": "pln_71mcui082png",
  "details": {
    "quark_operation_actions": [...],
    "eip712_data": {
      "digest": "0x8a3f...b7c2",
      "domain_separator": "0x...",
      "hash_struct": "0x..."
    }
  },
  "expires_at": "2025-06-15T10:32:00Z"
}

Response fields

Field	Type	Description
`plan_id`	string	Unique identifier for this plan (`pln_` prefix)
`details`	object	Transaction details including EIP-712 signing data
`details.eip712_data.digest`	string	The hash to sign with the account’s signer key
`expires_at`	string	ISO 8601 timestamp — plan must be executed before this time

Errors

Status	Code	Description
400	`invalid_params`	Missing required parameters, unsupported protocol, or missing market reference for morpho_vault
400	`plan_failed`	Could not generate a valid plan (e.g., insufficient balance in source)
400	`no_wallet`	Account has no wallets
408	`timeout`	Folio computation timed out

Notes

Plans expire after 2 minutes. Sign and execute via Execute Plan before expiry.
The withdrawal and deposit happen atomically in a single transaction.
When using morpho_vault as source or destination, you must provide the corresponding from_market or to_market parameter.
Set migrate_only_supply_balances to true to prevent migrating reward or other non-supply balances.

Plan Swap and SupplyCreate a plan to swap an asset and supply the result to a protocol

Plan Migrate

curl --request POST \
  --url https://api.example.com/accounts/{account_id}/plan/migrate

const options = {method: 'POST'};

fetch('https://api.example.com/accounts/{account_id}/plan/migrate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/accounts/{account_id}/plan/migrate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/accounts/{account_id}/plan/migrate"

	req, _ := http.NewRequest("POST", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/accounts/{account_id}/plan/migrate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)

response = http.request(request)
puts response.read_body

Getting Started

Guides

Concepts

Accounts

Portfolio

Plans

Activities & Events

Reference Data

SDKs

Agent Integration

MCP Server

Agent Guides

Plan Migrate

Plan Migrate

Request

Path parameters

Body parameters

Examples

Compound to Aave

Aave to Morpho Vault

Response fields

Errors

Notes

​Plan Migrate

​Request

​Path parameters

​Body parameters

​Examples

​Compound to Aave

​Aave to Morpho Vault

​Response fields

​Errors

​Notes

Plan Migrate

Request

Path parameters

Body parameters

Examples

Compound to Aave

Aave to Morpho Vault

Response fields

Errors

Notes