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

Path parameters

addressstring · min: 42required

Example: 0x245bac22bc9b034862b2716a3e9b1eec823c87ec

Query parameters

skipnumberoptional

Example: 2

limitnumber · min: 1optional

Example: 2

blockNumbernumber · min: 1 · max: 100000000optional

Example: 25285441

transactionHashstring · min: 66optional

Example: 0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06

eventstring · enumoptional

Available options:

_quantitystringoptional

_tokenIdstringoptional

idstringoptional

networkstring · enumoptional

Available options:

createdAtstring · enumoptional

Sort by..

Example: desc

Available options:

blockNumberstring · enumoptional

Sort by..

Example: desc

Available options:

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '..//v1/user-events/{address}'

200

400

404

200

{
  "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": 1
}

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

Query parameters

skipnumberoptional

Example: 2

limitnumber · min: 1optional

Example: 2

addressstring · min: 35 · max: 55optional

Example: 0x245bac22bc9b034862b2716a3e9b1eec823c87ec

blockNumbernumber · min: 1 · max: 100000000optional

Example: 25285441

transactionHashstring · min: 66optional

Example: 0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06

eventstring · enumoptional

Available options:

ownerstring · min: 35 · max: 55optional

initialOwnerstring · min: 35 · max: 55optional

creatorstring · min: 35 · max: 55optional

fromstring · min: 35 · max: 55optional

tostring · min: 35 · max: 55optional

operatorstring · min: 35 · max: 55optional

_quantitystringoptional

_tokenIdstringoptional

createdAtstring · enumoptional

Sort by..

Example: desc

Available options:

blockNumberstring · enumoptional

Sort by..

Example: desc

Available options:

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '..//v1/token-events'

200

400

404

200

{
  "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": 1
}

Example cURL

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