---
title: "Perp Open"
method: POST
path: "/v1/perp/open"
tags: ["perp"]
---

# Perp Open

`POST /v1/perp/open`

## Request

- Base URL: `https://api.fereai.xyz`
- URL: `https://api.fereai.xyz/v1/perp/open`
- Auth: none declared

Open a perpetual position (optionally with a TP/SL bracket).

## Query parameters

- `wait` boolean: Block until task completes
- `timeout` integer: Seconds to block when wait=true (max 90; the ~100s edge cuts longer waits — use wait=false + poll for longer).

## Request body

- PerpOpenRequest
  - `asset` string, required: Perp asset symbol, e.g. 'BTC' or 'ETH'.
  - `is_buy` boolean, required: True to open a long, False to open a short.
  - `size` number, required: Position size in contracts (not smallest units).
  - `leverage` integer: Leverage multiplier.
  - `is_cross` boolean: True for cross margin, False for isolated.
  - `order_type` string: Order type: 'market' or 'limit'.
  - `limit_price` number, nullable: Limit price (required when order_type='limit').
  - `slippage_pct` number: Allowed slippage in percent points (0.5 = 0.5%).
  - `reduce_only` boolean: True to only reduce an existing position.
  - `tp_price` number, nullable: Optional take-profit trigger price (reduce-only bracket attached after open).
  - `sl_price` number, nullable: Optional stop-loss trigger price (reduce-only bracket attached after open).
  - `tp_is_market` boolean: True = market-on-trigger for the take-profit leg.
  - `sl_is_market` boolean: True = market-on-trigger for the stop-loss leg.

## Response `200`

Successful Response

- TaskResponse
  - `task_id` string, required: Celery task ID for tracking the async operation.
  - `status` string: Current task status: queued, pending, started.
  - `poll_url` string, nullable: Relative URL to poll for task status.
  - `notification_stream` string, nullable: SSE stream URL for real-time task updates.

## 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)