Nft events service

The Events Service is responsible for retrieving information about events that occur on the blockchain. By utilizing various parameters within the available endpoints, we can refine our queries to obtain more precise details.

Swagger: https://api.metaproprotocol.com/ms/nft-events/docs/#/

---

This group of endpoints allows to retrieval of information about a user's blockchain-related activities. You can obtain details about various types of transactions, such as creation, purchase, and token transfers, along with timestamps and other relevant data.

Returns a list of events representing user activities

GET..//v1/user-events/{address}

Path parameters

address*string

Example: "0x245bac22bc9b034862b2716a3e9b1eec823c87ec"

Query parameters

Response

200400404

Body

application/json

one of

ApiNftMintedEventResponse (object)ApiNftMintedBatchEventResponse (object)ApiNftTransferSingleEventResponse (object)ApiNftTransferBatchEventResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('..//v1/user-events/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "results": [
    {
      "creator": "0xe561e33d8d54c4fa9250b8e096a5de3e5cd28fb8",
      "initialOwner": "0xe561e33d8d54c4fa9250b8e096a5de3e5cd28fb8",
      "_bucketHash": "316b2156-306f-43de-bd0b-0c9cfe7a589e",
      "_tokenId": "1052",
      "_quantity": "1",
      "event": "Minted",
      "type": "NftMetaMinted1155Event",
      "logId": "log_5b4111a06",
      "address": "0xa293d68684be29540838dc8a0222de0c43c6b5b4",
      "blockNumber": 25285441,
      "transactionHash": "0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06",
      "createdAt": "2023-04-27T05:59:08.998Z"
    }
  ],
  "count": 0
}

Example cURL

curl -X 'GET' \
  'https://api.metaproprotocol.com/ms/nft-events/v1/user-events/0x832735f45299c8b6f7263e758cadba766459cd21?createdAt=desc' \
  -H 'accept: application/json'

This group of endpoints allows to retrieval of activity history related to tokens. You can obtain details about events and transactions associated with tokens on your marketplace.

Returns a list of events representing user activities

GET..//v1/token-events

Query parameters

Response

200400404

Body

application/json

one of

ApiNftMintedEventResponse (object)ApiNftMintedBatchEventResponse (object)ApiNftTransferSingleEventResponse (object)ApiNftTransferBatchEventResponse (object)

Request

JavaScriptCurlPython

const response = await fetch('..//v1/token-events', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400404

{
  "results": [
    {
      "creator": "0xe561e33d8d54c4fa9250b8e096a5de3e5cd28fb8",
      "initialOwner": "0xe561e33d8d54c4fa9250b8e096a5de3e5cd28fb8",
      "_bucketHash": "316b2156-306f-43de-bd0b-0c9cfe7a589e",
      "_tokenId": "1052",
      "_quantity": "1",
      "event": "Minted",
      "type": "NftMetaMinted1155Event",
      "logId": "log_5b4111a06",
      "address": "0xa293d68684be29540838dc8a0222de0c43c6b5b4",
      "blockNumber": 25285441,
      "transactionHash": "0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06",
      "createdAt": "2023-04-27T05:59:08.998Z"
    }
  ],
  "count": 0
}

Example cURL

curl -X 'GET' \
  'https://api.metaproprotocol.com/ms/nft-events/v1/token-events?createdAt=desc' \
  -H 'accept: application/json'