Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

A Lean API key, sent as Authorization: Bearer <key>. A test key (lean_sk_test_...) simulates orders and fills with no money; a live key (lean_sk_live_...) trades for real within the key's limits. Every successful response says which mode answered in data.livemode.

Path Parameters

id
string<uuid>
required
Example:

"8a1e5c07-4b3f-4d62-9f18-2c7e0a95d4b1"

Body

application/json
authorization
enum<string>
required
Available options:
signature
payment_signature
string
required

EIP-712 signature over payment.typed_data, by payment.signer_address.

Pattern: ^0x[a-fA-F0-9]{130}$
agent_approval_signature
string

Signature over payment.agent_approval, when the payment carries one.

Pattern: ^0x[a-fA-F0-9]{130}$

Response

The order once its payment is accepted, with payment null. A test order is filled; a live order stays pending while the router moves the payment. Sending the same authorization again returns the current order

success
enum<boolean>
required
Available options:
true
data
object
required
meta
object
required