Skip to main content
GET
/
api
/
v1
/
transaction
/
withdrawals
Get withdrawals
curl --request GET \
  --url https://api.ekiden.fi/api/v1/transaction/withdrawals
[
  {
    "amount": 1000,
    "asset_addr": "0x9876543210fedcba...",
    "balance": 4000,
    "created_at": "2024-01-01T12:00:00Z",
    "id": 123,
    "last_updated": "2024-01-01T12:00:00Z",
    "root_addr": "0x1234567890abcdef...",
    "updated_at": "2024-01-01T12:00:00Z",
    "user_addr": "0x1234567890abcdef...",
    "vault_addr": "0xabcdef1234567890...",
    "version": 12345,
    "fee": 10
  }
]

Query Parameters

​
user_addr
string | null

User address to filter withdrawals by

​
vault_addr
string | null

Vault address to filter withdrawals by

​
asset_addr
string | null

Asset address to filter withdrawals by

​
start_version
integer<int64> | null

Start version for filtering (inclusive)

Required range: x >= 0
​
end_version
integer<int64> | null

End version for filtering (inclusive)

Required range: x >= 0
​
page
integer
default:1
Required range: x >= 0
​
per_page
integer
default:20
Required range: x >= 0

Response

Successfully retrieved list of withdrawals

​
amount
integer<int64>
required

Amount withdrawn

Example:

1000

​
asset_addr
string
required

Asset address

Example:

"0x9876543210fedcba..."

​
balance
integer<int64>
required

New balance after withdrawal

Example:

4000

​
created_at
string<date-time>
required

When the withdrawal record was created

Example:

"2024-01-01T12:00:00Z"

​
id
integer<int32>
required

Withdrawal ID

Example:

123

​
last_updated
string<date-time>
required

When the withdrawal was last updated

Example:

"2024-01-01T12:00:00Z"

​
root_addr
string
required

Root account address (for sub-accounts)

Example:

"0x1234567890abcdef..."

​
updated_at
string<date-time>
required

When the withdrawal record was last modified

Example:

"2024-01-01T12:00:00Z"

​
user_addr
string
required

User address who made the withdrawal

Example:

"0x1234567890abcdef..."

​
vault_addr
string
required

Vault address where withdrawal was made

Example:

"0xabcdef1234567890..."

​
version
integer<int64>
required

Transaction version

Example:

12345

​
fee
integer<int64> | null

Withdrawal fee (if any)

Example:

10