Limit Orders

Place a new limit order

post

Place a conditional order that triggers automatically when a token reaches a target price. Supports limit buys (buy + lte), stop losses (sell + lte), take profits (sell + gte), and breakout buys (buy + gte). Balances are checked at fill time only — no escrow. A company stack is auto-created for the token if one does not exist. DFlow-only tokens are auto-detected and routed accordingly. Limits: 20 active orders per user, 1 active order per token per user, minimum buy amount 1 USDC.

Authorizations

X-API-KEYstringRequired

API key with the ix_ prefix. You can generate an API Key by navigating to Settings -> API Key in the web app. Pass it in the X-API-KEY header on every request.

Body

token_addressstringRequired

Solana token mint address

Example: So11111111111111111111111111111111111111112

sidestring · enumRequired

Order direction. "buy" purchases the token with USDC, "sell" sells existing holdings

Possible values:

condition_typestring · enumRequired

Price comparison. "lte" triggers when price <= target, "gte" triggers when price >= target

Possible values:

trigger_pricenumberRequired

USD price threshold that triggers the order. Must be > 0

Example: 120

amountnumberRequired

For buys: USDC amount (minimum 1 USDC). For sells: percentage of holdings (0-100)

Example: 50

expires_atinteger · nullableOptional

Optional unix timestamp for order expiration. Must be in the future. Omit for no expiry

Responses

200

Order placed successfully.

application/json

Subset of limit order fields returned by the place action. Does not include token metadata or display fields.

order_idstringOptional

16-character unique order identifier

Example: aBcDeFgHiJkLmNoP

statusstring · enumOptionalExample: ACTIVEPossible values:

token_addressstringOptional

Solana token mint address

Example: So11111111111111111111111111111111111111112

sidestring · enumOptionalPossible values:

condition_typestring · enumOptionalPossible values:

trigger_pricenumberOptional

Target USD price threshold

Example: 120

amountnumberOptional

For buys: USDC amount. For sells: percentage (0-100)

Example: 50

stack_idintegerOptional

Company stack ID used for the trade

swap_providerstring · enumOptionalPossible values:

created_atintegerOptional

Unix timestamp of order creation

expires_atinteger · nullableOptional

Unix timestamp for automatic expiration, or null if no expiry

400

Validation error — missing/invalid fields, minimum amount not met, invalid percentage, archived token with buy side, or invalid expires_at.

application/json

404

Token not found.

application/json

409

Per-user limit reached (20 active orders) or per-token limit reached (1 active order per token).

application/json

post/api/limit_orders.php?action=place

POST /api/limit_orders.php?action=place HTTP/1.1
Host: api.indexify.finance
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "token_address": "So11111111111111111111111111111111111111112",
  "side": "buy",
  "condition_type": "lte",
  "trigger_price": 120,
  "amount": 50,
  "expires_at": 1
}

{
  "order_id": "aBcDeFgHiJkLmNoP",
  "status": "ACTIVE",
  "token_address": "So11111111111111111111111111111111111111112",
  "side": "buy",
  "condition_type": "lte",
  "trigger_price": 120,
  "amount": 50,
  "stack_id": 1,
  "swap_provider": "jupiter",
  "created_at": 1,
  "expires_at": 1
}

Cancel an active limit order

post

Cancel a limit order that has not yet been triggered. Only orders in ACTIVE status can be cancelled. Orders in TRIGGERED, FILLING, FILLED, FAILED, or CANCELLED status cannot be cancelled. The order is removed from both the database and Redis.

Authorizations

X-API-KEYstringRequired

API key with the ix_ prefix. You can generate an API Key by navigating to Settings -> API Key in the web app. Pass it in the X-API-KEY header on every request.

Body

order_idstringRequired

The 16-character limit order ID to cancel

Example: aBcDeFgHiJkLmNoP

Responses

200

Order cancelled successfully.

application/json

order_idstringOptionalExample: aBcDeFgHiJkLmNoP

statusstringOptionalExample: CANCELLED

400

Order is not in ACTIVE status.

application/json

404

Order not found or does not belong to the authenticated user.

application/json

post/api/limit_orders.php?action=cancel

POST /api/limit_orders.php?action=cancel HTTP/1.1
Host: api.indexify.finance
X-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 31

{
  "order_id": "aBcDeFgHiJkLmNoP"
}

{
  "order_id": "aBcDeFgHiJkLmNoP",
  "status": "CANCELLED"
}

List user's limit orders

get

Returns all limit orders for the authenticated user, ordered by creation time (newest first). Supports optional filtering by status and/or token address. Returns an empty array if no orders match.

Authorizations

X-API-KEYstringRequired

API key with the ix_ prefix. You can generate an API Key by navigating to Settings -> API Key in the web app. Pass it in the X-API-KEY header on every request.

Query parameters

statusstring · enumOptional

Filter by order status

Possible values:

token_addressstringOptional

Filter by Solana token mint address

Responses

200

List of limit orders. Returns an empty array if no orders match the filters.

application/json

Full limit order object returned by list and get actions. Includes token metadata and display fields.

order_idstringOptional

16-character unique order identifier

Example: aBcDeFgHiJkLmNoP

token_addressstringOptional

Solana token mint address

Example: So11111111111111111111111111111111111111112

token_symbolstring · nullableOptional

Token ticker symbol

Example: SOL

token_namestring · nullableOptional

Token display name

Example: Wrapped SOL

token_imagestring · nullableOptional

Token logo URL

sidestring · enumOptional

Order direction

Possible values:

condition_typestring · enumOptional

"lte" triggers when price <= target, "gte" triggers when price >= target

Possible values:

trigger_pricenumberOptional

Target USD price threshold

Example: 120

amountnumberOptional

For buys: USDC amount. For sells: percentage of holdings (0-100)

Example: 50

amount_displaystringOptional

Human-readable amount — "$50.00" for buys, "50%" for sells

Example: $50.00

statusstring · enumOptional

Current lifecycle status

Possible values:

stack_idintegerOptional

Company stack ID used for the trade

swap_providerstring · enumOptional

Swap provider used for execution

Possible values:

created_atintegerOptional

Unix timestamp of order creation

updated_atinteger · nullableOptional

Unix timestamp of last status change

triggered_atinteger · nullableOptional

Unix timestamp when the price condition was met

triggered_pricenumber · nullableOptional

Actual USD price that triggered the order

filled_atinteger · nullableOptional

Unix timestamp when the fill completed

fill_order_idstring · nullableOptional

Linked stack_orders.order_id for the fill

error_messagestring · nullableOptional

Failure reason (only present when status is FAILED)

expires_atinteger · nullableOptional

Unix timestamp for automatic expiration, or null if no expiry

get/api/limit_orders.php?action=list

GET /api/limit_orders.php?action=list HTTP/1.1
Host: api.indexify.finance
X-API-KEY: YOUR_API_KEY
Accept: */*

200

List of limit orders. Returns an empty array if no orders match the filters.

[
  {
    "order_id": "aBcDeFgHiJkLmNoP",
    "token_address": "So11111111111111111111111111111111111111112",
    "token_symbol": "SOL",
    "token_name": "Wrapped SOL",
    "token_image": "text",
    "side": "buy",
    "condition_type": "lte",
    "trigger_price": 120,
    "amount": 50,
    "amount_display": "$50.00",
    "status": "ACTIVE",
    "stack_id": 1,
    "swap_provider": "jupiter",
    "created_at": 1,
    "updated_at": 1,
    "triggered_at": 1,
    "triggered_price": 1,
    "filled_at": 1,
    "fill_order_id": "text",
    "error_message": "text",
    "expires_at": 1
  }
]

Get a single limit order

get

Returns full details for a specific limit order including token metadata and fill information. The order must belong to the authenticated user.

Authorizations

X-API-KEYstringRequired

API key with the ix_ prefix. You can generate an API Key by navigating to Settings -> API Key in the web app. Pass it in the X-API-KEY header on every request.

Query parameters

order_idstringRequired

The 16-character limit order ID

Responses

200

Limit order details.

application/json

Full limit order object returned by list and get actions. Includes token metadata and display fields.

order_idstringOptional

16-character unique order identifier

Example: aBcDeFgHiJkLmNoP

token_addressstringOptional

Solana token mint address

Example: So11111111111111111111111111111111111111112

token_symbolstring · nullableOptional

Token ticker symbol

Example: SOL

token_namestring · nullableOptional

Token display name

Example: Wrapped SOL

token_imagestring · nullableOptional

Token logo URL

sidestring · enumOptional

Order direction

Possible values:

condition_typestring · enumOptional

"lte" triggers when price <= target, "gte" triggers when price >= target

Possible values:

trigger_pricenumberOptional

Target USD price threshold

Example: 120

amountnumberOptional

For buys: USDC amount. For sells: percentage of holdings (0-100)

Example: 50

amount_displaystringOptional

Human-readable amount — "$50.00" for buys, "50%" for sells

Example: $50.00

statusstring · enumOptional

Current lifecycle status

Possible values:

stack_idintegerOptional

Company stack ID used for the trade

swap_providerstring · enumOptional

Swap provider used for execution

Possible values:

created_atintegerOptional

Unix timestamp of order creation

updated_atinteger · nullableOptional

Unix timestamp of last status change

triggered_atinteger · nullableOptional

Unix timestamp when the price condition was met

triggered_pricenumber · nullableOptional

Actual USD price that triggered the order

filled_atinteger · nullableOptional

Unix timestamp when the fill completed

fill_order_idstring · nullableOptional

Linked stack_orders.order_id for the fill

error_messagestring · nullableOptional

Failure reason (only present when status is FAILED)

expires_atinteger · nullableOptional

Unix timestamp for automatic expiration, or null if no expiry

404

Order not found or does not belong to the authenticated user.

application/json

get/api/limit_orders.php?action=get

GET /api/limit_orders.php?action=get?order_id=text HTTP/1.1
Host: api.indexify.finance
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "order_id": "aBcDeFgHiJkLmNoP",
  "token_address": "So11111111111111111111111111111111111111112",
  "token_symbol": "SOL",
  "token_name": "Wrapped SOL",
  "token_image": "text",
  "side": "buy",
  "condition_type": "lte",
  "trigger_price": 120,
  "amount": 50,
  "amount_display": "$50.00",
  "status": "ACTIVE",
  "stack_id": 1,
  "swap_provider": "jupiter",
  "created_at": 1,
  "updated_at": 1,
  "triggered_at": 1,
  "triggered_price": 1,
  "filled_at": 1,
  "fill_order_id": "text",
  "error_message": "text",
  "expires_at": 1
}

PreviousDeAnon NextModels

Last updated 4 months ago