---
title: "Get Limit Order"
method: GET
path: "/v1/limit-orders/{order_id}"
tags: ["limit_orders"]
---

# Get Limit Order

`GET /v1/limit-orders/{order_id}`

## Request

- Base URL: `https://api.fereai.xyz`
- URL: `https://api.fereai.xyz/v1/limit-orders/{order_id}`
- Auth: none declared

Get status of a specific limit order.

## Path parameters

- `order_id` string, required: Limit order ID.

## Response `200`

Successful Response

- LimitOrderStatus
  - `limit_order_id` string, required: Unique limit order identifier.
  - `agent_id` string, required: Agent that created the order.
  - `token_in` string, required: Input token address.
  - `token_out` string, required: Output token address.
  - `amount` string, required: Order amount in smallest unit.
  - `chain_id` integer, nullable: Source chain ID.
  - `chain_id_out` integer, nullable: Destination chain ID.
  - `price_usd_trigger` number, required: USD trigger price.
  - `trigger_token_address` string, required: Token being monitored for price.
  - `trigger_token_chain` string, required: Chain of the trigger token.
  - `condition` string, required: Trigger condition: gte or lte.
  - `status` string, required: Order status: pending, executed, cancelled, failed.
  - `buy_token_name` string, nullable: Name of the output token.
  - `buy_token_symbol` string, nullable: Symbol of the output token.
  - `buy_token_logo_url` string, nullable: Logo URL for the output token.
  - `query` string, nullable: Original user query for context.
  - `created_at` string, nullable: ISO 8601 creation timestamp.
  - `executed_at` string, nullable: ISO 8601 execution timestamp.
  - `updated_at` string, nullable: ISO 8601 last-updated timestamp.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fereai/apis/fereai-gateway.md) - [All operations](https://skmtc.dev/fereai/apis/fereai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/fereai/apis/fereai-gateway/revisions/ad211f8e2f30?raw)