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: 42RequiredExample: 0x245bac22bc9b034862b2716a3e9b1eec823c87ec
Query parameters
skipnumberOptionalExample: 2
limitnumber · min: 1OptionalExample: 2
blockNumbernumber · min: 1 · max: 100000000OptionalExample: 25285441
transactionHashstring · min: 66OptionalExample: 0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06
eventstring · enumOptionalPossible values:
_quantitystringOptional
_tokenIdstringOptional
idstringOptional
networkstring · enumOptionalPossible values:
createdAtstring · enumOptional

Sort by..

Example: descPossible values:
blockNumberstring · enumOptional

Sort by..

Example: descPossible values:
Responses
200Success
application/json
Responseone of
or
or
or
get
GET /user-events/{address} HTTP/1.1
Host: v1
Accept: */*
{
  "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
skipnumberOptionalExample: 2
limitnumber · min: 1OptionalExample: 2
addressstring · min: 35 · max: 55OptionalExample: 0x245bac22bc9b034862b2716a3e9b1eec823c87ec
blockNumbernumber · min: 1 · max: 100000000OptionalExample: 25285441
transactionHashstring · min: 66OptionalExample: 0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06
eventstring · enumOptionalPossible values:
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: descPossible values:
blockNumberstring · enumOptional

Sort by..

Example: descPossible values:
Responses
200Success
application/json
Responseone of
or
or
or
get
GET /token-events HTTP/1.1
Host: v1
Accept: */*
{
  "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'

Last updated