Orders
Order management
Signature V1 query or signed form with the complete original immutable placement terms and action=RESOLVE. A PLACE or LOOKUP signature cannot authorize this mutation. Optional signed expectedRequestBinding must match before registration or closure. May arrive before create. A pending response preserves liability; only CLOSED_NO_PLACEMENT excludes both future placement and residual reservation. A placed order still requires the existing settlement/fills contract.
Weight: 2
The ordinary placement family has a bounded pre-authentication IP bucket of 100 requests/second, burst 100. New durable identities (including resolve-before-create) additionally consume an authenticated subject bucket of 2/second, burst 10 and a process allocation bucket of 100/second, burst 100. Exact existing identities do not allocate again. Key rotation does not reset subject admission. HTTP errors never authorize release.
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Signed operation discriminator; V1 does not bind HTTP method or path
Fresh authentication time; may refresh on an exact retry
Authentication freshness window, not placement dispatch authority
Base64 Ed25519 signature of the ordered decoded parameters excluding signature
^[A-Za-z0-9_]+-[A-Za-z0-9_]+$Positive base quantity; mutually exclusive with quoteOrderQty
^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$Positive quote budget; BUY only, preserves venue rounding
^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$Exact positive plain decimal; never binary floating point
^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$Original matching expiry; normalized down to whole-second epoch milliseconds
falseImmutable command-admission deadline; strict now < cutoff, at most 60000ms ahead on new registration
Optional signed assertion of the complete canonical binding; mismatch is rejected before registration, reservation, admission or closure. Outside the economic hash.
^[0-9a-f]{64}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.
Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted. Positive signed 64-bit decimal; physical account must match the selected settlement-domain band.
^[1-9][0-9]{0,18}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted. Positive signed 64-bit decimal; physical account must match the selected settlement-domain band.
^[1-9][0-9]{0,18}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted. Positive signed 64-bit decimal; physical account must match the selected settlement-domain band.
^[1-9][0-9]{0,18}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$^[A-Za-z0-9._-]{1,36}$Exactly one of quantity or BUY-only quoteOrderQty is required. All authority fields are authenticated. Unknown fields, duplicate names and unsigned secondary sources are rejected. expireTime floors to seconds; dispatchDeadline retains milliseconds and may not exceed it. DMS intent is reserved and always refused until the full admission guard chain exists.
Historical placement or durable no-placement evidence
SHA-256 of version domain and canonical scoped request JSON; see frozen fixtures
^[0-9a-f]{64}$Unresolved; retain placement liability
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Capacity or rate limit; no operation outcome
Request failure, never effect-wide no-placement or release authority
PUT /api/v1/order/placement/admission-resolution HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 461
"contract='ORDINARY_PLACEMENT_V1'&action='RESOLVE'×tamp=1&recvWindow=1&signature='text'&symbol='text'&side='BUY'&quantity='text'"eOrderQty='text'&price='text'&expireTime=1&postOnly=false&dispatchDeadline=1&expectedRequestBinding='text'&dmsSettlementDomain='1'&dmsPhysicalAccount='text'&dmsOwnershipRevision='text'&dmsGeneration='text'&dmsGrantId='text'&type='LIMIT'&timeInForce='GTD'&newClientOrderId='text'"{
"contract": "ORDINARY_PLACEMENT_V1",
"status": "PENDING",
"subjectId": "123e4567-e89b-12d3-a456-426614174000",
"ownerId": "123e4567-e89b-12d3-a456-426614174000",
"orderId": "123e4567-e89b-12d3-a456-426614174000",
"accountId": 1,
"baseTokenId": 1,
"quoteTokenId": 1,
"symbolId": 1,
"requestBinding": "text",
"request": {
"symbol": "text",
"side": "BUY",
"clientOrderId": "text",
"quantity": null,
"quoteOrderQty": null,
"price": "text",
"expireTime": 1,
"postOnly": false,
"dispatchDeadline": 1
},
"admittedAt": 1,
"closedAt": 1,
"placementEventId": 1,
"placement": {
"symbol": "PLEX-HBAR",
"orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
"clientOrderId": "myOrder-001",
"transactTime": 1724952746123,
"acceptedExpireTime": 1724952866000
},
"reservationState": "UNRESOLVED"
}Signed V1 query or form. New admission requires ENABLED protocol mode; BRIDGE and DRAIN retain recovery. Exact durable retries recover their historical result before mutable gates. Unknown parameters, duplicates, mixed signed/unsigned sources and every economic amendment are rejected. expireTime is floored to whole seconds. Optional signed dispatchDeadline is an epoch-millisecond caller cutoff, frozen at admission as the earliest of that bound, admission plus ten seconds and the predecessor expiry. Decisions require strictly earlier time. Exact retries retain the original cutoff, including after it passes. The account-scoped renewalId cannot target another order. POST remains PENDING until bounded local ORDER replay reaches a committed result; GET can return historical receipt authority before that mirror.
Weight: 10
Dedicated order_renewal IP bucket: 20 requests/second, burst 4. New admission only: account bucket 2 requests/second, burst 4; exact durable retries bypass that admission bucket. New admission requires ENABLED protocol mode; BRIDGE and DRAIN retain exact retries and historical queries.
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Account-scoped RENEW_V1 idempotency UUID
Exact immutable placement market
Whole-second-aligned predecessor deadline in epoch milliseconds
Absolute new deadline; floor to whole seconds, then require strict extension
Optional signed epoch-millisecond decision cutoff; must exceed admission time and never extends the server budget. Retain the same value on exact retries.
RENEWED and locally applied ORDER result
Durably admitted; result pending or awaiting local ORDER mirror
Malformed closed-world signed request
Stale generation/deadline or idempotency conflict
Unsupported or terminal ineligibility
Rate limited before new admission
New admission disabled, observation timed out, or durable recovery required; retain renewalId
POST /api/v1/order/renew?renewalId=123e4567-e89b-12d3-a456-426614174000&orderId=123e4567-e89b-12d3-a456-426614174000&symbol=text&expectedGeneration=1&expectedExpireTime=1&expireTime=1×tamp=1&signature=text HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"renewalId": "123e4567-e89b-12d3-a456-426614174000",
"orderId": "123e4567-e89b-12d3-a456-426614174000",
"status": "PENDING",
"reason": "text",
"orderChangedByThisRenewal": true,
"requestEventId": 1,
"bookEventId": 1,
"bookExecutionKey": "text",
"oldGeneration": 1,
"newGeneration": 1,
"oldExpireTime": 1,
"acceptedExpireTime": 1,
"acceptedSettlementExpireTime": 1,
"observedGeneration": 1,
"observedExpireTime": 1,
"immutableTermsHash": "text",
"dispatchDeadline": 1,
"decisionTime": "2026-01-01T00:00:00.000Z"
}Attempts an ordered cancel-then-place request while the request remains active. Lambdaplex does not dispatch the replacement unless the old order is finally canceled, but a successful cancel is not rolled back if the replacement is rejected or the request ends before placement.
This endpoint accepts only Signature V1, LIMIT replacements, STOP_ON_FAILURE, and ACK responses. It is inspired by Binance Spot cancel-replace but is not wire-compatible with Binance.
Two semantic profiles are supported. The legacy V1 profile omits both cancelRestrictions and replacementDispatchDeadline; its behavior and its canonical operation identity (lambdaplex.cancel-replace.v1) are unchanged. The safe profile requires both fields together and derives its identity from lambdaplex.cancel-replace.v2, which includes the restriction and the exact dispatch-deadline millisecond; supplying only one field is a pre-mutation 400.
Safe profile guarantees: cancelRestrictions=ONLY_NEW is enforced by the order aggregate at the cancellation linearization point, after every match committed before the book removal has settled or failed. Cancellation completes only while the old order has executed exactly zero base and quote quantity; otherwise the cancellation is durably rejected, the order is not canceled, and the response is COMPLETE / FAILURE / NOT_ATTEMPTED with CANCEL_RESTRICTION_FAILED. A fill, expiry, or conflicting cancellation that wins first keeps its existing definitive classification. A rejected restricted cancellation leaves the old order open but already removed from the book; cancel it through the ordinary cancel path or let it expire.
replacementDispatchDeadline is an absolute epoch-millisecond deadline on the server clock, distinct from the GTD expireTime and never later than the accepted whole-second expiry (the supplied expireTime floored to a whole epoch second). A fresh request whose deadline has passed fails before cancellation with a REPLACEMENT_DISPATCH_DEADLINE_EXPIRED problem; the same problem is returned if the deadline passes after the cancel preflight but before the cancel command is accepted. The deadline is rechecked after cancellation finality, during settlement cleanup and release proof, after reservation evidence, immediately before the replacement reservation is created, and immediately before the placement command is accepted; once it passes no replacement may begin, and a proven cancellation without a replacement returns PARTIAL / SUCCESS / FAILURE with NEW_ORDER_DEADLINE_EXPIRED and PLACE_ORDINARY_ORDER_WITH_FRESH_CLIENT_ID. Recovery always runs first: an identical retry after the deadline still returns an already committed replacement, and an expired retry with no prior operation never starts cancellation. The internal 60-second request deadline remains a separate operational bound.
Supply every parameter in exactly one authenticated source: either the signed query string or an application/x-www-form-urlencoded body. The query declarations below also describe the form fields; mixing query and body input is rejected.
Weight: 50
This endpoint also counts against your Order Count limit (verified API key; observational unless rest.orders-api-enforced is true).
Before authentication, it also consumes one request from a dedicated cancel-replace pre-authentication IP bucket: 5 requests/second with a 30 request burst. HTTP 429 means the caller must back off.
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Trading pair symbol
PLEX-HBARReplacement order side
Replacement order type; this profile accepts only LIMIT
Cancel-replace mode; this profile accepts only STOP_ON_FAILURE
UUID of the order to cancel. At least one cancel selector is required; when both selectors are present they must identify the same order.
11111111-2222-3333-4444-555555555555Original client order ID of the order to cancel. At least one cancel selector is required.
old-quote-001Pattern: ^[A-Za-z0-9._-]{1,36}$Replacement time in force. GTD requires expireTime; postOnly is invalid with IOC or FOK.
Absolute expiry in epoch milliseconds; required only for GTD
1798761600000Prevent the replacement from taking liquidity
falsePositive base quantity; specify exactly one of quantity or quoteOrderQty
1.5Positive quote-asset budget for a BUY replacement; specify exactly one of quantity or quoteOrderQty
100Positive replacement limit price
0.05Client-assigned ID for the replacement and its idempotent retries; it must differ from cancelOrigClientOrderId
new-quote-002Pattern: ^[A-Za-z0-9._-]{1,36}$Replacement response profile; omitted values default to ACK
ACKPossible values: Safe-profile zero-fill restriction; must be supplied together with replacementDispatchDeadline. ONLY_NEW cancels only while the old order has executed exactly zero base and quote quantity, decided by the order aggregate at the cancellation linearization point.
Safe-profile absolute server-clock deadline in epoch milliseconds after which no replacement reservation or placement may begin; must be supplied together with cancelRestrictions and, for GTD, must not be later than the accepted whole-second expireTime (expireTime floored to a whole second). Distinct from expireTime and from the internal request deadline.
1798761540000Signature V1 request timestamp in Unix epoch milliseconds
1786406400000Signature V1 receive window in milliseconds
5000Ed25519 Signature V1 over the ordered parameter payload
Both cancellation and replacement were durably accepted
Preflight rejection (including an already-expired safe-profile dispatch deadline) or definitive cancellation failure (including a refused ONLY_NEW cancellation)
Cancellation succeeded but replacement definitively failed, or pre-cancel replacement provenance conflicts
Too Many Requests - Rate limit exceeded.
Typed uncertain outcome or pre-mutation temporary unavailability
POST /api/v1/order/cancelReplace?symbol=text&side=BUY&type=LIMIT&cancelReplaceMode=STOP_ON_FAILURE&timeInForce=GTC&price=1&newClientOrderId=text×tamp=1&signature=text HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"operationStatus": "COMPLETE",
"cancelCorrelationId": "123e4567-e89b-12d3-a456-426614174000",
"cancelResult": "SUCCESS",
"newOrderResult": "SUCCESS",
"cancelResponse": {
"symbol": "text",
"orderId": "123e4567-e89b-12d3-a456-426614174000",
"origClientOrderId": "text",
"transactTime": 1,
"price": 1,
"origQty": 1,
"executedQty": 1,
"cumulativeQuoteQty": 1,
"status": "OPEN",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY"
},
"newOrderResponse": {
"symbol": "PLEX-HBAR",
"orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
"clientOrderId": "myOrder-001",
"transactTime": 1724952746123,
"acceptedExpireTime": 1724952866000
},
"cancelError": {
"code": "CANCEL_TARGET_NOT_CANCELLABLE",
"message": "text",
"retryable": true
},
"newOrderError": {
"code": "CANCEL_TARGET_NOT_CANCELLABLE",
"message": "text",
"retryable": true
},
"recovery": {
"action": "RETRY_IDENTICAL_SEMANTIC_REQUEST",
"authentication": "REFRESH_TIMESTAMP_RECV_WINDOW_AND_SIGNATURE",
"preserveNewClientOrderId": true,
"reconcileVia": "ORDER_STATUS_AND_USER_DATA"
}
}Places a new order for the authenticated account.
Security
Requires both XApiKey (header) and Ed25519Sig (query) via the global security requirement. The signature is computed over the request query string (including timestamp and any other parameters you send).
Parameter Rules
LIMIT: requiresquantity, orquoteOrderQtyfor BUY orders, pluspriceandtimeInForce.GTD: requires absoluteexpireTimein epoch milliseconds. Lambdaplex floors it to a whole epoch second and returnsacceptedExpireTime.GTCis a compatibility alias forGTDwith the venue's previous default expiry. The ACK returns the canonicalacceptedExpireTime.POST_ONLYis the legacyGTCalias pluspostOnly=true; new clients may instead sendGTCorGTDwithpostOnly=true.MARKET: requiresquantity, orquoteOrderQtyfor BUY orders.A
BOTmay opt a smallMARKETorder, or a small plain base-sizedLIMITorder withtimeInForce=IOC, into network-cost-recovery pricing by signingacceptedMaxTakerBps. The server still tries the normal fee tier first and never charges above the signed ceiling. An earlier/order/fee-quoteresponse is advisory and is not an authorization artifact.A dust-priced
LIMIT IOCnever matches beyondprice, never rests, and expires any unexecuted remainder immediately; a partial fill covers the network-cost target for the executed prefix only.acceptedMaxTakerBpson any otherLIMITtime-in-force, withquoteOrderQty, withpostOnly, or on a stop order is rejected with problemcode=DUST_ORDER_TYPE_NOT_SUPPORTED. An IOC may reportEXPIREDbefore fills from its matched prefix finish settling; follow the order status until settlement reports the final fills.STOP_MARKET: requiresquantity, orquoteOrderQtyfor BUY orders, plusstopPriceandstopComparison.STOP_LIMIT: requiresquantity, orquoteOrderQtyfor BUY orders, plusprice,stopPrice,stopComparison, and either explicitGTDor a legacyGTC/POST_ONLYalias.A successful
postOnly=trueACK confirms durable order placement, not synchronous book admission. The serialized book command later either rests the full executable order without taking liquidity or declines it atomically; a decline is canceled asynchronously and appears on the user-data stream.
Examples (query-string style)
LIMIT BUY GTD:
symbol=PLEX-HBAR&side=BUY&type=LIMIT&timeInForce=GTD&expireTime=1724952866123&quantity=1.5&price=0.01234567&newClientOrderId=myorder-001×tamp=1724952745123LIMIT BUY IOC:
symbol=PLEX-HBAR&side=BUY&type=LIMIT&timeInForce=IOC&quantity=1.5&price=0.01234567&newClientOrderId=myorder-004×tamp=1724952745123LIMIT SELL FOK:
symbol=PLEX-HBAR&side=SELL&type=LIMIT&timeInForce=FOK&quantity=250.0&price=0.01234567&newClientOrderId=myorder-005×tamp=1724952745123LIMIT BUY by quote budget FOK:
symbol=PLEX-HBAR&side=BUY&type=LIMIT&timeInForce=FOK"eOrderQty=100.00&price=0.01234567&newClientOrderId=myorder-006×tamp=1724952745123LIMIT SELL POST_ONLY GTD:
symbol=PLEX-HBAR&side=SELL&type=LIMIT&timeInForce=GTD&expireTime=1724952866123&postOnly=true&quantity=250.0&price=0.01234567&newClientOrderId=myorder-007×tamp=1724952745123MARKET SELL:
symbol=PLEX-HBAR&side=SELL&type=MARKET&quantity=250.0&newClientOrderId=myorder-002×tamp=1724952745123SMALL MARKET BUY WITH FEE CEILING:
symbol=HBAR-USDC&side=BUY&type=MARKET"eOrderQty=1.00&newClientOrderId=myorder-dust-001&acceptedMaxTakerBps=506×tamp=1724952745123SMALL LIMIT IOC BUY WITH FEE CEILING:
symbol=HBAR-USDC&side=BUY&type=LIMIT&timeInForce=IOC&quantity=25&price=0.2210&newClientOrderId=myorder-dust-002&acceptedMaxTakerBps=506×tamp=1724952745123STOP_LIMIT BUY:
symbol=PLEX-HBAR&side=BUY&type=STOP_LIMIT&timeInForce=GTD&expireTime=1724952866123&quantity=100.0&price=0.01200000&stopPrice=0.01150000&newClientOrderId=myorder-003×tamp=1724952745123&stopComparison=LE
Protected ordinary placement
ORDINARY_PLACEMENT_V1 is opt-in: contract, action=PLACE and dispatchDeadline must all be supplied. Only explicit LIMIT/GTD, base quantity or BUY quoteOrderQty, optional postOnly are protected. All protection and DMS fields absent preserves the legacy request and NewOrderAck response. A legacy ACK is never fencing evidence. Query-only or one signed form; never mix sources. Economic fields are immutable across retries. New dispatch requires venueTime < dispatchDeadline; equality is too late. PENDING and all HTTP errors retain liability.
Weight: 1
This endpoint also counts against your Order Count limit (verified API key; observational unless rest.orders-api-enforced is true).
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Required in the chosen query or signed-form source.
^[A-Za-z0-9_]+-[A-Za-z0-9_]+$Required in the chosen query or signed-form source.
Required in the chosen query or signed-form source.
Original matching expiry; normalized down to whole-second epoch milliseconds
falsePositive base quantity; mutually exclusive with quoteOrderQty
^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$Positive quote budget; BUY only, preserves venue rounding
^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$Exact positive plain decimal; never binary floating point
^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$Required in the chosen query or signed-form source.
^[A-Za-z0-9._-]{1,36}$Exact positive plain decimal; never binary floating point
^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$Signed operation discriminator; V1 does not bind HTTP method or path
Required in the chosen query or signed-form source.
Required in the chosen query or signed-form source.
Immutable command-admission deadline; strict now < cutoff, at most 60000ms ahead on new registration
Optional signed assertion of the complete canonical binding; mismatch is rejected before registration, reservation, admission or closure. Outside the economic hash.
^[0-9a-f]{64}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.
Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted. Positive signed 64-bit decimal; physical account must match the selected settlement-domain band.
^[1-9][0-9]{0,18}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted. Positive signed 64-bit decimal; physical account must match the selected settlement-domain band.
^[1-9][0-9]{0,18}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted. Positive signed 64-bit decimal; physical account must match the selected settlement-domain band.
^[1-9][0-9]{0,18}$Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.
^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$Legacy ACK or durable protected placement/closure; inspect contract before interpreting evidence
Protected operation unresolved; no release authorization
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request Timeout — upstream or placement timeout
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Capacity or rate limit; no operation outcome
Server error
Request failure, never effect-wide no-placement or release authority
POST /api/v1/order HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 459
"contract='ORDINARY_PLACEMENT_V1'&action='PLACE'×tamp=1&recvWindow=1&signature='text'&symbol='text'&side='BUY'&quantity='text'"eOrderQty='text'&price='text'&expireTime=1&postOnly=false&dispatchDeadline=1&expectedRequestBinding='text'&dmsSettlementDomain='1'&dmsPhysicalAccount='text'&dmsOwnershipRevision='text'&dmsGeneration='text'&dmsGrantId='text'&type='LIMIT'&timeInForce='GTD'&newClientOrderId='text'"{
"symbol": "PLEX-HBAR",
"orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
"clientOrderId": "myOrder-001",
"transactTime": 1724952746123,
"acceptedExpireTime": 1724952866000
}Deletes an existing order for the authenticated account.
Security
Requires both XApiKey (header) and Ed25519Sig (query) via the global security requirement. The signature is computed over the request query string (including timestamp and any other parameters you send).
Weight: 1
This endpoint also counts against your Order Count limit (verified API key; observational unless rest.orders-api-enforced is true).
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Trading pair symbol
PLEX-HBARPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$Server-assigned order ID (if combined with origClientOrderId, must refer to same order)
26a911ff-f546-eaaf-4b22-e57657b57571Original client-assigned order ID (optional if orderId is set, max 36 chars)
myorder-001Pattern: ^[A-Za-z0-9._-]{1,36}$Order canceled
Acknowledgement returned when an order is canceled
Trading pair symbol
PLEX-HBAROriginal client-supplied order ID (if any, max 36 chars)
myOrder-001Exchange-assigned order ID
26a911ff-f546-eaaf-4b22-e57657b57571Cancel time (ms since epoch)
1724952746123Price for LIMIT/*_LIMIT orders; null for MARKET/STOP orders
0.01234567Original order quantity (base asset)
100Executed quantity (base asset)
25Cumulative quote quantity (quote asset)
0.30864175Canceled order status
CANCELEDPossible values: Time in force for LIMIT/*_LIMIT orders; null otherwise
GTCPossible values: Order type
LIMITPossible values: Order side
BUYPossible values: Bad Request — invalid parameters or an order that is already in a terminal state
Unauthorized — missing/invalid API key or signature
Forbidden — credentials valid but not allowed to cancel orders
Not Found — order cannot be found for the authenticated account
Request Timeout — upstream or placement timeout
Conflict — order cancellation already pending
Too Many Requests - Rate limit exceeded.
Server error
Service Unavailable — trading intake paused, market economics unavailable, or transient database unavailable
DELETE /api/v1/order?symbol=PLEX-HBAR HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"symbol": "PLEX-HBAR",
"origClientOrderId": "myorder-001",
"orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
"transactTime": 1724952746123,
"price": "0.01234567",
"origQty": "100.00000000",
"executedQty": "25.00000000",
"cumulativeQuoteQty": "0.30864175",
"status": "CANCELED",
"timeInForce": "GTC",
"type": "LIMIT",
"side": "BUY",
}
Signed, read-only capability discovery. Match contract and finality exactly before selecting this recovery mode. This static read does not perform an authority barrier.
Weight: 1
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Supported exact protocol
Read-only discovery of the exact order-scoped fills protocol; no authority barrier is performed
Missing or invalid API credentials
Too Many Requests - Rate limit exceeded.
Service Unavailable
GET /api/v2/order/fills/capability HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"contract": "ORDER_SCOPED_FILLS_V1",
"finality": "SETTLEMENT_FINAL",
"endpoint": "/api/v2/order/fills",
"maxLimit": 500,
"eventShardCount": 64,
"requestWeight": 5
}Signed like /api/v2/myTrades with the API key header and Signature V1 query parameters. Supply symbol in its exact venue casing (for example, gib-USDC) and orderId and/or origClientOrderId; both identities must agree. Symbols are not case-normalized. Client IDs deterministically resolve through OrderIds.orderIdFromClientId(authenticatedUserId, clientId), so an unacknowledged replacement can be named before an exchange ID is received.
Initial requests omit both frontier vectors and capturedAt, with pageAfterCursorId zero. The server captures a single committed primary event frontier T for ORDER and FILL, waits for both projections, checks poison, reconstructs order state through T, and bounds fills by T. Continuations echo both 64-entry comma-separated vectors and capturedAt unchanged and pass nextPageAfterCursorId. They retain the initial cut and do not create a new absence proof. A full page can be exhausted: hasMore is authoritative and nextPageAfterCursorId is then null.
ABSENT is HTTP 200 with order null and no fills, after proving the fresh ORDER frontier; another account's order is also ABSENT, while an owned order on a different symbol is 400. Only a fresh initial ABSENT captured after a cancel-replace dispatch deadline proves no placement. Consumers must require contract ORDER_SCOPED_FILLS_V1 and finality SETTLEMENT_FINAL exactly.
Exact accounting requires an original placement newer than the persistent coverage boundary recorded at first fenced startup. Older orders return 503 on initial and continuation reads, even after historical claim healing; capability does not make historical orders eligible. Proven historical ineligibility adds code ORDER_FILLS_HISTORY_INELIGIBLE and retryable false to the problem response. Other controller-originated 503 failures omit both fields. Classify this permanent outcome by the code, never by the human-readable detail text.
settledExecutedQty and settledCumulativeQuoteQty are totals across ALL pages at this cut; pageSettledExecutedQty and pageSettledCumulativeQuoteQty exactly sum this page's fills. pendingSettlementQty = order.executedQty - settledExecutedQty describes outstanding matched quantity. A terminal order with pendingSettlementQty zero has no future fills forever. terminal is a conservative recovery proof: it can become true on a later continuation when release evidence becomes available; status, quantities, and fill membership remain frozen. Self-trades return this order's single leg with selfTrade true and this order's side. Inconsistent cuts fail closed with 503. Success and controller errors are non-cacheable.
Weight: 5
This route also consumes one request from the shared correctness-critical account/fill barrier pre-authentication IP bucket: 100 requests/second with a 500 request burst. GET /api/v1/account/reconciliationSnapshot, GET /api/v1/account/balanceCut, GET /api/v2/myTrades, and GET /api/v2/order/fills use the same bucket, so alternating between them does not create additional database-barrier capacity.
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Trading pair in its exact venue casing, as returned by exchangeInfo
gib-USDC0Present order or frontier-proven absence
Order-scoped settlement-final fills and order status from one immutable event cut
Exact sum of base quantities across all pages in this frozen order scan
Exact sum of quote quantities across all pages in this frozen order scan
executedQty minus settledExecutedQty; non-negative matched quantity awaiting settlement
Exact sum of fills[].qty on this page
Exact sum of fills[].quoteQty on this page
Exclusive durable page cursor; null exactly when this frozen scan is exhausted
Invalid parameters, disagreeing identities, or symbol mismatch
Missing or invalid API credentials
Too Many Requests - Rate limit exceeded.
Sanitized internal invariant failure
Proven historical ineligibility (code ORDER_FILLS_HISTORY_INELIGIBLE, retryable false), or projection lag, poison, unhealthy projection, inconsistent cut, or primary unavailable (without those extensions)
GET /api/v2/order/fills?symbol=text HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"contract": "ORDER_SCOPED_FILLS_V1",
"finality": "SETTLEMENT_FINAL",
"symbol": "gib-USDC",
"presence": "PRESENT",
"frontier": {
"orderProjectionThroughEventIds": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
128,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"fillProjectionThroughEventIds": [
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
128,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0,
0
],
"capturedAt": 1789000012000
},
"order": {
"orderId": "11111111-2222-3333-4444-555555555555",
"clientOrderId": "old-quote-001",
"side": "BUY",
"type": "LIMIT",
"timeInForce": "GTD",
"postOnly": true,
"price": "0.00237353",
"origQty": "21000",
"executedQty": "5000",
"cumulativeQuoteQty": "11.86765",
"status": "CANCELED",
"terminal": true,
"time": 1789000000000,
"updateTime": 1789000012000,
"expireTime": 1789000120000
},
"settledExecutedQty": "5000",
"settledCumulativeQuoteQty": "11.86765",
"pendingSettlementQty": "0",
"pageSettledExecutedQty": "5000",
"pageSettledCumulativeQuoteQty": "11.86765",
"fills": [
{
"cursorId": 131072,
"projectionShard": 17,
"orderId": "11111111-2222-3333-4444-555555555555",
"price": "0.00237353",
"qty": "5000",
"quoteQty": "11.86765",
"commission": "0",
"commissionAsset": "gib",
"time": 1789000010000,
"isBuyer": true,
"isMaker": true,
"selfTrade": false
}
],
"hasMore": false,
"nextPageAfterCursorId": null
}Signed V1 account-scoped renewalId. Returns the stored BOOK decision even while its ORDER mirror is pending; does not clear the pending slot or assert that the order remains live. GET returns HTTP 200 for every stored business outcome.
Weight: 10
Dedicated order_renewal IP bucket: 20 requests/second, burst 4. New admission only: account bucket 2 requests/second, burst 4; exact durable retries bypass that admission bucket. New admission requires ENABLED protocol mode; BRIDGE and DRAIN retain exact retries and historical queries.
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Exact historical renewal outcome
No owned renewal exists
Too Many Requests - Rate limit exceeded.
Durable recovery evidence unavailable
GET /api/v1/order/renewal?renewalId=123e4567-e89b-12d3-a456-426614174000×tamp=1&signature=text HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"renewalId": "123e4567-e89b-12d3-a456-426614174000",
"orderId": "123e4567-e89b-12d3-a456-426614174000",
"status": "PENDING",
"reason": "text",
"orderChangedByThisRenewal": true,
"requestEventId": 1,
"bookEventId": 1,
"bookExecutionKey": "text",
"oldGeneration": 1,
"newGeneration": 1,
"oldExpireTime": 1,
"acceptedExpireTime": 1,
"acceptedSettlementExpireTime": 1,
"observedGeneration": 1,
"observedExpireTime": 1,
"immutableTermsHash": "text",
"dispatchDeadline": 1,
"decisionTime": "2026-01-01T00:00:00.000Z"
}Authenticated Signature V1 query: contract=ORDINARY_PLACEMENT_V1 and action=CAPABILITY. Optional signed symbol returns current authenticated scope and EXPECTED_REQUEST_BINDING_V1 support. Discovery is read-only and never evidence that a particular operation is protected or closed.
Weight: 2
The ordinary placement family has a bounded pre-authentication IP bucket of 100 requests/second, burst 100. New durable identities (including resolve-before-create) additionally consume an authenticated subject bucket of 2/second, burst 10 and a process allocation bucket of 100/second, burst 100. Exact existing identities do not allocate again. Key rotation does not reset subject admission. HTTP errors never authorize release.
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Signed operation discriminator; V1 does not bind HTTP method or path
Fresh authentication time; may refresh on an exact retry
Authentication freshness window, not placement dispatch authority
Base64 Ed25519 signature of the ordered decoded parameters excluding signature
Optional exact wire symbol; returns authenticated scope for automatic binding
^[A-Za-z0-9_]+-[A-Za-z0-9_]+$Supported contract discovery; never an operation proof
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Capacity or rate limit; no operation outcome
Request failure, never effect-wide no-placement or release authority
GET /api/v1/order/placement/capability?contract=ORDINARY_PLACEMENT_V1&action=CAPABILITY×tamp=1&signature=text HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"contract": "ORDINARY_PLACEMENT_V1",
"enabled": true,
"maxDispatchHorizonMillis": 60000,
"supportedOrderShapes": [
"text"
],
"authentication": "SIGNATURE_V1_WITH_ACTION",
"deadlineBoundary": "text",
"bindingAssertion": "EXPECTED_REQUEST_BINDING_V1",
"scope": {
"symbol": "text",
"subjectId": "123e4567-e89b-12d3-a456-426614174000",
"ownerId": "123e4567-e89b-12d3-a456-426614174000",
"accountId": 1,
"baseTokenId": 1,
"quoteTokenId": 1,
"symbolId": 1
}
}Domain-read-only Signature V1 query: contract=ORDINARY_PLACEMENT_V1, action=LOOKUP, newClientOrderId. A missing operation returns 404 and creates no admission fence. Neither 404 nor any transport error authorizes release.
Weight: 2
The ordinary placement family has a bounded pre-authentication IP bucket of 100 requests/second, burst 100. New durable identities (including resolve-before-create) additionally consume an authenticated subject bucket of 2/second, burst 10 and a process allocation bucket of 100/second, burst 100. Exact existing identities do not allocate again. Key rotation does not reset subject admission. HTTP errors never authorize release.
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Signed operation discriminator; V1 does not bind HTTP method or path
Fresh authentication time; may refresh on an exact retry
Authentication freshness window, not placement dispatch authority
Base64 Ed25519 signature of the ordered decoded parameters excluding signature
^[A-Za-z0-9._-]{1,36}$Historical placement or durable no-placement evidence
SHA-256 of version domain and canonical scoped request JSON; see frozen fixtures
^[0-9a-f]{64}$Unresolved; retain placement liability
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Request failure, never effect-wide no-placement or release authority
Capacity or rate limit; no operation outcome
Request failure, never effect-wide no-placement or release authority
GET /api/v1/order/placement?contract=ORDINARY_PLACEMENT_V1&action=LOOKUP×tamp=1&signature=text&newClientOrderId=text HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"contract": "ORDINARY_PLACEMENT_V1",
"status": "PENDING",
"subjectId": "123e4567-e89b-12d3-a456-426614174000",
"ownerId": "123e4567-e89b-12d3-a456-426614174000",
"orderId": "123e4567-e89b-12d3-a456-426614174000",
"accountId": 1,
"baseTokenId": 1,
"quoteTokenId": 1,
"symbolId": 1,
"requestBinding": "text",
"request": {
"symbol": "text",
"side": "BUY",
"clientOrderId": "text",
"quantity": null,
"quoteOrderQty": null,
"price": "text",
"expireTime": 1,
"postOnly": false,
"dispatchDeadline": 1
},
"admittedAt": 1,
"closedAt": 1,
"placementEventId": 1,
"placement": {
"symbol": "PLEX-HBAR",
"orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
"clientOrderId": "myOrder-001",
"transactTime": 1724952746123,
"acceptedExpireTime": 1724952866000
},
"reservationState": "UNRESOLVED"
}Returns an advisory fee preview for the authenticated API account. If acceptedMaxTakerBps is sent, it is part of the signed request and bounds the preview. Placement independently reprices the order and requires its own signed maximum taker BPS.
typedefaults toMARKET, preserving the existing contract (quantityor BUY-onlyquoteOrderQty;timeInForceandpriceare rejected).type=LIMITpreviews the exact intended plainLIMITorder and requirestimeInForce=IOC,quantity, andprice. Only liquidity executable at or better thanpriceis considered, walked in price-time priority with the same self-trade, maker-leg, settlement-shape, rounding, and eligibility rules as IOC execution. Orders that clear the normal minimum are previewed at the normal fee; below it, the largest fee-feasible executable prefix under the ceiling is previewed asDUST.Any other
LIMITtime-in-force,quoteOrderQtywithLIMIT, and stop order types are rejected with problemcode=DUST_ORDER_TYPE_NOT_SUPPORTED. See theDUST_ORDER_POLICYexchange-info filter'ssupportedOrderShapes.The response echoes
type, and forLIMITalsotimeInForceandprice.Dust-preview rate limits are shared across markets for the account. Exhaustion returns HTTP 429 with
Retry-Afterseconds and problemstage=RATE_LIMIT; wait before re-signing and retrying a preview.
Example: symbol=HBAR-USDC&side=BUY&type=LIMIT&timeInForce=IOC&quantity=25&price=0.2210&acceptedMaxTakerBps=506×tamp=1724952745123
Weight: 1
Ed25519 signature of payload
API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.
Order side
Supported order types. LIMIT supports GTC/GTD/IOC/FOK/POST_ONLY. STOP_LIMIT supports explicit GTD and the legacy GTC/POST_ONLY aliases. MARKET and STOP_MARKET require quantity and reject timeInForce. STOP_LIMIT additionally requires price, stopPrice, and stopComparison. STOP_MARKET additionally requires stopPrice and stopComparison.
Applied to LIMIT and STOP_LIMIT orders. Explicit GTD requires expireTime. GTC aliases to GTD with the venue default expiry; POST_ONLY is that alias plus postOnly=true. IOC and FOK are immediate LIMIT policies.
OK
Too Many Requests - Rate limit exceeded.
Service Unavailable
GET /api/v1/order/fee-quote?symbol=text&side=BUY HTTP/1.1
Host: api.lambdaplex.io
X-API-KEY: YOUR_API_KEY
Accept: */*
{
"symbol": "text",
"filled": 1,
"exchanged": 1,
"vwap": 1,
"slippage": 1,
"feePreview": {
"regime": "text",
"normalTakerBps": 1,
"estimatedAppliedTakerBps": 1,
"acceptedMaxTakerBpsRequired": 1,
"estimatedTakerFee": {
"asset": "text",
"amount": 1
},
"estimatedTakerFeeUsd": 1,
"estimatedNetReceived": {
"asset": "text",
"amount": 1
},
"expiresAt": "2026-01-01T00:00:00.000Z"
},
"type": "text",
"timeInForce": "text",
"price": 1
}Last updated