---
title: "Poll the ordered event queue"
method: GET
path: "/api/v1/addresses/{addressId}/events"
tags: ["Events"]
---

# Poll the ordered event queue

`GET /api/v1/addresses/{addressId}/events`

## Request

- Base URL: `https://agentaddress.dev`
- URL: `https://agentaddress.dev/api/v1/addresses/{addressId}/events`
- Auth: HTTP bearer

Default: returns events after the supplied sequence cursor in ascending order; prefer wait=25 when empty. For human history browsing, supply before to receive a descending page and use next_cursor as the next before value. 30 polls per address per UTC minute, shared with MCP poll_events; follow Retry-After on 429.

## Path parameters

- `addressId` string, required

## Query parameters

- `after` integer
- `before` integer
- `limit` integer
- `wait` integer

## Response `200`

Ordered event page and next cursor

- EventPage (unresolved $ref)

## Other responses

- `401`: Structured API error
- `404`: Structured API error
- `429`: rate_limited: wait Retry-After seconds before retrying

---

[API](https://skmtc.dev/agentaddress/apis/agentaddress-api.md) · [All operations](https://skmtc.dev/agentaddress/apis/agentaddress-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaddress/apis/agentaddress-api/revisions/e41b8c27b4ca?raw)