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

addressstring · min: 42required

Example: 0x245bac22bc9b034862b2716a3e9b1eec823c87ec

Query parameters

skipnumber

Example: 2

limitnumber · min: 1

Example: 2

blockNumbernumber · min: 1 · max: 100000000

Example: 25285441

transactionHashstring · min: 66

Example: 0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06

eventstring · enum

Options: Minted, MintedBatch, TransferSingle, TransferBatch, OwnershipTransferred

_quantitystring

_tokenIdstring

idstring

networkstring · enum

Options: bnb-chain, ethereum, polygon, arbitrum, base

createdAtstring · enum

Sort by..

Example: desc

Options: desc, asc

blockNumberstring · enum

Sort by..

Example: desc

Options: desc, asc

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

400

404

200

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

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

skipnumber

Example: 2

limitnumber · min: 1

Example: 2

addressstring · min: 35 · max: 55

Example: 0x245bac22bc9b034862b2716a3e9b1eec823c87ec

blockNumbernumber · min: 1 · max: 100000000

Example: 25285441

transactionHashstring · min: 66

Example: 0x99e686a1ed12b5269c69871f4d4baf626629770b3c5929cb58e1a85515965a06

eventstring · enum

Options: Minted, MintedBatch, TransferSingle, TransferBatch, OwnershipTransferred

ownerstring · min: 35 · max: 55

initialOwnerstring · min: 35 · max: 55

creatorstring · min: 35 · max: 55

fromstring · min: 35 · max: 55

tostring · min: 35 · max: 55

operatorstring · min: 35 · max: 55

_quantitystring

_tokenIdstring

createdAtstring · enum

Sort by..

Example: desc

Options: desc, asc

blockNumberstring · enum

Sort by..

Example: desc

Options: desc, asc

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

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

200

400

404

200

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

Example cURL

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