Get Transaction List

This endpoint allows users to retrieve a list of transactions done on the Zodia Markets platform

`transactionClass` Code Table

Transactions are split into requests for deposit and withdrawal of Fiat and Crpto, Trades performed with the Zodia Markets Brokerage desk and trades performed on the Zodia Markets e-Trader service.

Code	Description
COIN	Digital Asset deposit/withdrawal
CASH	Cash (Fiat) depsoit/withdrawal
OTCTRADE	OTC Trade (desk)
RFSTRADE	RFS Trade (e-Trader)

`transactionState` Code Table

Transactions transition through the following states.

Code	Description
PENDING	Trade is executed but pending settlement
PROCESSED	Trade is executed and settled.
REVERSED	A leg of the transaction has been reversed
CANCELLED	Trade settlement has been cancelled

`transactionType` Code Table

The type of transaction is filtered as follows

Code	Description
DEPOSIT	Deposit
DEPOSIT_REVERSAL	Deposit Reversal
WITHDRAWAL	Withdrawal
WITHDRAWAL_REVERSAL	Withdrawal Reversal
TRADE_DEBIT	RFS/OTC trade debit (Sell Transaction)
TRADE_DEBIT_REVERSAL	RFS/OTC trade debit reversal (Sell Transaction)
TRADE_CREDIT	RFS/OTC trade credit (Buy Transaction)
TRADE_CREDIT_REVERSAL	RFS/OTC trade credit reversal (Buy Transaction)

Domain: Accounts

Request

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

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.
`ccy`	string		Currency ticker (e.g. BTC, USD). Transactions are filtered on this currency only
`transactionState`	string		Return only transactions in this state - see reference above.
`from`	integer (int64)		Start time (inclusive) of when transaction was created in system, format in Unix time in milliseconds.
`to`	integer (int64)		End time (inclusive) of when transaction was created, format in Unix time in milliseconds.
`max`	integer (int32)		Max results you want the endpoint to return. Note that it can be no greater than 200. Default value is 50 if not provided. — Default: 50
`offset`	integer (int32)		Offset index. If you want to get beyond the first 200 transactions, you can use the offset value to get the next 200 transactions and so on.
`accountGroupUuid`	string		Shows transactions specific to account group transactions
`transactionClass`	string		The class to filter on - see reference above
`transactionType`	string		Filter by the type of transaction - see reference above

Responses

200

OTCTRADE

Field	Type	Description
`transactionClass`	string	See transactionClass description
`uuid`	string	Unique identifier of transaction
`userUuid`	string	Trader who placed the trade
`amount`	integer	Quantity of trade — Default: 0
`fee`	integer	Usually 0 — Default: 0
`balanceBefore`	integer	Balance before trade executed — Default: 0
`balanceAfter`	integer	Balance after trade executed — Default: 0
`ccy`	string	Currency
`transactionState`	string	See transactionState descriptions
`transactionType`	string	See transactionType descriptions
`received`	string	Datetime created timestamp
`processed`	string	Datetime processed (settled) timestamp
`timestampMillis`	string
`displayTitle`	string	Description of transaction
`displayDescription`	string	Additional description
`customRef`	string	Customer provided trade ref
`tradeRef`	string	The Zodia Markets trade reference for the trade this transaction belongs to. It is the value to send as `tradeRef` on Get Trades List to retrieve the trade itself.
`accountGroupUuid`	string	UUID of Account Group transaction was executed on
`settleDate`	string	The expected date of settlement for trade
`sender`	object	Details of entity that sent the funds for the trade
`sender.uuid`	string	Identifier of entity that sent the funds for the trade
`sender.name`	string	Name of entity that sent the funds for the trade
`networkId`	string	Name of network used for payment

RFSTRADE

Field	Type	Description
`transactionClass`	string	See description
`uuid`	string	Unique reference
`userUuid`	string	Trader who entered the trade
`amount`	number	Quantity of trade leg — Default: 0
`fee`	integer	Usually 0 — Default: 0
`balanceBefore`	integer	Balance before trade executed — Default: 0
`balanceAfter`	integer	Balance after trade executed — Default: 0
`ccy`	string	Currency
`transactionState`	string	See description
`transactionType`	string	See description
`received`	string	Timestamp created
`processed`	string	Timestamped settled
`timestampMillis`	string
`displayTitle`	string	Transaction description
`displayDescription`	string	Additional description
`customRef`	string	Reference provided via API
`quoteId`	string	Quote ID executed on via API
`executedPrice`	string	Price executed
`tradeRef`	string	The Zodia Markets trade reference for the trade this transaction belongs to. It is the value to send as `tradeRef` on Get Trades List to retrieve the trade itself.
`accountGroupUuid`	string	UUID of account group transaction was executed on
`settleDate`	string	The expected date of settlement for the trade
`beneficiary`	object	Only applicable when making a payment transaction.
`beneficiary.uuid`	string	Unique identifier for beneficiary the trade is to be delivered to
`beneficiary.name`	string	Name of the beneficiary the trade is to be delivered to
`networkId`	string	Only applicable for 3rd party payment trades. Name of network used to facilitate trade
`paymentReason`	string (enum)	Only applicable for 3rd party payment trades. ISO code denoting the payment reason — One of: VASA, INVS, NETT, TREA, PLPR, PLRE, RENT, UTIL, GDSV, SUPP, SERV, SUBS, ADVA, GIFT, CASH, CHAR, OTHR, SAVE, LOAN, TAXS, FEXP, SALA, PENS

COIN

Field	Type	Description
`transactionClass`	string
`uuid`	string
`userUuid`	string
`amount`	integer	Default: 0
`fee`	integer	Default: 0
`balanceBefore`	integer	Default: 0
`balanceAfter`	integer	Default: 0
`ccy`	string
`transactionState`	string
`transactionType`	string
`received`	string
`processed`	string
`timestampMillis`	string
`displayTitle`	string
`displayDescription`	string
`coinAddress`	string	Source Address of coin transaction
`coinTransactionId`	string	The blockchain transaction hash for this coin movement.
`sender`	object	Entity that deposited the coin
`sender.uuid`	string
`sender.name`	string

CASH

Field	Type	Description
`transactionClass`	string
`uuid`	string
`userUuid`	string
`amount`	integer	Default: 0
`fee`	integer	Default: 0
`balanceBefore`	integer	Default: 0
`balanceAfter`	integer	Default: 0
`ccy`	string
`transactionState`	string
`transactionType`	string
`received`	string
`processed`	string
`timestampMillis`	string
`displayTitle`	string
`displayDescription`	string
`paymentTransferType`	string

400

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

401

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

403

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

404

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

500

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