curl --request POST \
--url https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"marketId": "morpho-v2-base-steakhouse-usdc",
"amount": "10",
"urgency": "urgent",
"chainId": 8453
}
'import requests
url = "https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits"
payload = {
"marketId": "morpho-v2-base-steakhouse-usdc",
"amount": "10",
"urgency": "urgent",
"chainId": 8453
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-API-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
marketId: 'morpho-v2-base-steakhouse-usdc',
amount: '10',
urgency: 'urgent',
chainId: 8453
})
};
fetch('https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits', 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.beta.getpara.com/v1/wallets/{walletId}/yield/deposits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'marketId' => 'morpho-v2-base-steakhouse-usdc',
'amount' => '10',
'urgency' => 'urgent',
'chainId' => 8453
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits"
payload := strings.NewReader("{\n \"marketId\": \"morpho-v2-base-steakhouse-usdc\",\n \"amount\": \"10\",\n \"urgency\": \"urgent\",\n \"chainId\": 8453\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits")
.header("Idempotency-Key", "<idempotency-key>")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"marketId\": \"morpho-v2-base-steakhouse-usdc\",\n \"amount\": \"10\",\n \"urgency\": \"urgent\",\n \"chainId\": 8453\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"marketId\": \"morpho-v2-base-steakhouse-usdc\",\n \"amount\": \"10\",\n \"urgency\": \"urgent\",\n \"chainId\": 8453\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chainId": 8453,
"marketId": "morpho-v2-base-steakhouse-usdc",
"source": "aave-v3",
"action": "deposit",
"amount": "10.0",
"status": "pending",
"transactions": [
{
"phase": "approval",
"hash": "<string>",
"nonce": 1,
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "signed",
"blockNumber": 123,
"blockHash": "<string>"
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"autoRetry": {
"expiresAt": "2023-11-07T05:31:56Z",
"action": {
"maxExecutionFeeWei": "<string>"
},
"phases": [
{
"state": "active",
"nonce": 1,
"maxExecutionFeeWei": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"bumpCount": 1,
"attempts": [
{
"ordinal": 1,
"stage": "prepared",
"preparedAt": "2023-11-07T05:31:56Z",
"hash": "<string>",
"lastBroadcastAt": "2023-11-07T05:31:56Z",
"lastValidBlockHeight": 123
}
],
"phase": "approval",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reason": "<string>",
"network": "SOLANA",
"maxExecutionFeeLamports": "<string>",
"latestAttemptHash": "<string>"
}
],
"approval": {
"maxExecutionFeeWei": "<string>"
}
},
"error": {
"code": "<string>",
"message": "<string>",
"reviewId": "<string>"
}
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chainId": 8453,
"marketId": "morpho-v2-base-steakhouse-usdc",
"source": "aave-v3",
"action": "deposit",
"amount": "10.0",
"status": "pending",
"transactions": [
{
"phase": "approval",
"hash": "<string>",
"nonce": 1,
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "signed",
"blockNumber": 123,
"blockHash": "<string>"
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"autoRetry": {
"expiresAt": "2023-11-07T05:31:56Z",
"action": {
"maxExecutionFeeWei": "<string>"
},
"phases": [
{
"state": "active",
"nonce": 1,
"maxExecutionFeeWei": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"bumpCount": 1,
"attempts": [
{
"ordinal": 1,
"stage": "prepared",
"preparedAt": "2023-11-07T05:31:56Z",
"hash": "<string>",
"lastBroadcastAt": "2023-11-07T05:31:56Z",
"lastValidBlockHeight": 123
}
],
"phase": "approval",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reason": "<string>",
"network": "SOLANA",
"maxExecutionFeeLamports": "<string>",
"latestAttemptHash": "<string>"
}
],
"approval": {
"maxExecutionFeeWei": "<string>"
}
},
"error": {
"code": "<string>",
"message": "<string>",
"reviewId": "<string>"
}
}{
"code": "INVALID_REQUEST",
"message": "type must be one of EVM, SOLANA, COSMOS, STELLAR, SUI"
}{
"code": "UNAUTHORIZED",
"message": "secret api key not provided"
}{
"code": "FORBIDDEN",
"message": "invalid secret api key"
}{
"code": "NOT_FOUND",
"message": "wallet not found"
}{
"code": "INVALID_REQUEST",
"message": "<string>",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"failureStage": "mpc_sign",
"failureCode": "<string>",
"signedTransaction": "<string>"
}{
"code": "RATE_LIMITED",
"message": "Rate limit exceeded, try again shortly."
}{
"code": "INTERNAL_ERROR",
"message": "Internal Server Error"
}Deposit
Deposit USDC into the selected market and return an operation to track its progress.
Optional autoRetry reuses shared same-nonce recovery per existing phase, with separately authorized approval/action execution-gas ceilings and one original operation deadline. Action authorization is required; a needed approval requires an explicit approval ceiling. Include an approval ceiling on deposits unless existing allowance is known to cover the amount; withdrawals never prepare an approval transaction. Fees rise by at least 12.5%, rounded up, at least 60 seconds after the last EVM broadcast, using fresh higher estimates when affordable. No fixed retry count or fresh-nonce replay. Every attempt checks current authority, policy and same-transaction accounting; incompatible accounting fails closed before signing. An initial review does not authorize changed fees or guarantee that an approved spend overage can be reused. Replacements reuse phase principal accounting, while a later action is separately evaluated. Approval must confirm before action signing. If authorization expires between phases, confirmed approval progress remains visible and the unsigned action does not execute. Potentially submitted attempts remain monitored.
curl --request POST \
--url https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"marketId": "morpho-v2-base-steakhouse-usdc",
"amount": "10",
"urgency": "urgent",
"chainId": 8453
}
'import requests
url = "https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits"
payload = {
"marketId": "morpho-v2-base-steakhouse-usdc",
"amount": "10",
"urgency": "urgent",
"chainId": 8453
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-API-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
marketId: 'morpho-v2-base-steakhouse-usdc',
amount: '10',
urgency: 'urgent',
chainId: 8453
})
};
fetch('https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits', 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.beta.getpara.com/v1/wallets/{walletId}/yield/deposits",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'marketId' => 'morpho-v2-base-steakhouse-usdc',
'amount' => '10',
'urgency' => 'urgent',
'chainId' => 8453
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits"
payload := strings.NewReader("{\n \"marketId\": \"morpho-v2-base-steakhouse-usdc\",\n \"amount\": \"10\",\n \"urgency\": \"urgent\",\n \"chainId\": 8453\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits")
.header("Idempotency-Key", "<idempotency-key>")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"marketId\": \"morpho-v2-base-steakhouse-usdc\",\n \"amount\": \"10\",\n \"urgency\": \"urgent\",\n \"chainId\": 8453\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.beta.getpara.com/v1/wallets/{walletId}/yield/deposits")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"marketId\": \"morpho-v2-base-steakhouse-usdc\",\n \"amount\": \"10\",\n \"urgency\": \"urgent\",\n \"chainId\": 8453\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chainId": 8453,
"marketId": "morpho-v2-base-steakhouse-usdc",
"source": "aave-v3",
"action": "deposit",
"amount": "10.0",
"status": "pending",
"transactions": [
{
"phase": "approval",
"hash": "<string>",
"nonce": 1,
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "signed",
"blockNumber": 123,
"blockHash": "<string>"
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"autoRetry": {
"expiresAt": "2023-11-07T05:31:56Z",
"action": {
"maxExecutionFeeWei": "<string>"
},
"phases": [
{
"state": "active",
"nonce": 1,
"maxExecutionFeeWei": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"bumpCount": 1,
"attempts": [
{
"ordinal": 1,
"stage": "prepared",
"preparedAt": "2023-11-07T05:31:56Z",
"hash": "<string>",
"lastBroadcastAt": "2023-11-07T05:31:56Z",
"lastValidBlockHeight": 123
}
],
"phase": "approval",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reason": "<string>",
"network": "SOLANA",
"maxExecutionFeeLamports": "<string>",
"latestAttemptHash": "<string>"
}
],
"approval": {
"maxExecutionFeeWei": "<string>"
}
},
"error": {
"code": "<string>",
"message": "<string>",
"reviewId": "<string>"
}
}{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"walletId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"chainId": 8453,
"marketId": "morpho-v2-base-steakhouse-usdc",
"source": "aave-v3",
"action": "deposit",
"amount": "10.0",
"status": "pending",
"transactions": [
{
"phase": "approval",
"hash": "<string>",
"nonce": 1,
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "signed",
"blockNumber": 123,
"blockHash": "<string>"
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"autoRetry": {
"expiresAt": "2023-11-07T05:31:56Z",
"action": {
"maxExecutionFeeWei": "<string>"
},
"phases": [
{
"state": "active",
"nonce": 1,
"maxExecutionFeeWei": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"bumpCount": 1,
"attempts": [
{
"ordinal": 1,
"stage": "prepared",
"preparedAt": "2023-11-07T05:31:56Z",
"hash": "<string>",
"lastBroadcastAt": "2023-11-07T05:31:56Z",
"lastValidBlockHeight": 123
}
],
"phase": "approval",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"reason": "<string>",
"network": "SOLANA",
"maxExecutionFeeLamports": "<string>",
"latestAttemptHash": "<string>"
}
],
"approval": {
"maxExecutionFeeWei": "<string>"
}
},
"error": {
"code": "<string>",
"message": "<string>",
"reviewId": "<string>"
}
}{
"code": "INVALID_REQUEST",
"message": "type must be one of EVM, SOLANA, COSMOS, STELLAR, SUI"
}{
"code": "UNAUTHORIZED",
"message": "secret api key not provided"
}{
"code": "FORBIDDEN",
"message": "invalid secret api key"
}{
"code": "NOT_FOUND",
"message": "wallet not found"
}{
"code": "INVALID_REQUEST",
"message": "<string>",
"transactionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"failureStage": "mpc_sign",
"failureCode": "<string>",
"signedTransaction": "<string>"
}{
"code": "RATE_LIMITED",
"message": "Rate limit exceeded, try again shortly."
}{
"code": "INTERNAL_ERROR",
"message": "Internal Server Error"
}Authorizations
Your partner secret key (server-side only)
Headers
UUID for request tracing. Para returns one if omitted.
Required durable key scoped to your API partner across yield operations. Reuse the same key and normalized request to retrieve or explicitly retry its operation. A different wallet, chain, market, action, amount or retry authorization returns 409. Unlike generic POST idempotency, this key is retained with the operation rather than expiring after 24 hours.
1 - 256^[\x21-\x7e]+$Path Parameters
Wallet UUID. A malformed or inaccessible wallet ID returns 404.
"0a1b2c3d-4e5f-6789-abcd-ef0123456789"
Body
- Option 1
- Option 2
Market ID from the markets endpoint. Determines the chain and asset. Required if chainId is omitted. Without marketId, chainId selects Aave V3. Unsupported market IDs or a mismatched chainId return 400 before operation creation or signing. Additional request fields are rejected. Morpho supports morpho-v2-ethereum-steakhouse-usdc on Ethereum (1) and morpho-v2-base-steakhouse-usdc on Base (8453). The sandbox-only Morpho demo market is morpho-v2-base-sepolia-demo-usdc on Base Sepolia (84532); it holds test USDC idle and earns no lending yield.
"morpho-v2-base-steakhouse-usdc"
Positive USDC amount in decimal units, not base units. At most six decimal places; zero is rejected.
85^(0|[1-9]\d*)(\.\d{1,6})?$"10"
Preference for generated self-funded EVM prices. Urgent raises the normal tip by 25%, rounded up, and adds the delta to maxFeePerGas; for legacy, gasPrice rises by 25%, rounded up. Zero tips stay zero. Gas units are unchanged. Explicit initial prices, including zero, override this preference; an inconsistent resulting fee pair is rejected. New unsigned transactions use fresh recommendations. Durable transfers, manual recovery and yield retain the preference; omission and normal share the legacy request identity. Changing urgency under the same durable key conflicts. Prepared and signed bytes remain unchanged on replay. Replacements still honor their historical minimum bump and authorized ceiling, clamping preferred prices when a valid replacement fits. Urgent does not guarantee confirmation time. Unsupported for sponsored transfers, non-EVM execution and sign-transaction.
normal, urgent "urgent"
Optional when marketId is supplied; must match its chain. Without marketId, selects Aave V3 on this chain. Native USDC on Ethereum mainnet (1) or Base mainnet (8453), or Aave test USDC on Sepolia (11155111). Base Sepolia (84532) uses test USDC and is available only in sandbox and local test environments. Base uses native USDC, not USDbC. Mainnet chain IDs use real funds regardless of API environment.
1, 8453, 11155111, 84532 8453
Optional shared recovery for an existing Aave or Morpho deposit/withdrawal. action authorizes its own transaction; approval must be explicitly present before a needed approval can sign. Never copies or rolls unused phase authorization forward. Each phase uses the existing per-transaction execution-gas ceiling, not a cumulative operation budget. The initial transaction must fit its phase ceiling. Fees are wallet-paid. One original deadline applies across phases and idempotent replays. Changing authorization with the same key returns 409. A missing approval ceiling (AUTO_RETRY_PHASE_FEE_REQUIRED) or first transaction above its ceiling (RECOVERY_FEE_CAP_REACHED) stops the unsigned phase as requires_action. Same-key replay cannot fix it; cancel proven-unsigned work first, then create a new request with a new key and adequate ceilings. Uncertain or signed work cannot be cancelled this way. Omission preserves existing exact-byte recovery behavior.
Show child attributes
Show child attributes
Response
Existing terminal or paused operation.
1, 8453, 11155111, 84532 8453
"morpho-v2-base-steakhouse-usdc"
aave-v3, morpho-v2 deposit, withdraw Normalized decimal USDC amount, or all for withdrawals.
"10.0"
pending work automatically retries recognized temporary RPC failures before signing and waits for another yield operation on the same wallet. With autoRetry, submitted means a phase is admitted or being tracked; inspect its attempt stages rather than inferring that signing or broadcast succeeded. Ordinary submitted work has signed bytes stored even when RPC acceptance is uncertain. confirmed means the final action succeeded. With autoRetry, shared reconciliation requires two canonical confirmations and finalized-chain inclusion. Without autoRetry, two canonical confirmations suffice and do not establish finality. failed means an on-chain revert or a consumed nonce (NONCE_CONSUMED, or RECOVERY_NONCE_CONSUMED with autoRetry); it does not guarantee that no funds moved. requires_action needs an explicit retry after correcting the issue.
pending, submitted, confirmed, failed, requires_action, cancelled Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes