Retrieve an overview of historical transactions

post https://example.com/api/1/query/transactions

Retrieves an overview of transactions for the specified period, wallets.

Query Params

format

string

Optional return format. Set to 'csv' to get a CSV file rather than a JSON response

Body Params

chainName

string

the supported chains

address

string

the wallet's address to filter against

hash

string

length ≥ 2

a transaction's hash to search; if hash is used all filters, other than address and chainName, are skipped

tag

string

a tag id to filter the transitions against

tags

array of strings

a list of tag id to filter the transitions against in AND fashion; it override the tag filter

tags

transactionTypes

array of strings

a list of types to filter the transactions in OR fashion; it overrides the transactionType filter

transactionTypes

transactionType

string

Category of transaction.

locationType

string

Type of the location where this transaction occurred.

fromReliability

number

the starting reliability for the transactions, must be lower than or equal to toReliability

toReliability

number

the ending reliability for the transactions, must be lower than or equal than 1

fromTime

number

Unix timestamp from when to retrieve transactions

toTime

number

Unix timestamp until when to retrieve transactions

resultsPerPage

number

Defaults to 100

shared

boolean

Defaults to 100

if true, only transactions coming from shared wallets will be displayed

page

number

Defaults to 0

status

string

status of the transactions

Responses

Response body

object

pagination

object

resultsPerPage

number

required

page

number

required

hasMorePages

boolean

required

totalResults

number

Total amount of transactions found

transactions

array of objects

required

transactions*

object

uuid

Internal Transaction id

timestamp

number

required

Unix timestamp at time of transaction

type

string

required

Category of transaction.

send receive trade add_liquidity remove_liquidity claim stake swap sell buy execution deposit withdrawal approval airdrop contract_creation UNKNOWN

executionType

string

a description of the function being executed by a contract, in case of contract execution

sender

receiver

amountIn

array of objects

the overall amounts coming in to the wallet, aggregated by token

amountIn

object

amount

number

required

coin

object

required

value

object

the value in fiat currency for this object

outOfRange

boolean

if true, amount exceed the token's total supply

amountOut

array of objects

the overall amounts coming out from to the wallet, aggregated by token

amountOut

object

amount

number

required

coin

object

required

value

object

the value in fiat currency for this object

outOfRange

boolean

if true, amount exceed the token's total supply

hash

string

notes

string

a custom note to add to this transaction

fee

object

location

object

required

The user's wallet involved in the transaction

transactionId

string

transactions may have an ID rather than a hash

events

array of objects

events

object

type

string

the type of the event

name

string

the name of the event

source

string

the original event's source

params

array of objects

the original event's params

params

object

executor

string

required

the address of the contract triggering this event

fromAddress

string

toAddress

string

amount

object

offset

number

required

the log offset identifies order of events within the transaction

tags

array of objects

the list of tags associated with this transactions

tags

object

string

required

the id of the tag

label

string

the label of the tag

shared

boolean

if true, the tag is inherited from a shared wallet

transfers

array of objects

all the single transfers happened in this transaction

transfers

object

amount

object

required

sender

required

receiver

required

type

string

required

Category of Transfers.

send receive approval UNKNOWN

relatedTo

uuid

successful

boolean

required

The status of the transaction.

journalRef

string

the reference to the accounting system entry

reliability

number

the level of reliability for this transaction, from 0 (bad) to 1 (good), based on the reliability of the coins involved

loadedAt

number

the time when this transaction record was loaded from remote

shared

boolean

if true, the transaction is shared in a group

errors

array of objects

errors

object

type

string

required

error type

wallet bookkeeping price trade unknown

location

string

locationType

string

Type of the location where this transaction occurred.

wallet

message

string

required

Language

Credentials

Bearer

JWT

URL


xxxxxxxxxx
11
1
curl --request POST \
2
     --url https://example.com/api/1/query/transactions \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "resultsPerPage": 100,
8
  "shared": 100,
9
  "page": 0
10
}
11
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

text/csv

200OK

401User is not logged in

500Error