Sign in

v1

latestOpenAPI 3.0.12026-07-142791104.2 KB
Asset

Get asset event list

This endpoint can be used to fetch asset event list from the system, query by collection slug or combined query by chain, contractAddress and tokenId. The Sale events include all markets. The Listing/Cancel events include Element,OpenSea,LooksRare,X2Y2...

Asset Events: Only fill in 'collection_slugs' or 'contract_address' and 'token_id' will get events of this asset.

Collection Events: Only fill in 'collection_slugs' or 'contract_address' will get all events of these collections.

Market Events: If neither 'collection_slugs' nor 'contract_address' nor 'token_id' are filled in, you must fill in markets, events of all collections in markets will be obtained.

get/openapi/v1/assetEvents

Query parameters

chain'eth' | 'bsc' | 'polygon' | 'avalanche' | 'arbitrum' | 'zksync' | 'linea' | 'starknet' | 'opbnb' | 'base' | 'scroll' | 'manta_pacific' | 'optimism' | 'mantle' | 'zkfair' | 'blast' | 'merlin' | 'mode' | 'cyber' | 'bob' | 'lightlink' | 'zeta' | 'nibiru' | 'abstract' | 'bitlayer' | 'mantra' | 'monad' | 'ink' required

Chain Name

contract_addressstring

The smart contract address.

token_idstring

The asset token id.

collection_slugsstring

Collection Slug.

from_timeinteger

Start time, second timestamp.

to_timeinteger

To time, second timestamp

marketsstring

Markets, allow values: Element, OpenSea, X2Y2, LooksRare, tofuNFT, case sensitive and comma separated.

event_namesstring

Filter by event names, allow values: Sale,Minted,List,Offer,Transfer,CollectionOffer,BidCancel,Cancel, comma separated. If filtered by market, Minted, Transfer are not support.

cursorstring

Page cursor

limitinteger

Page size, max is 50, default 20

Response

OK

codeinteger

Error Code

msgstring

Error Message

messagestring

Example response

{
  "data": {
    "assetEventList": [
      {
        "cursor": "MTY=",
        "assetEvent": {
          "id": "chainMID_eventId_[txHash | orderHash][_logindex][_offset], eventId: 4-Sale,9-Cancel,9002-Offer,9003-List",
          "chain": "eth",
          "chainId": "0x1",
          "eventName": "Sale",
          "eventTime": "2022-06-01T01:26:53+08:00",
          "expireTime": "2022-06-01T01:26:53+08:00",
          "txHash": "0xb16cf104312e914fbcdedc27d2fd10eb2b52449131a845d51c6bc8f01a3d72c7",
          "contractAddress": "0x4cddbf865ee2a1a3711648bb192e285f290f7985",
          "fromAddress": "0x0a56b3317ed60dc4e1027a63ffbe9df6fb102401",
          "toAddress": "0x9f7a946d935c8efc7a8329c0d894a69ba241345a",
          "tokenId": "4676314080394472507455332797632474230665182066565445726959043747700191264868",
          "quantity": 1,
          "paymentToken": "0x0000000000000000000000000000000000000000",
          "price": "33333333333333",
          "txToAddress": "0x8d6022b8a421b08e9e4cef45e46f1c83c85d402f",
          "orignEventAddress": "0x8d6022b8a421b08e9e4cef45e46f1c83c85d402f"
        }
      }
    ]
  }
}