---
title: "List limit orders for the vaults you can access."
method: GET
path: "/swap/{chain}/orders"
tags: ["Swap"]
---

# List limit orders for the vaults you can access.

`GET /swap/{chain}/orders`

## Path parameters

- `chain` string, required — Canonical chain registry name

## Query parameters

- `boring_swapper` string, required — EIP-55 checksummed EVM address
- `vault_address` string — EIP-55 checksummed EVM address
- `status` string — Optional lifecycle-status filter, e.g. `open_in_orderbook`.
- `tx_hash` string — 0x-prefixed transaction hash
- `page_size` integer
- `cursor` string

## Response `200`

Successful Response

- SwapOrderListResponse
  - `data` SwapOrderData[], required
    - `order_id` string, required — Order identifier derived from the on-chain protocol hash.
    - `chain` string, required — Canonical chain registry name
    - `vault_address` string, required — EIP-55 checksummed EVM address
    - `boring_swapper` string, required — EIP-55 checksummed EVM address
    - `protocol` string, required
    - `adapter` string, required — EIP-55 checksummed EVM address
    - `token_in` string, required — EIP-55 checksummed EVM address
    - `token_out` string, required — EIP-55 checksummed EVM address
    - `input_amount` string, required — Original order input in atomic units of token_in.
    - `remaining_input` string, required — Unfilled order principal in atomic units of token_in; zero after final settlement.
    - `min_amount_out` string, required — Minimum order output in atomic units of token_out.
    - `status` string, required
    - `valid_to` integer, required — Unix expiry timestamp; null for protocols without one.
    - `submitted_at` string, date-time, required
    - `submit_tx_hash` string, required — 0x-prefixed transaction hash
    - `submit_block_hash` string, required — Canonical inclusion block hash; null before inclusion.
    - `submit_inclusion_status` 'pending' | 'included' | 'reorged' | 'dropped', required
    - `submit_finality_status` 'unsafe' | 'safe' | 'finalized', required
    - `submit_execution_status` 'unknown' | 'success' | 'reverted', required
    - `fill_tx_hash` string, required — 0x-prefixed transaction hash
    - `filled_at` string, date-time, required
    - `actual_input` string, required — Canonical base-10 uint256 string in raw token units
    - `actual_output` string, required — Canonical base-10 uint256 string in raw token units
  - `page` SwapperPageMeta, required — Pagination metadata emitted alongside every collection response.
    - `next_cursor` string
    - `has_more` boolean
    - `page_size` integer, required

## Other responses

- `401` — Unauthorized — missing or malformed Authorization header.
- `403` — Forbidden — API key invalid, revoked, expired, or insufficient permissions for this action or resource.
- `422` — Validation Error
- `429` — Too Many Requests - Rate limit exceeded

## Changes

- **2026-09-17** `feac2b28887c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/veda/apis/veda-console-api/changes/swap/:chain/orders/get.md)

---

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