Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Orders

Order management

Resolve or durably close ordinary placement admission

put

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.

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
contractstring · enumOptionalPossible values:
actionstring · enumOptional

Signed operation discriminator; V1 does not bind HTTP method or path

Possible values:
timestampinteger · int64 · min: 1 · max: 253402300799999Optional

Fresh authentication time; may refresh on an exact retry

recvWindowinteger · int64 · min: 1 · max: 253402300799999Optional

Authentication freshness window, not placement dispatch authority

signaturestringOptional

Base64 Ed25519 signature of the ordered decoded parameters excluding signature

symbolstring · min: 3 · max: 33OptionalPattern: ^[A-Za-z0-9_]+-[A-Za-z0-9_]+$
sidestring · enumOptionalPossible values:
quantitystringOptional

Positive base quantity; mutually exclusive with quoteOrderQty

Pattern: ^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$
quoteOrderQtystringOptional

Positive quote budget; BUY only, preserves venue rounding

Pattern: ^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$
pricestringOptional

Exact positive plain decimal; never binary floating point

Pattern: ^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$
expireTimeinteger · int64 · min: 1 · max: 253402300799999Optional

Original matching expiry; normalized down to whole-second epoch milliseconds

postOnlybooleanOptionalDefault: false
dispatchDeadlineinteger · int64 · min: 1 · max: 253402300799999Optional

Immutable command-admission deadline; strict now < cutoff, at most 60000ms ahead on new registration

expectedRequestBindingstringOptional

Optional signed assertion of the complete canonical binding; mismatch is rejected before registration, reservation, admission or closure. Outside the economic hash.

Pattern: ^[0-9a-f]{64}$
dmsSettlementDomainstring · enumOptional

Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.

Possible values:
dmsPhysicalAccountstringOptional

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.

Pattern: ^[1-9][0-9]{0,18}$
dmsOwnershipRevisionstringOptional

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.

Pattern: ^[1-9][0-9]{0,18}$
dmsGenerationstringOptional

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.

Pattern: ^[1-9][0-9]{0,18}$
dmsGrantIdstringOptional

Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
typestring · enumOptionalPossible values:
timeInForcestring · enumOptionalPossible values:
newClientOrderIdstring · min: 1 · max: 36OptionalPattern: ^[A-Za-z0-9._-]{1,36}$
Body

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.

anyOptional
orand
anyOptional
Responses
200

Historical placement or durable no-placement evidence

application/json
contractstring · enumRequiredPossible values:
statusstring · enumRequiredPossible values:
subjectIdstring · uuidRequired
ownerIdstring · uuidRequired
orderIdstring · uuidRequired
accountIdinteger · int64Required
baseTokenIdinteger · int64Required
quoteTokenIdinteger · int64Required
symbolIdinteger · int64Required
requestBindingstringRequired

SHA-256 of version domain and canonical scoped request JSON; see frozen fixtures

Pattern: ^[0-9a-f]{64}$
admittedAtinteger · int64 · min: 1 · max: 253402300799999Optional
closedAtinteger · int64 · min: 1 · max: 253402300799999Optional
placementEventIdinteger · int64 · min: 1Optional
reservationStatestring · enumRequiredPossible values:
put/api/v1/order/placement/admission-resolution
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'&timestamp=1&recvWindow=1&signature='text'&symbol='text'&side='BUY'&quantity='text'&quoteOrderQty='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"
}

Renew only the expiry of an existing order

post

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.

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
renewalIdstring · uuidRequired

Account-scoped RENEW_V1 idempotency UUID

orderIdstring · uuidRequired
symbolstringRequired

Exact immutable placement market

expectedGenerationinteger · int64 · max: 9223372036854776000Required
expectedExpireTimeinteger · int64Required

Whole-second-aligned predecessor deadline in epoch milliseconds

expireTimeinteger · int64Required

Absolute new deadline; floor to whole seconds, then require strict extension

dispatchDeadlineinteger · int64 · min: 1 · max: 253402300799999Optional

Optional signed epoch-millisecond decision cutoff; must exceed admission time and never extends the server budget. Retain the same value on exact retries.

timestampinteger · int64Required
recvWindowinteger · int64Optional
signaturestringRequired
Responses
200

RENEWED and locally applied ORDER result

application/json
renewalIdstring · uuidOptional
orderIdstring · uuidOptional
statusstring · enumOptionalPossible values:
reasonstringOptional
orderChangedByThisRenewalbooleanOptional
requestEventIdinteger · int64Optional
bookEventIdinteger · int64Optional
bookExecutionKeystringOptional
oldGenerationinteger · int64Optional
newGenerationinteger · int64Optional
oldExpireTimeinteger · int64Optional
acceptedExpireTimeinteger · int64Optional
acceptedSettlementExpireTimeinteger · int64Optional
observedGenerationinteger · int64Optional
observedExpireTimeinteger · int64Optional
immutableTermsHashstringOptional
dispatchDeadlineinteger · int64Optional
decisionTimestring · date-timeOptional
post/api/v1/order/renew
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&timestamp=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"
}

Cancel an order and conditionally place its replacement

post

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.

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
symbolstring · min: 1Required

Trading pair symbol

Example: PLEX-HBAR
sidestring · enumRequired

Replacement order side

Possible values:
typestring · enumRequired

Replacement order type; this profile accepts only LIMIT

Possible values:
cancelReplaceModestring · enumRequired

Cancel-replace mode; this profile accepts only STOP_ON_FAILURE

Possible values:
cancelOrderIdstring · uuidOptional

UUID of the order to cancel. At least one cancel selector is required; when both selectors are present they must identify the same order.

Example: 11111111-2222-3333-4444-555555555555
cancelOrigClientOrderIdstring · min: 1 · max: 36Optional

Original client order ID of the order to cancel. At least one cancel selector is required.

Example: old-quote-001Pattern: ^[A-Za-z0-9._-]{1,36}$
timeInForcestring · enumRequired

Replacement time in force. GTD requires expireTime; postOnly is invalid with IOC or FOK.

Possible values:
expireTimeinteger · int64 · min: 1Optional

Absolute expiry in epoch milliseconds; required only for GTD

Example: 1798761600000
postOnlybooleanOptional

Prevent the replacement from taking liquidity

Default: false
quantitynumberOptional

Positive base quantity; specify exactly one of quantity or quoteOrderQty

Example: 1.5
quoteOrderQtynumberOptional

Positive quote-asset budget for a BUY replacement; specify exactly one of quantity or quoteOrderQty

Example: 100
pricenumberRequired

Positive replacement limit price

Example: 0.05
newClientOrderIdstring · min: 1 · max: 36Required

Client-assigned ID for the replacement and its idempotent retries; it must differ from cancelOrigClientOrderId

Example: new-quote-002Pattern: ^[A-Za-z0-9._-]{1,36}$
newOrderRespTypestring · enumOptional

Replacement response profile; omitted values default to ACK

Default: ACKPossible values:
cancelRestrictionsstring · enumOptional

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.

Possible values:
replacementDispatchDeadlineinteger · int64 · min: 1Optional

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.

Example: 1798761540000
timestampinteger · int64Required

Signature V1 request timestamp in Unix epoch milliseconds

Example: 1786406400000
recvWindowinteger · int64 · min: 1Optional

Signature V1 receive window in milliseconds

Example: 5000
signaturestring · min: 1Required

Ed25519 Signature V1 over the ordered parameter payload

Responses
200

Both cancellation and replacement were durably accepted

application/json
operationStatusstring · enumOptionalPossible values:
cancelCorrelationIdstring · uuidOptional
cancelResultstring · enumOptionalPossible values:
newOrderResultstring · enumOptionalPossible values:
post/api/v1/order/cancelReplace
POST /api/v1/order/cancelReplace?symbol=text&side=BUY&type=LIMIT&cancelReplaceMode=STOP_ON_FAILURE&timeInForce=GTC&price=1&newClientOrderId=text&timestamp=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"
  }
}

Place a legacy or protected ordinary order

post

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: requires quantity, or quoteOrderQty for BUY orders, plus price and timeInForce.

  • GTD: requires absolute expireTime in epoch milliseconds. Lambdaplex floors it to a whole epoch second and returns acceptedExpireTime.

  • GTC is a compatibility alias for GTD with the venue's previous default expiry. The ACK returns the canonical acceptedExpireTime.

  • POST_ONLY is the legacy GTC alias plus postOnly=true; new clients may instead send GTC or GTD with postOnly=true.

  • MARKET: requires quantity, or quoteOrderQty for BUY orders.

  • A BOT may opt a small MARKET order, or a small plain base-sized LIMIT order with timeInForce=IOC, into network-cost-recovery pricing by signing acceptedMaxTakerBps. The server still tries the normal fee tier first and never charges above the signed ceiling. An earlier /order/fee-quote response is advisory and is not an authorization artifact.

  • A dust-priced LIMIT IOC never matches beyond price, never rests, and expires any unexecuted remainder immediately; a partial fill covers the network-cost target for the executed prefix only. acceptedMaxTakerBps on any other LIMIT time-in-force, with quoteOrderQty, with postOnly, or on a stop order is rejected with problem code=DUST_ORDER_TYPE_NOT_SUPPORTED. An IOC may report EXPIRED before fills from its matched prefix finish settling; follow the order status until settlement reports the final fills.

  • STOP_MARKET: requires quantity, or quoteOrderQty for BUY orders, plus stopPrice and stopComparison.

  • STOP_LIMIT: requires quantity, or quoteOrderQty for BUY orders, plus price, stopPrice, stopComparison, and either explicit GTD or a legacy GTC/POST_ONLY alias.

  • A successful postOnly=true ACK 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&timestamp=1724952745123

  • LIMIT BUY IOC: symbol=PLEX-HBAR&side=BUY&type=LIMIT&timeInForce=IOC&quantity=1.5&price=0.01234567&newClientOrderId=myorder-004&timestamp=1724952745123

  • LIMIT SELL FOK: symbol=PLEX-HBAR&side=SELL&type=LIMIT&timeInForce=FOK&quantity=250.0&price=0.01234567&newClientOrderId=myorder-005&timestamp=1724952745123

  • LIMIT BUY by quote budget FOK: symbol=PLEX-HBAR&side=BUY&type=LIMIT&timeInForce=FOK&quoteOrderQty=100.00&price=0.01234567&newClientOrderId=myorder-006&timestamp=1724952745123

  • LIMIT 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&timestamp=1724952745123

  • MARKET SELL: symbol=PLEX-HBAR&side=SELL&type=MARKET&quantity=250.0&newClientOrderId=myorder-002&timestamp=1724952745123

  • SMALL MARKET BUY WITH FEE CEILING: symbol=HBAR-USDC&side=BUY&type=MARKET&quoteOrderQty=1.00&newClientOrderId=myorder-dust-001&acceptedMaxTakerBps=506&timestamp=1724952745123

  • SMALL 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&timestamp=1724952745123

  • STOP_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&timestamp=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).

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
symbolstring · min: 3 · max: 33Optional

Required in the chosen query or signed-form source.

Pattern: ^[A-Za-z0-9_]+-[A-Za-z0-9_]+$
sidestring · enumOptional

Required in the chosen query or signed-form source.

Possible values:
typestring · enumOptional

Required in the chosen query or signed-form source.

Possible values:
timeInForcestring · enumOptionalPossible values:
expireTimeinteger · int64 · min: 1 · max: 253402300799999Optional

Original matching expiry; normalized down to whole-second epoch milliseconds

postOnlybooleanOptionalDefault: false
quantitystringOptional

Positive base quantity; mutually exclusive with quoteOrderQty

Pattern: ^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$
quoteOrderQtystringOptional

Positive quote budget; BUY only, preserves venue rounding

Pattern: ^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$
pricestringOptional

Exact positive plain decimal; never binary floating point

Pattern: ^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$
newClientOrderIdstring · min: 1 · max: 36Optional

Required in the chosen query or signed-form source.

Pattern: ^[A-Za-z0-9._-]{1,36}$
acceptedMaxTakerBpsinteger · int32 · max: 9999Optional
stopPricestringOptional

Exact positive plain decimal; never binary floating point

Pattern: ^(?:0|[1-9][0-9]{0,37})(?:\.[0-9]{1,38})?$
stopComparisonstring · enumOptionalPossible values:
contractstring · enumOptionalPossible values:
actionstring · enumOptional

Signed operation discriminator; V1 does not bind HTTP method or path

Possible values:
timestampinteger · int64 · min: 1 · max: 253402300799999Optional

Required in the chosen query or signed-form source.

recvWindowinteger · int64 · min: 1 · max: 253402300799999Optional
signaturestringOptional

Required in the chosen query or signed-form source.

dispatchDeadlineinteger · int64 · min: 1 · max: 253402300799999Optional

Immutable command-admission deadline; strict now < cutoff, at most 60000ms ahead on new registration

expectedRequestBindingstringOptional

Optional signed assertion of the complete canonical binding; mismatch is rejected before registration, reservation, admission or closure. Outside the economic hash.

Pattern: ^[0-9a-f]{64}$
dmsSettlementDomainstring · enumOptional

Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.

Possible values:
dmsPhysicalAccountstringOptional

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.

Pattern: ^[1-9][0-9]{0,18}$
dmsOwnershipRevisionstringOptional

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.

Pattern: ^[1-9][0-9]{0,18}$
dmsGenerationstringOptional

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.

Pattern: ^[1-9][0-9]{0,18}$
dmsGrantIdstringOptional

Reserved signed DMS intent: supply all five dms fields or none. Complete intent currently returns 422 UNSUPPORTED_PLACEMENT_PROFILE; no DMS placement is admitted.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
Body
or
Responses
200

Legacy ACK or durable protected placement/closure; inspect contract before interpreting evidence

application/json
or
post/api/v1/order
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'&timestamp=1&recvWindow=1&signature='text'&symbol='text'&side='BUY'&quantity='text'&quoteOrderQty='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
}

Cancel an existing order

delete

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

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: PLEX-HBARPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
orderIdstring · uuidOptional

Server-assigned order ID (if combined with origClientOrderId, must refer to same order)

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
origClientOrderIdstring · min: 1 · max: 36Optional

Original client-assigned order ID (optional if orderId is set, max 36 chars)

Example: myorder-001Pattern: ^[A-Za-z0-9._-]{1,36}$
Responses
200

Order canceled

application/json

Acknowledgement returned when an order is canceled

symbolstringOptional

Trading pair symbol

Example: PLEX-HBAR
origClientOrderIdstring · max: 36Optional

Original client-supplied order ID (if any, max 36 chars)

Example: myOrder-001
orderIdstringOptional

Exchange-assigned order ID

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
transactTimeinteger · int64Optional

Cancel time (ms since epoch)

Example: 1724952746123
pricenumberOptional

Price for LIMIT/*_LIMIT orders; null for MARKET/STOP orders

Example: 0.01234567
origQtynumberOptional

Original order quantity (base asset)

Example: 100
executedQtynumberOptional

Executed quantity (base asset)

Example: 25
cumulativeQuoteQtynumberOptional

Cumulative quote quantity (quote asset)

Example: 0.30864175
statusstring · enumOptional

Canceled order status

Example: CANCELEDPossible values:
timeInForcestring · enumOptional

Time in force for LIMIT/*_LIMIT orders; null otherwise

Example: GTCPossible values:
typestring · enumOptional

Order type

Example: LIMITPossible values:
sidestring · enumOptional

Order side

Example: BUYPossible values:
delete/api/v1/order
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",
}

Discover the supported order-scoped fills contract

get

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

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Responses
200

Supported exact protocol

application/json

Read-only discovery of the exact order-scoped fills protocol; no authority barrier is performed

contractstring · enumOptionalPossible values:
finalitystring · enumOptionalPossible values:
endpointstringOptional
maxLimitinteger · int32Optional
eventShardCountinteger · int32Optional
requestWeightinteger · int32Optional
get/api/v2/order/fills/capability
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
}

Read one order and its settlement-final fills from a frozen frontier

get

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.

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
symbolstringRequired

Trading pair in its exact venue casing, as returned by exchangeInfo

Example: gib-USDC
orderIdstringOptional
origClientOrderIdstringOptional
limitstring · min: 1 · max: 500Optional
pageAfterCursorIdinteger · int64OptionalDefault: 0
orderProjectionThroughEventIdsstringOptional
fillProjectionThroughEventIdsstringOptional
capturedAtinteger · int64Optional
Responses
200

Present order or frontier-proven absence

application/json

Order-scoped settlement-final fills and order status from one immutable event cut

contractstring · enumOptionalPossible values:
finalitystring · enumOptionalPossible values:
symbolstringOptional
presencestring · enumOptionalPossible values:
settledExecutedQtystringOptional

Exact sum of base quantities across all pages in this frozen order scan

settledCumulativeQuoteQtystringOptional

Exact sum of quote quantities across all pages in this frozen order scan

pendingSettlementQtystringOptional

executedQty minus settledExecutedQty; non-negative matched quantity awaiting settlement

pageSettledExecutedQtystringOptional

Exact sum of fills[].qty on this page

pageSettledCumulativeQuoteQtystringOptional

Exact sum of fills[].quoteQty on this page

hasMorebooleanOptional
nextPageAfterCursorIdinteger · int64Optional

Exclusive durable page cursor; null exactly when this frozen scan is exhausted

get/api/v2/order/fills
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
}

Query the exact durable renewal operation

get

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.

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
renewalIdstring · uuidRequired
timestampinteger · int64Required
recvWindowinteger · int64Optional
signaturestringRequired
Responses
200

Exact historical renewal outcome

application/json
renewalIdstring · uuidOptional
orderIdstring · uuidOptional
statusstring · enumOptionalPossible values:
reasonstringOptional
orderChangedByThisRenewalbooleanOptional
requestEventIdinteger · int64Optional
bookEventIdinteger · int64Optional
bookExecutionKeystringOptional
oldGenerationinteger · int64Optional
newGenerationinteger · int64Optional
oldExpireTimeinteger · int64Optional
acceptedExpireTimeinteger · int64Optional
acceptedSettlementExpireTimeinteger · int64Optional
observedGenerationinteger · int64Optional
observedExpireTimeinteger · int64Optional
immutableTermsHashstringOptional
dispatchDeadlineinteger · int64Optional
decisionTimestring · date-timeOptional
get/api/v1/order/renewal
GET /api/v1/order/renewal?renewalId=123e4567-e89b-12d3-a456-426614174000&timestamp=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"
}

Identify the supported ordinary placement contract

get

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.

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
contractstring · enumRequiredPossible values:
actionstring · enumRequired

Signed operation discriminator; V1 does not bind HTTP method or path

Possible values:
timestampinteger · int64 · min: 1 · max: 253402300799999Required

Fresh authentication time; may refresh on an exact retry

recvWindowinteger · int64 · min: 1 · max: 253402300799999Optional

Authentication freshness window, not placement dispatch authority

signaturestringRequired

Base64 Ed25519 signature of the ordered decoded parameters excluding signature

symbolstring · min: 3 · max: 33Optional

Optional exact wire symbol; returns authenticated scope for automatic binding

Pattern: ^[A-Za-z0-9_]+-[A-Za-z0-9_]+$
Responses
200

Supported contract discovery; never an operation proof

application/json
contractstring · enumRequiredPossible values:
enabledbooleanRequired
maxDispatchHorizonMillisinteger · enumRequiredPossible values:
supportedOrderShapesstring[]Required
authenticationstring · enumRequiredPossible values:
deadlineBoundarystringRequired
bindingAssertionstring · enumOptionalPossible values:
get/api/v1/order/placement/capability
GET /api/v1/order/placement/capability?contract=ORDINARY_PLACEMENT_V1&action=CAPABILITY&timestamp=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
  }
}

Read a durable ordinary placement operation

get

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.

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
contractstring · enumRequiredPossible values:
actionstring · enumRequired

Signed operation discriminator; V1 does not bind HTTP method or path

Possible values:
timestampinteger · int64 · min: 1 · max: 253402300799999Required

Fresh authentication time; may refresh on an exact retry

recvWindowinteger · int64 · min: 1 · max: 253402300799999Optional

Authentication freshness window, not placement dispatch authority

signaturestringRequired

Base64 Ed25519 signature of the ordered decoded parameters excluding signature

newClientOrderIdstring · min: 1 · max: 36RequiredPattern: ^[A-Za-z0-9._-]{1,36}$
Responses
200

Historical placement or durable no-placement evidence

application/json
contractstring · enumRequiredPossible values:
statusstring · enumRequiredPossible values:
subjectIdstring · uuidRequired
ownerIdstring · uuidRequired
orderIdstring · uuidRequired
accountIdinteger · int64Required
baseTokenIdinteger · int64Required
quoteTokenIdinteger · int64Required
symbolIdinteger · int64Required
requestBindingstringRequired

SHA-256 of version domain and canonical scoped request JSON; see frozen fixtures

Pattern: ^[0-9a-f]{64}$
admittedAtinteger · int64 · min: 1 · max: 253402300799999Optional
closedAtinteger · int64 · min: 1 · max: 253402300799999Optional
placementEventIdinteger · int64 · min: 1Optional
reservationStatestring · enumRequiredPossible values:
get/api/v1/order/placement
GET /api/v1/order/placement?contract=ORDINARY_PLACEMENT_V1&action=LOOKUP&timestamp=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"
}

Preview the fee regime for a MARKET or plain LIMIT IOC order

get

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.

  • type defaults to MARKET, preserving the existing contract (quantity or BUY-only quoteOrderQty; timeInForce and price are rejected).

  • type=LIMIT previews the exact intended plain LIMIT order and requires timeInForce=IOC, quantity, and price. Only liquidity executable at or better than price is 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 as DUST.

  • Any other LIMIT time-in-force, quoteOrderQty with LIMIT, and stop order types are rejected with problem code=DUST_ORDER_TYPE_NOT_SUPPORTED. See the DUST_ORDER_POLICY exchange-info filter's supportedOrderShapes.

  • The response echoes type, and for LIMIT also timeInForce and price.

  • Dust-preview rate limits are shared across markets for the account. Exhaustion returns HTTP 429 with Retry-After seconds and problem stage=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&timestamp=1724952745123

Weight: 1

Authorizations
signaturestringRequired

Ed25519 signature of payload

X-API-KEYstringRequired

API key identifier. For Ed25519 V2 operations, its exact header value is the second line of the canonical signing payload.

Query parameters
symbolstringRequired
sidestring · enumRequired

Order side

Possible values:
typestring · enumOptional

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.

Possible values:
timeInForcestring · enumOptional

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.

Possible values:
quantitynumberOptional
quoteOrderQtynumberOptional
pricenumberOptional
acceptedMaxTakerBpsinteger · int32Optional
Responses
200

OK

application/json
symbolstringOptional
fillednumberOptional
exchangednumberOptional
vwapnumberOptional
slippagenumberOptional
typestringOptional
timeInForcestringOptional
pricenumberOptional
get/api/v1/order/fee-quote
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