Skip to main content
POST
/
v1
/
tx
/
markets
/
{address}
/
market-orders
Error
A valid request URL is required to generate request examples
{
  "unsignedTx": "<string>",
  "txId": "<string>",
  "fromGroup": 0,
  "toGroup": 0,
  "gasAmount": 0,
  "gasPrice": "<string>",
  "attoAlphAmount": "<string>",
  "tokens": [
    {
      "id": "<string>",
      "amount": "<string>"
    }
  ],
  "collateralRequired": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://aura-4ecab767.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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
​
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
​
expectedPrice
integer

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

Required range: 0 <= x <= 1000
​
referer
string

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

Required string length: 30 - 80
Pattern: ^[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz:]+$

Response

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[]
​
collateralRequired
string