FEfereai
limit_orders

Get Limit Order

Get status of a specific 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

Path parameters

order_idstring required

Limit order ID.

Response

Successful Response

limit_order_idstring required

Unique limit order identifier.

agent_idstring required

Agent that created the order.

token_instring required

Input token address.

token_outstring required

Output token address.

amountstring required

Order amount in smallest unit.

chain_idinteger nullable

Source chain ID.

chain_id_outinteger nullable

Destination chain ID.

price_usd_triggernumber required

USD trigger price.

trigger_token_addressstring required

Token being monitored for price.

trigger_token_chainstring required

Chain of the trigger token.

conditionstring required

Trigger condition: gte or lte.

statusstring required

Order status: pending, executed, cancelled, failed.

buy_token_namestring nullable

Name of the output token.

buy_token_symbolstring nullable

Symbol of the output token.

buy_token_logo_urlstring nullable

Logo URL for the output token.

querystring nullable

Original user query for context.

created_atstring nullable

ISO 8601 creation timestamp.

executed_atstring nullable

ISO 8601 execution timestamp.

updated_atstring nullable

ISO 8601 last-updated timestamp.

Example response

{
  "agent_id": "agent_abc123",
  "amount": "1000000000000000000",
  "buy_token_name": "USD Coin",
  "buy_token_symbol": "USDC",
  "chain_id": 8453,
  "chain_id_out": 8453,
  "condition": "gte",
  "created_at": "2026-03-01T12:00:00Z",
  "limit_order_id": "lo-abc123",
  "price_usd_trigger": 3500,
  "status": "pending",
  "token_in": "0xEeee...EEeE",
  "token_out": "0x8335...2913",
  "trigger_token_address": "0xEeee...EEeE",
  "trigger_token_chain": "base"
}

Changes

No recorded changes to this operation across all 1 revision of this API.