Skip to main content
POST
/
v1
/
tx
/
markets
/
{address}
/
orders
/
{orderId}
/
cancel
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>"
}

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:]+$
​
orderId
integer
required
Required range: 0 <= x <= 9007199254740991

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]+$
​
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

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