API Overview

​

Make your first request

curl -s "https://api.aura.markets/v1/markets?limit=5&status=open"

const { markets } = await fetch(
  'https://api.aura.markets/v1/markets?limit=5&status=open'
).then((response) => response.json())

for (const market of markets) console.log(market.question, market.lifecycle.tradingStatus)

import requests

response = requests.get(
    "https://api.aura.markets/v1/markets",
    params={"limit": 5, "status": "open"},
)
for market in response.json()["markets"]:
    print(market["question"], market["lifecycle"]["tradingStatus"])

​

API model

• Canonical configuration. GET /v1/protocol/config publishes the active network, contracts, collateral decimals, limits, fees and realtime capabilities. Do not hard-code these values.
• Immediate market data. Market summaries, the versioned order book and point-in-time BUY/SELL quotes reflect the instant clearinghouse venue.
• Rich lifecycle. Market responses distinguish registration, trading, resolution, settlement and claimability instead of relying on one ambiguous active flag.
• Durable realtime. Fetch-based SSE uses schema version 2, source-vector cursors and explicit reset frames. REST snapshots carry the cursor needed for race-free resume.
• Private authority. Account and private realtime reads require the matching wallet session. Trading writes require a separate user-created restricted authorization plus the scoped developer key; the write does not receive an unrelated session bearer. A developer key alone never reveals or controls a user’s account.
• Reconciliation. GET /v1/transactions/{txId} combines Alephium node state with privacy-filtered Aura indexing and recovery state.
• Webhooks. Developer webhooks share the durable event backbone, use HMAC signatures, and deliver at least once.

​

Base URLs

https://api.aura.markets

https://api.testnet.aura.markets

http://localhost:3001

​

Specifications and SDK