Skip to Content
LandedFXDocs
API referenceVaults

Build a deposit, withdrawal or redemption to sign

POST
/api/v1/vaults/{id}/transactions

Returns ready-to-sign calls, simulated first. Smart wallets and EIP-5792 wallets send them as one batch, so the user confirms once; plain wallets can sign the returned permit instead. LandedFX never holds keys or funds. No API key needed; sending one attributes the volume to you.

Path Parameters

id*string

Request Body

application/json
  1. body
action*string

withdraw takes an asset amount; redeem takes shares.

Value in"deposit""withdraw""redeem"
account*string

The wallet that signs: the depositor, or the share owner when withdrawing.

amount*string

A decimal amount: USDC for deposit and withdraw, shares for redeem. "max" withdraws or redeems everything available.

receiver?string

Who receives the shares (deposit) or the USDC (withdraw, redeem). Defaults to account.

Response Body

The call would fail on-chain; the message says why

application/json
  1. response
code*number

HTTP status code

message*string

Human-readable message

data?

Response payload

metadata?
errors?array<string>

Validation errors, when the request was rejected

Example Request
curl -X POST 'https://api.landedfx.com/api/v1/vaults/string/transactions' \  -H 'Content-Type: application/json' \  -d '{  "action": "deposit",  "account": "0x70997970C51812dc3A010C7d01b50e0d17dc79C8",  "amount": "1000"}'
Example Response422
{  "data": {},  "metadata": {    "page": 1,    "limit": 20,    "totalDocs": 42,    "prevPage": null,    "nextPage": 2,    "totalPages": 3  },  "errors": [    "string"  ],  "code": 422,  "message": "The call would fail on-chain; the message says why"}

Deposit from any token on any chain POST

Pay with USDT on Tron or Ethereum, USDC on Solana or Arbitrum, ETH and more. Returns the steps to sign on the origin chain: they swap, bridge and deposit exactly `amount` USDC into the vault in one go, with Relay paying gas on Base.

Changelog

What's new in the LandedFX API.