How can we track a user's transactions?

If you want to track and display information to the user about their transactions on the blockchain, you can use our User Events API. Transactions on the blockchain are transparent to every user and do not require additional authorization. Below is an example of one of such queries and the received information.

GET /v1/user-events/{address}

The GET /v1/user-events/{address} allows to retrieve information about the history of a specific wallet address on the blockchain. By providing the wallet address, you can obtain details about various events, transactions, and other activities.

Authentication

Authentication is not required to send this request, but it is necessary to provide the user's wallet address from which we want to retrieve data.

Query parameters

Name	Description
address	(string, required): The wallet address for which you want to retrieve event history.
skip	(number, optional): The number of records to skip in the response.
limit	(number, optional): The maximum number of records to return in the response.
blockNumber	(number, optional): Filter events by block number.
transactionHash	(string, optional): Filter events by transaction hash.
event	(string, optional): Filter events by event type.
_quantity	(string, optional): Filter events by quantity.
_tokenId	(string, optional): Filter events by token ID.
id	(string, optional): Filter events by ID.
createdAt	(string, optional): Sort the results (e.g., "asc" or "desc").
blockNumber	(number, optional): Filter events by block number.

Example cURL

curl --location 'https://api.metaproprotocol.com/ms/nft-events/v1/user-events/0x767e5c2359e7c809b16d8cffdb9464f91b6c970b?createdAt=desc' \
--header 'accept: application/json'

Example response body (200 OK)

{
  "_id": "6399fff8267ef946a3139dfb",
  "address": "0x1033307dd108ee32931f553a78f8f457e855d9fe",
  "blockNumber": 25452855,
  "logId": "log_9fe855",
  "transactionHash": "0xa196e0b69aa1a09123544a7fb6bb3f85b0d7512c0cdce97a439fcc72f29cfa94",
  "type": "NftMintedEvent",
  "_bucketHash": "ecfac6d9-1449-4d81-ab73-6bc7b9a559f7",
  "_quantity": "100",
  "_tokenId": "814",
  "chainId": 97,
  "createdAt": "2022-12-14T16:55:20.775Z",
  "creator": "0x767e5c2359e7c809b16d8cffdb9464f91b6c970b",
  "event": "Minted",
  "initialOwner": "0x767e5c2359e7c809b16d8cffdb9464f91b6c970b",
  "network": "bnb-chain"
}

Example of the response body (400 Bad Request)

{
    "statusCode": 400,
    "messages": [
        "address must be longer than or equal to 42 characters"
    ],
    "error": "Bad Request"
}

Example of the response body (404 Not found)

{
  "statusCode": 404,
  "messages": [
    "Not found!"
  ],
  "error": "Not Found"
}