Build an unsigned PlaceLimitOrder transaction.

Returns an unsigned tx the client can sign. For BUY orders the response includes the exact USDT collateral the user must hold (price × quantity / 1000 + 2.5% fee).

POST /v1/tx/markets/{address}/orders

Error

A valid request URL is required to generate request examples

200

{
  "unsignedTx": "<string>",
  "txId": "<string>",
  "fromGroup": 0,
  "toGroup": 0,
  "gasAmount": 0,
  "gasPrice": "<string>",
  "attoAlphAmount": "<string>",
  "tokens": [
    {
      "id": "<string>",
      "amount": "<string>"
    }
  ],
  "collateralRequired": "<string>"
}

Authorizations

Authorization · string · header · required

API key obtained from POST /v1/auth/keys.

Path Parameters

address · string · required

Alephium address (base58, optional :N group suffix).

Required string length: 30 - 80

Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$

Body

application/json

signerAddress · string · required

Alephium address (base58, optional :N group suffix).

Required string length: 30 - 80

Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$

signerPublicKey · string · required

Signer's public key (33-byte secp256k1 hex). Required for the node to build the witness layout.

Pattern: ^(0x)?[0-9a-fA-F]+$

side · enum<string> · required

Order side.

Available options: buy, sell

outcome · enum<string> · required

Outcome side.

Available options: yes, no

price · integer · required

Price as integer ticks of 0.001 (0=No, 1000=Yes).

Required range: 0 <= x <= 1000

quantity · string · required

Quantity in 18-decimal share base units (string to preserve precision).

Pattern: ^\d+$

signerKeyType · enum<string> · default: default

Defaults to "default" (groupless secp256k1). Pass "gl-webauthn" for passkey wallets.

Available options: default, bip340-schnorr, gl-secp256k1, gl-secp256r1, gl-ed25519, gl-webauthn

referer · string

Alephium address (base58, optional :N group suffix).

Required string length: 30 - 80

Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$

Response

200

application/json

Default Response

unsignedTx · string · required

Hex-encoded unsigned transaction. Sign and submit via your wallet.

txId · string · required

fromGroup · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

toGroup · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

gasAmount · integer · required

Required range: -9007199254740991 <= x <= 9007199254740991

gasPrice · string · required

attoAlphAmount · string

tokens · object[]

Show child attributes

collateralRequired · string