Skip to content

Withdrawals

GET
/api/trading/accounts/{account_id}/withdrawals
curl --request GET \
--url 'https://example.com/api/trading/accounts/1/withdrawals?limit=20' \
--header 'INF-ACCESS-KEY: <INF-ACCESS-KEY>' \
--header 'INF-ACCESS-SIGNATURE: <INF-ACCESS-SIGNATURE>' \
--header 'INF-ACCESS-TIMESTAMP: <INF-ACCESS-TIMESTAMP>'

Your signed withdrawals, newest first, the nonce to sign next, and the most you can withdraw now.

account_id
required
Account Id
integer
limit
Limit
integer
default: 20

At most this many, up to 200. 20 if not given.

Successful Response

Media typeapplication/json
Withdrawals
object
next_nonce
required
Next Nonce

The nonce to sign in your next withdrawal.

integer
withdrawable
required
Withdrawable

The most you can withdraw now, in units.

integer
awaiting_the_vault
required
Awaiting The Vault

True while the vault has not applied one of your recent fills. A withdrawal is refused until it has, usually for about 25 seconds.

boolean
withdrawals
required
Withdrawals

Newest first.

Array<object>
Withdrawal
object
nonce
required
Nonce
integer
amount
required
Amount

In units.

integer
status
required
Status

reserved: the amount is held until the vault pays or skips it. paid: the vault paid your linked wallet. claimable: the vault took the amount but could not send it, so your wallet claims it with claimUnpaid. skipped: the vault did not pay it, and the amount stays held, usually until the vault’s block is final. given_back: the amount is free again.

string
Allowed values: reserved paid claimable skipped given_back
digest
required
Digest

The signed Withdraw message’s EIP-712 digest.

string
wallet
required
Wallet

Your linked wallet when the withdrawal was reserved.

string
requested_at_ms
required
Requested At Ms
integer
Example
{
"withdrawals": [
{
"status": "reserved"
}
]
}

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Examplegenerated
{
"detail": [
{
"loc": [
"example"
],
"msg": "example",
"type": "example",
"input": "example",
"ctx": {}
}
]
}