Error

A valid request URL is required to generate request examples

{
  "authorizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "authorizationGeneration": 123,
  "status": "<string>",
  "receipt": {
    "receiptBytesHex": "<string>",
    "signatureHex": "<string>",
    "signingKeyId": 2147483647
  },
  "intentHash": "<string>"
}

{
  "authorizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "authorizationGeneration": 123,
  "status": "<string>",
  "receipt": {
    "receiptBytesHex": "<string>",
    "signatureHex": "<string>",
    "signingKeyId": 2147483647
  },
  "intentHash": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

Trading

Place a semantic BUY or SELL through restricted Aura custody.

Requires both a builder developer key and a user-created restricted trading authorization. Aura derives the owner, canonical market witness, network, nonce and exact 180-byte intent; it then validates limits, signs inside the enclave and submits atomically. No intent bytes, user/custody signature, or grant is returned. A response may include a sequencer-signed acceptance receipt; that attestation cannot authorize a wallet action. The API binds attribution to the authenticated developer key’s canonical builderCode before signing. Retrying the exact request is idempotent.

POST

orders

Error

A valid request URL is required to generate request examples

{
  "authorizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "authorizationGeneration": 123,
  "status": "<string>",
  "receipt": {
    "receiptBytesHex": "<string>",
    "signatureHex": "<string>",
    "signingKeyId": 2147483647
  },
  "intentHash": "<string>"
}

{
  "authorizationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "authorizationGeneration": 123,
  "status": "<string>",
  "receipt": {
    "receiptBytesHex": "<string>",
    "signatureHex": "<string>",
    "signingKeyId": 2147483647
  },
  "intentHash": "<string>"
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "requestId": "<string>",
    "details": "<unknown>"
  }
}

Authorizations

x-aura-developer-key

string

header

required

Builder identity and quota key. It never substitutes for a wallet session or restricted trading authorization and can never sign or custody assets.

x-aura-trading-authorization

string

header

required

One-time-shown, user-created restricted trading credential bound to a developer key, policy limits, expiry and optional source IP. Aura signs and submits inside custody; the credential never reveals a grant, transaction signature, intent signature or seed.

Body

application/json

clientOrderId

string

required

Exact token base-unit quantity encoded as canonical JSON string.

Pattern: ^(0|[1-9][0-9]*)$

marketId

string

required

Pattern: ^[0-9a-fA-F]{64}$

outcome

enum<string>

required

Available options:

yes,

no

side

enum<string>

required

Available options:

buy,

sell

orderType

enum<string>

required

Available options:

gtc_limit,

ioc_market

expiresAt

string<date-time>

required

Pattern:

^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

quantityBaseUnits

string

Exact token base-unit quantity encoded as canonical JSON string.

Pattern: ^(0|[1-9][0-9]*)$

spendBaseUnits

string

Exact token base-unit quantity encoded as canonical JSON string.

Pattern: ^(0|[1-9][0-9]*)$

limitPriceTick

integer

Required range: 1 <= x <= 999

costBoundBaseUnits

string

Exact token base-unit quantity encoded as canonical JSON string.

Pattern: ^(0|[1-9][0-9]*)$

feeCapBps

integer

Required range: 0 <= x <= 65535

allowPartialFill

boolean

default:true

expectedBookVersion

string

Exact token base-unit quantity encoded as canonical JSON string.

Pattern: ^(0|[1-9][0-9]*)$

Response

Default Response

authorizationId

string<uuid>

required

Pattern:

^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

authorizationGeneration

integer

required

Required range: x <= 9007199254740991

status

string

required

Required string length: 1 - 80

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

receipt

object | null

required

Show child attributes

intentHash

string

required

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

Last modified on August 11, 2026

Get Started

Guides

Reference

Endpoints

Realtime Stream

Place a semantic BUY or SELL through restricted Aura custody.

Authorizations

Body

Response