Skip to Content
Indexify
Trading

Place a new limit order

POST
/api/limit_orders.php?action=place

Place a conditional order that triggers automatically when a price threshold is crossed. Supports two target types: "token" (default) triggers on individual token price, "stack" triggers on the stack NAV (net asset value). 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. Token orders: Require token_address. A company stack is auto-created for the token if needed. Stack orders: Require stack_id and target_type=stack. Company stacks (single-token) are not allowed — use token orders instead. Limits: 20 active orders per user, 1 active order per token per user, 1 active stack order per stack per user, minimum buy amount 1 USDC.

Authorization

ApiKeyAuth
headerX-API-KEY<token>

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.

Request Body

application/json
  1. body
target_type?string

Order target type. "token" for individual token price, "stack" for stack NAV

Default"token"
Value in"token""stack"
token_address?string

Solana token mint address (required for token orders)

stack_id?integer

Stack ID (required for stack orders)

side?string

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

Value in"buy""sell"
condition_type?string

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

Value in"lte""gte"
trigger_price?number

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

amount?number

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

expires_at?|

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

Response Body

Order placed successfully.

application/json
  1. response

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

order_id?string

16-character unique order identifier

status?"ACTIVE"
Value in"ACTIVE"
target_type?string

Whether this order targets a single token or a multi-token stack

Value in"token""stack"
token_address?|

Solana token mint address (present for token orders, absent for stack orders)

side?string
Value in"buy""sell"
condition_type?string
Value in"lte""gte"
trigger_price?number

Target USD price threshold

amount?number

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

stack_id?integer

Stack ID — company stack for token orders, user stack for stack orders

stack_name?|

Stack name (only present for stack orders)

swap_provider?string
Value in"jupiter""dflow"
created_at?integer

Unix timestamp of order creation

expires_at?|

Unix timestamp for automatic expiration, or null if no expiry

Example Request
curl -X POST 'https://api.indexify.finance/api/limit_orders.php?action=place' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "order_id": "aBcDeFgHiJkLmNoP",  "status": "ACTIVE",  "target_type": "token",  "token_address": "So11111111111111111111111111111111111111112",  "side": "buy",  "condition_type": "lte",  "trigger_price": 120,  "amount": 50,  "stack_id": 0,  "stack_name": "string",  "swap_provider": "jupiter",  "created_at": 0,  "expires_at": 0}