YieldCreateEnterAction

YieldCreateEnterAction generates unsigned deposit transaction calldata for a yield market.

curl --request POST \
  --url https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction \
  --header 'Content-Type: application/json' \
  --data '
{
  "earnMarketId": "<string>",
  "userWalletAddress": "<string>",
  "args": {}
}
'

import requests

url = "https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction"

payload = {
    "earnMarketId": "<string>",
    "userWalletAddress": "<string>",
    "args": {}
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({earnMarketId: '<string>', userWalletAddress: '<string>', args: {}})
};

fetch('https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction', 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://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction",
  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([
    'earnMarketId' => '<string>',
    'userWalletAddress' => '<string>',
    'args' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction"

	payload := strings.NewReader("{\n  \"earnMarketId\": \"<string>\",\n  \"userWalletAddress\": \"<string>\",\n  \"args\": {}\n}")

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

	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://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction")
  .header("Content-Type", "application/json")
  .body("{\n  \"earnMarketId\": \"<string>\",\n  \"userWalletAddress\": \"<string>\",\n  \"args\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"earnMarketId\": \"<string>\",\n  \"userWalletAddress\": \"<string>\",\n  \"args\": {}\n}"

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

{
  "payload": {}
}

{
  "error": "WebrpcEndpoint",
  "code": 0,
  "msg": "endpoint error",
  "status": 400,
  "cause": "<string>"
}

{
  "error": "WebrpcBadResponse",
  "code": -5,
  "msg": "bad response",
  "status": 500,
  "cause": "<string>"
}

POST

rpc

Trails

YieldCreateEnterAction

YieldCreateEnterAction generates unsigned deposit transaction calldata for a yield market.

curl --request POST \
  --url https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction \
  --header 'Content-Type: application/json' \
  --data '
{
  "earnMarketId": "<string>",
  "userWalletAddress": "<string>",
  "args": {}
}
'

import requests

url = "https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction"

payload = {
    "earnMarketId": "<string>",
    "userWalletAddress": "<string>",
    "args": {}
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({earnMarketId: '<string>', userWalletAddress: '<string>', args: {}})
};

fetch('https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction', 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://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction",
  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([
    'earnMarketId' => '<string>',
    'userWalletAddress' => '<string>',
    'args' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$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://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction"

	payload := strings.NewReader("{\n  \"earnMarketId\": \"<string>\",\n  \"userWalletAddress\": \"<string>\",\n  \"args\": {}\n}")

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

	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://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction")
  .header("Content-Type", "application/json")
  .body("{\n  \"earnMarketId\": \"<string>\",\n  \"userWalletAddress\": \"<string>\",\n  \"args\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction")

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

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"earnMarketId\": \"<string>\",\n  \"userWalletAddress\": \"<string>\",\n  \"args\": {}\n}"

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

{
  "payload": {}
}

{
  "error": "WebrpcEndpoint",
  "code": 0,
  "msg": "endpoint error",
  "status": 400,
  "cause": "<string>"
}

{
  "error": "WebrpcBadResponse",
  "code": -5,
  "msg": "bad response",
  "status": 500,
  "cause": "<string>"
}

Overview

YieldCreateEnterAction returns the unsigned transaction payload needed to deposit into a DeFi yield market. This is the low-level endpoint that backs the lend and deposit composable actions in the SDK. Use this endpoint when building custom DeFi UIs outside React, or when you need to construct the calldata manually before passing it to Trails via the to.calldata param on QuoteIntent. For React apps, use the lend() or deposit() action builders with useTrailsSendTransaction — they call this endpoint internally.

Request Parameters

Field	Type	Required	Description
`earnMarketId`	string	Yes	Market ID from `YieldGetMarkets`
`userWalletAddress`	string	Yes	Address of the depositing wallet
`args`	object	No	Market-specific arguments (varies by protocol)

Response

Returns payload containing unsigned transaction data:

Field	Description
`transactions`	Array of transaction objects to execute
`transactions[].to`	Contract address
`transactions[].data`	ABI-encoded calldata
`transactions[].value`	ETH value (for native token deposits)

Examples

Build a deposit calldata for Aave

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_ACCESS_KEY',
  },
  body: JSON.stringify({
    earnMarketId: 'base-usdc-aave-v3-lending',
    userWalletAddress: '0xYourWalletAddress',
  }),
})

const { payload } = await response.json()
const action = JSON.parse(payload)

// Pass action.transactions[0].data to QuoteIntent as to.calldata

With protocol-specific arguments

Some markets accept additional arguments (e.g. slippage, referral codes):

const response = await fetch('https://trails-api.sequence.app/rpc/Trails/YieldCreateEnterAction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-Access-Key': 'YOUR_ACCESS_KEY',
  },
  body: JSON.stringify({
    earnMarketId: 'ethereum-usdc-morpho-0x...',
    userWalletAddress: '0xYourWalletAddress',
    args: {
      referralCode: 0,
    },
  }),
})

SDK alternative

For React, use the lend or deposit builders with useTrailsSendTransaction:

import { useTrailsSendTransaction, lend, deposit } from '0xtrails'

const { sendTransaction } = useTrailsSendTransaction({
  actions: [
    lend({ marketId: 'base-usdc-aave-v3-lending', amount: '100' }),
  ],
})

See Composable Actions for the full SDK approach.

Overview

Intents

Routes & Tokens

Chains & Discovery

Earn

Intents (Advanced)

YieldCreateEnterAction

Overview

Request Parameters

Response

Examples

Build a deposit calldata for Aave

With protocol-specific arguments

SDK alternative

See also

Body

Response

​Overview

​Request Parameters

​Response

​Examples

​Build a deposit calldata for Aave

​With protocol-specific arguments

​SDK alternative

​See also

Body

Response

Overview

Request Parameters

Response

Examples

Build a deposit calldata for Aave

With protocol-specific arguments

SDK alternative

See also