Skip to main content

GET transactions

/v1/transactions

Get the volume of transactions that happened in a given collection.

Limit

/v1/transactions?limit={maxNumber}

Get only the amount of collections you need by informing the amount through the query limit parameter.

Range: 0 → 400

The default value of limit is 50, if you don't specify a value, this value be adopted.

Offset

/v1/transactions?offset={numToAvoid}

Offset ignores the desired amount of collections starting from 1 to offset. That is, if you want to skip the first 100 collections, the offset will be set to offset 100.

The default value of offset is 0, if you don't specify a value, 0 will be adopted.

Queries

You can filter transactions to get more specific results.

1. Owner address

/v1/transactions?owner_address={0xaddress}

It only returns transactions referring to a specific wallet.

2. NFT ID

/v1/transactions?nft_id={id}

It only returns transactions referring to a specific NFT.

3. Collection name

/v1/transactions?collection_name={name}

It only returns transactions referring to a specific collection.

4. From address

/v1/transactions?from={address}

Filter transactions by seeder address.

5. To address

/v1/transactions?to={address}

Filter transactions by receiver address.

6. Transaction hash

/v1/transactions?transaction_hash={transaction_hash}

Filter transactions by transaction hash.

7. Blockchain

/v1/transactions?blockchain={name}

Filter transactions by Blockchain.

Possible values:

  • ethereum
  • tron
  • polygon
Order

1. Order by

/v1/transactions?oder_by={order}

Possible values:

  • price
  • block (default)
  • price_usd

2. Order direction

/v1/transactions?order_direction={order}

Define the ordering direction of the response with the list of collections.

Possible values:

  1. asc → represents an order that starts at the lowest value and ends at the highest reference value
  2. desc → represents an order that starts at the highest value and ends at the lowest reference value

The default value of order_direction is asc , if you don't specify a value, this value will be adopted.

Note: Values are case-insensitive

Interval

Specify a time interval and receive the total amount of transactions in the interval you entered, which can be in hours, days or months. Only one interval is allowed.

1. Hours

/v1/transactions?interval_hours={number}

2. Days

/v1/transactions?interval_days={number}

3. Months

/v1/transactions?&interval_months={number}

Expected return

An array of transactions.

{
"response": [
{
"collection_name": "tron-bull-club",
"nft_id": "4161",
"from_address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb",
"to_address": "TLkXrW9hwJdh33riw3BniztyFP4LNLD238",
"price": "0",
"price_usd": 0,
"block": 13353583,
"blockchain": "Tron",
"transaction_hash": "0x7fa0fb6f7d6290623ec04e89be3cc198afc06abb3325c879adc54a308369da2a",
"date": "2021-10-21T19:40:15.000Z",
"price_token_address": null,
"price_token_name": "Tron",
"price_token_decimals": "6",
"price_token_symbol": "TRX"
}
],
"paging": {
"total": 5264,
"pages": 53,
"page": 1
}
}
Errors

400 Invalid Request

Your request is malformed. Please, check the documentation out.

401 API key is invalid

You did not pass the API key for getting authorization.

404 Data not found

Your request returned with no matches.

429 Too many requests

You are hiting the API request limit.

500 Internal server error

The server did not know how to handle this error.