Builder ServiceAPI ReferenceHTTP APIExchange Operations
Exchange: Modify
Modify limit orders or update TP/SL on open trades.
Alpha Version
The Ostium Builder Service is in Alpha. API endpoints, specifications, and builder URLs may change without notice. Use with caution in production environments.
POST /v1/exchange/modify
Builds an unsigned transaction to modify a limit order or update TP/SL on an open trade.
Headers
| Header | Required | Description |
|---|---|---|
X-Trader-Address | Yes | Trader wallet address. |
X-API-Key | No | Delegated mode (delegate wallet must be verified). |
Content-Type | Yes | application/json or text/plain (JSON string). |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
a | number | Yes | Pair index. |
i | number | Yes | Order or trade index. |
p | string | No | New limit order price (numeric string > 0). |
tp | string | No | New take-profit price ("0" resets to default). |
sl | string | No | New stop-loss price ("0" resets to default). |
Constraints
- At least one of
p,tp, orslis required. - If
pis omitted, only one oftporslmay be set per request. - Delegated mode supports one modify action per request.
Response Body (unsigned)
| Field | Type | Required | Description |
|---|---|---|---|
transactions | UnsignedTransaction[] | Yes | One unsigned transaction. |
Response Body (delegated)
| Field | Type | Required | Description |
|---|---|---|---|
txHash | string | Yes | Transaction hash of the delegated action. |
smartAccountAddress | string | Yes | Smart account used for delegation. |
Example Request
curl -X POST https://builder.ostiscan.xyz/v1/exchange/modify \
-H "Content-Type: application/json" \
-H "X-Trader-Address: 0xYourWallet" \
-d '{"a":0,"i":0,"tp":"46000"}'Response (200, unsigned)
{
"transactions": [
{ "to": "0x...", "data": "0x...", "value": "0", "from": "0xYourWallet" }
]
}Response (200, delegated)
{
"txHash": "0x...",
"smartAccountAddress": "0x..."
}Errors
See /docs/errors.