---
title: "Fetch events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# Fetch events

`GET /v1/events`

## Query parameters

- `from_address` string
- `to_address` string
- `type` 'list' | 'sale' | 'cancel_listing', required
- `contract` string
- `token_id` integer
- `created_before` string
- `created_after` string
- `limit` integer
- `cursor` string

## Response `200`

Successful

- EventResponse
  - `success` boolean, required
  - `next` string
  - `data` Event[]
    - `id` integer
    - `from_address` string
    - `to_address` string
    - `token` TokenLite
      - `contract` string
      - `token_id` integer
      - `erc_type` 'erc721' | 'erc1155'
    - `order` Order
      - `id` integer
      - `item_hash` string
      - `maker` string
      - `taker` string
      - `token` TokenLite
        - `contract` string
        - `token_id` integer
        - `erc_type` 'erc721' | 'erc1155'
      - `price` string
      - `currency` string
      - `type` string, required
      - `is_collection_offer` string
      - `royalty_fee` integer — Base rate is 10^6. For example, 50000 means 5%
      - `created_at` string
      - `end_at` string
    - `tx` string
    - `type` string
    - `created_at` string

---

[API](https://skmtc.dev/x2y2/apis/x2y2-openapi.md) · [All operations](https://skmtc.dev/x2y2/apis/x2y2-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/x2y2/x2y2-openapi/revisions/84d91477b3ec/schema)