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:

Responses

200Success

application/json

Responseone of

or

or

or

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

/v1/user-events/{address}

HTTPcURLJavaScriptPython

GET /v1/user-events/{address} HTTP/1.1
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:

Responses

200Success

application/json

Responseone of

or

or

or

400

Incorrect data requested

application/json

404

Entity not found

application/json

get

/v1/token-events

HTTPcURLJavaScriptPython

GET /v1/token-events HTTP/1.1
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'