Api transfer request

ApiTransferRequest

This API allows you to transfer funds in multiple different ways


  • Between SubAccounts within your Main Account

  • Between your MainAccount and your SubAccounts

  • To other MainAccounts that you have previously allowlisted

Fast Withdrawal Funding Address
For fast withdrawals, funds must be sent to the designated funding account address. Please ensure you use the correct address based on the environment:
Production Environment Address:
[To be updated, not ready yet]
This address should be specified as the to_account_id in your API requests for transferring funds using the transfer API. Ensure accurate input to avoid loss of funds or use the UI.

Name
Lite		 Type Required
Default		 Description
from_account_id
fa		 string True The main account to transfer from
from_sub_account_id
fs		 string True The subaccount to transfer from (0 if transferring from main account)
to_account_id
ta		 string True The main account to deposit into
to_sub_account_id
ts		 string True The subaccount to transfer to (0 if transferring to main account)
currency
c		 string True The token currency to transfer
num_tokens
nt		 string True The number of tokens to transfer, quoted in tokenCurrency decimal units
signature
s		 Signature True The signature of the transfer
transfer_type
tt		 TransferType True The type of transfer
transfer_metadata
tm		 string True The metadata of the transfer
Signature
Name
Lite		 Type Required
Default		 Description
signer
s		 string True The address (public key) of the wallet signing the payload
r
r		 string True Signature R
s
s1		 string True Signature S
v
v		 integer True Signature V
expiration
e		 string True Timestamp after which this signature expires, expressed in unix nanoseconds. Must be capped at 30 days
nonce
n		 integer True Users can randomly generate this value, used as a signature deconflicting key.
ie. You can send the same exact instruction twice with different nonces.
When the same nonce is used, the same payload will generate the same signature.
Our system will consider the payload a duplicate, and ignore it.
Range: 0 to 4,294,967,295 (uint32)
chain_id
ci		 string True Chain ID used in EIP-712 domain. Zero value fallbacks to GRVT Chain ID.
TransferType
Value Description
UNSPECIFIED = 0 Deprecated: use standard instead. Legacy value for transfers created before transfer types were introduced.
STANDARD = 1 Standard transfer that has nothing to do with bridging
FAST_ARB_DEPOSIT = 2 Fast Arb Deposit Metadata type
FAST_ARB_WITHDRAWAL = 3 Fast Arb Withdrawal Metadata type
NON_NATIVE_BRIDGE_DEPOSIT = 4 Transfer type for non native bridging deposit
NON_NATIVE_BRIDGE_WITHDRAWAL = 5 Transfer type for non native bridging withdrawal
ADHOC_INCENTIVE = 6 Transfer type for adhoc incentive
REFERRAL_INCENTIVE = 7 Transfer type for referral incentive
TRADING_DEPOSIT_YIELD_INCENTIVE = 8 Transfer type for trading deposit yield incentive
WalletType
Value Description
FUNDING = 1 Funding wallet
SPOT = 2 Spot wallet
FUTURES = 3 Futures wallet
WalletType
Value Description
FUNDING = 1 Funding wallet
SPOT = 2 Spot wallet
FUTURES = 3 Futures wallet