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.