Build an unsigned ProposeAndSubmitMarket transaction (single-leg).

Submits one binary (yes/no) market proposal for governance review in a single tx. For a multi-outcome event (e.g. “who wins this game?” with 4 candidates), use POST /v1/tx/factory/propose-linked-market instead — it bundles all legs into one signed tx. Strings are accepted as plain text and hex-encoded internally.

POST /v1/tx/factory/propose-market

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.

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

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

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

rules · string

Maximum string length: 1000

resolutionSources · string

Maximum string length: 1000

imageUrl · string

Maximum string length: 500

metadata · string

JSON-serialised metadata blob.

Maximum string length: 4000

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