---
title: "GET /v1/legend-twaps"
method: GET
path: "/v1/legend-twaps"
tags: ["legend-twaps"]
---

# GET /v1/legend-twaps

`GET /v1/legend-twaps`

## Request

- Base URL: `https://app.legend.trade/api/rest`
- URL: `https://app.legend.trade/api/rest/v1/legend-twaps`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string
- `address` string, required

## Response `200`

Successful response

- object
  - `total` integer
  - `nextCursor` string
  - `previousCursor` string
  - `hasMore` boolean, required
  - `items` object[], required
    - `provider` 'legend', required
    - `id` integer, required
    - `market` string, required
    - `size` string, required
    - `filled` string, required
    - `notional` number, required
    - `buy` boolean, required
    - `minutes` number, required
    - `reduceOnly` boolean, required
    - `randomize` boolean, required
    - `triggerAbove` boolean, nullable, required
    - `status` string, required
    - `createdAt` string, required
    - `triggerPx` string, nullable, required
    - `stopPx` string, nullable, required
  - `poll` boolean, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

## Changes

- **2026-10-25** `8d368659667e`: 3 breaking, 3 info
  - the response property `items/items/stopPx` became nullable for the status `200`
  - the response property `items/items/triggerAbove` became nullable for the status `200`
  - the response property `items/items/triggerPx` became nullable for the status `200`
  - response property `items/items/stopPx` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - …2 more
- **2026-10-15** `c3b07d60c348`: 1 info
  - added the required property `items/items/provider` to the response with the `200` status
- **2026-10-08** `d341c13fd3d9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/legend-twaps/get.md)

---

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