---
title: "Get asset event list"
method: GET
path: "/openapi/v1/assetEvents"
tags: ["Asset"]
---

# Get asset event list

`GET /openapi/v1/assetEvents`

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.

## 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
- `contract_address` string
- `token_id` string
- `collection_slugs` string
- `from_time` integer
- `to_time` integer
- `markets` string
- `event_names` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- ApiResponseAssetEventList
  - `code` integer — Error Code
  - `msg` string — Error Message
  - `data` AssetEventList — Return data, Generic
    - `pageInfo` PageInfo — Page infomation
      - `startCursor` string
      - `endCursor` string
      - `hasPreviousPage` string
      - `hasNextPage` string
    - `assetEventList` AssetEventListItem[] — Asset event list
      - `cursor` string — The cursor of this event in system.
      - `assetEvent` AssetEvent — Asset Event.
        - `id` string — event key
        - `chain` string — chain name
        - `chainId` string — chain id
        - `eventName` string — Asset event name
        - `eventTime` string, date-time — Asset event time
        - `expireTime` string, date-time — Asset event expire time
        - `txHash` string — Asset event transaction hash
        - `contractAddress` string — Asset contract address
        - `fromAddress` string — Asset event from address
        - `toAddress` string — Asset event to address
        - `tokenId` string — Asset event token id
        - `quantity` integer — Asset event quantity
        - `paymentToken` string — Asset event payment token
        - `price` string — Asset event price
        - `txToAddress` string — Contract address called
        - `orignEventAddress` string — The contract address of the actual transaction
  - `message` string

## Other responses

- `400` — Bad Request
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/element/apis/element-open-api.md) · [All operations](https://skmtc.net/element/apis/element-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/element/element-open-api/revisions/fa83ac7feb23/schema)