Skip to main content
POST
/
api
/
wallet
Wallet Operations
curl --request POST \
  --url https://unidexv4-api-production.up.railway.app/api/wallet \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "deposit",
  "tokenAddress": "<string>",
  "amount": "<string>"
}
'
{
  "calldata": "<string>",
  "vaultAddress": "<string>",
  "requiredGasFee": "<string>"
}

​
Overview

The Wallet Operations endpoint handles direct deposits and withdrawals of tokens on Arbitrum to your margin wallet. This endpoint is specifically for tokens already on the Arbitrum network - for cross-chain deposits, use the crosschaindeposit endpoint instead.

​
Request Body

​
type
string
required
Operation type. Must be either:
  • deposit: Deposit tokens into margin wallet
  • withdraw: Withdraw tokens from margin wallet
​
tokenAddress
string
required
Contract address of the token to deposit or withdraw. Currently supported tokens:
  • USDC: 0xaf88d065e77c8cc2239327c5edb3a432268e5831 (6 decimals)
​
amount
string
required
Amount to deposit or withdraw (in token units with decimals)

​
Response Fields

​
calldata
string
Encoded function call data for the transaction
​
vaultAddress
string
Address of the vault contract

​
Example Usage

​
Deposit USDC

curl -X POST "https://unidexv4-api-production.up.railway.app/api/wallet" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "deposit",
    "tokenAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
    "amount": "1000.00"
}'

​
Withdraw USDC

curl -X POST "https://unidexv4-api-production.up.railway.app/api/wallet" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "withdraw",
    "tokenAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
    "amount": "500.00"
}'

​
Example Response

{
  "calldata": "0x4d59524546455252414c434f4445000000000000000000000000000000000000",
  "vaultAddress": "0xe3ca135782e4a17aFb31a63ee3b15351C891A1A2"
}

​
Implementation Notes

  • For deposits:
    • Uses depositSelf function
    • Token approval may be required before deposit
    • Amount precision handled based on token decimals (6 for USDC)
  • For withdrawals:
    • Uses withdraw function
    • Amount must not exceed available balance
    • Amount precision handled based on token decimals (6 for USDC)

​
Error Responses

The endpoint will return a 400 status code for:
  • Missing type, tokenAddress, or amount
  • Invalid operation type
  • Invalid token address
  • Invalid amount format
A 500 status code will be returned for:
  • Transaction encoding errors
  • Contract interaction errors

Body

application/json
​
type
enum<string>
required

Operation type

Available options:
deposit,
withdraw
​
tokenAddress
string
required

Token contract address

​
amount
string
required

Amount to deposit or withdraw

Response

Successful response

​
calldata
string
required

Encoded function call data

​
vaultAddress
string
required

Address of the vault contract

​
requiredGasFee
string

Required gas fee for the transaction