Examples

Example request

curl --request POST \
  --url 'https://trade-uk.sandbox.zodiamarkets.com/api/3/transfer' \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'Rest-Key: <your_api_key>' \
  --header 'Rest-Sign: <generated_signature>' \
  --data '{"tonce":1770888183656000,"accountGroupUuid":"2073252c-81ed-41be-bf4d-d51b8f2246b8","ccy":"USDC","from":"AVAILABLE","to":"BROKERAGE","amount":250000}'

200 response example

{
  "status": "OK",
  "uuid": "72e4d281-afsd-10b2-a549-d268892eahth3"
}

400 response example

{
  "resultCode": "INVALID_PARAMETERS",
  "timestamp": "1666588820606"
}

401 response example

{
  "timestamp": "1666418418989",
  "resultCode": "UNAUTHORISED"
}

403 response example

{
  "timestamp": "1666418418989",
  "resultCode": "UNAUTHORISED"
}

404 response example

{
  "apiVersion": "1.0.0",
  "error": "SYSTEM_ERROR",
  "timestamp": 1666587269
}

500 response example

{
  "resultCode": "SYSTEM_ERROR",
  "timestamp": "1666580244296"
}

Transfer Between Internal Accounts

Move funds in-between platform accounts. Use this endpoint to move funds between different accounts to trade in brokerage, or to withdraw later on.

Domain: Accounts

Request

POST https://trade-uk.sandbox.zodiamarkets.com/api/3/transfer

Headers

Header	Required	Description
`Rest-Key`		API key for authentication
`Rest-Sign`		Calculated API Signature

Body

Field	Type	Required	Description
`tonce`	integer (int64)	yes	The current Unix time in microseconds.
`from`	string	yes	Which account the funds are being transferred from. Valid values: `AVAILABLE` / `BROKERAGE`
`to`	string	yes	Which account the funds are being transferred to. Valid values: `AVAILABLE` / `BROKERAGE`
`amount`	number (double)	yes	Amount to transfer.
`ccy`	string	yes	Currency ticker to transfer.
`accountGroupUuid`	string	yes	specify which account group to perform the transfer upon

Responses

200

Field	Type	Required	Description
`status`	string
`uuid`	string

400

Field	Type	Required	Description
`resultCode`	string
`timestamp`	string

401

Field	Type	Required	Description
`timestamp`	string
`resultCode`	string

403

Field	Type	Required	Description
`timestamp`	string
`resultCode`	string

404

Field	Type	Description
`apiVersion`	string
`error`	string
`timestamp`	integer	Default: 0

500

Field	Type	Required	Description
`resultCode`	string
`timestamp`	string