Build an unsigned ProposeAndSubmitMarket transaction (single-leg). - Aura

Error

A valid request URL is required to generate request examples

{
  "unsignedTx": "<string>",
  "txId": "<string>",
  "fromGroup": 0,
  "toGroup": 0,
  "gasAmount": 0,
  "gasPrice": "<string>",
  "creationLifecycle": {
    "transactionId": "<string>",
    "deploymentTransactionId": "<string>",
    "observedAt": "2023-11-07T05:31:56Z"
  },
  "attoAlphAmount": "<string>",
  "tokens": [
    {
      "id": "<string>",
      "amount": "<string>"
    }
  ],
  "collateralRequired": "<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>"
  }
}

POST

/

v1

/

tx

/

factory

/

propose-market

Error

A valid request URL is required to generate request examples

{
  "unsignedTx": "<string>",
  "txId": "<string>",
  "fromGroup": 0,
  "toGroup": 0,
  "gasAmount": 0,
  "gasPrice": "<string>",
  "creationLifecycle": {
    "transactionId": "<string>",
    "deploymentTransactionId": "<string>",
    "observedAt": "2023-11-07T05:31:56Z"
  },
  "attoAlphAmount": "<string>",
  "tokens": [
    {
      "id": "<string>",
      "amount": "<string>"
    }
  ],
  "collateralRequired": "<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>"
  }
}

Authorizations

aura_session

string

cookie

required

HttpOnly session cookie set by POST /v1/auth/session. Mutating requests must also send the CSRF token (returned by that call) in the x-csrf-token header.

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

question

string

required

Required string length: 1 - 300

category

string

required

Required string length: 1 - 80

signerKeyType

enum<string>

default:default

Signature scheme the signer address was derived from. gl-secp256k1 is the groupless key the Aura app uses (3... addresses); default is grouped secp256k1 for standard Alephium wallets and tooling (1... addresses). These are the only two types a session can be established with, so no other value can reach a build-tx route.

Available options:

default,

gl-secp256k1

rules

string

Maximum string length: 1000

resolutionSources

string

Maximum string length: 1000

imageUrl

string

Maximum string length: 500

metadata

string

JSON-serialised metadata blob, capped at 2048 UTF-8 bytes on chain.

Maximum string length: 2048

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

creationLifecycle

object

required

Pre-deployment lifecycle checkpoint from the authority that can actually observe it. This never creates a synthetic market row.

Show child attributes

attoAlphAmount

string

tokens

object[]

Show child attributes

collateralRequired

string

Last modified on August 11, 2026