FEfereai
limit_orders

List Limit Orders

List all limit orders for the current user.

get/v1/limit-orders

Request

  • Base URL
    https://api.fereai.xyz
  • URL
    https://api.fereai.xyz/v1/limit-orders
  • Auth
    none declared

Query parameters

statusstring nullable

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.