Your First API Call

Market data on Aura is public. No key, no signup, no auth header. You can have real market data back in one request, so start there and add authentication later only when you need to place orders.

Base URLs

https://api.aura.markets

https://api.testnet.aura.markets

Build against testnet first. It runs the same API against test tokens, so you can place real orders without real money. See Contracts for the testnet deployment.

List open markets

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

const res = await fetch(
  'https://api.aura.markets/v1/markets?limit=5&status=open&sort=volume&order=desc'
)
const { markets, pagination } = await res.json()

for (const m of markets) {
  console.log(m.question, m.bestBidYes, m.marketAddress)
}

import requests

res = requests.get(
    "https://api.aura.markets/v1/markets",
    params={"limit": 5, "status": "open", "sort": "volume", "order": "desc"},
)
data = res.json()

for m in data["markets"]:
    print(m["question"], m["bestBidYes"], m["marketAddress"])

resp, err := http.Get(
    "https://api.aura.markets/v1/markets?limit=5&status=open&sort=volume&order=desc",
)
if err != nil {
    log.Fatal(err)
}
defer resp.Body.Close()

You get back a markets array and a pagination object:

{
  "markets": [
    {
      "id": 412,
      "marketAddress": "26tkBYU6bv77TUDRHX9Yj3aWNKf8jgcgrDobzGnkZSSNs",
      "question": "Will ALPH close above $5 on December 31?",
      "category": "Crypto",
      "tags": ["alephium", "price"],
      "resolved": false,
      "finalOutcome": null,
      "volume": "184920000000000000000",
      "bestBidYes": 640,
      "bestAskYes": 655,
      "bestBidNo": 345,
      "bestAskNo": 360,
      "createdAt": "2026-07-12T18:04:11.000Z"
    }
  ],
  "pagination": { "limit": 5, "nextCursor": "eyJpZCI6NDEyfQ" }
}

Three things to notice, because they trip people up:

Prices are ticks

bestBidYes: 640 means 64%, not $640. Ticks run 0 to 1000. Divide by 10 for a percentage, or by 1000 for a probability.

Amounts are strings

volume is base units at 18 decimals, as a string. Parse it as a big integer, never as a float.

Two different ids

id is a database integer. marketAddress is the on-chain contract. Trading always uses marketAddress.

Useful filters

Parameter	Values	Notes
`limit`	1 to 200	Defaults to 50.
`status`	`open`, `resolved`, `all`	Defaults to `open`.
`sort`	`created-at`, `volume`, `best-bid-yes`, `recently-traded`
`order`	`asc`, `desc`
`category`	Category name
`tags`	Comma-separated
`q`	Free text	Searches the question.
`cursor`	Opaque string	Pass back `pagination.nextCursor`.
`facets`	`true`	Adds category and tag counts to the response.

Paginate by feeding nextCursor back as cursor. When it comes back null, you have reached the end.

Read the order book

Take a marketAddress from that response and ask for its book:

MARKET="26tkBYU6bv77TUDRHX9Yj3aWNKf8jgcgrDobzGnkZSSNs"

curl -s "https://api.aura.markets/v1/markets/${MARKET}/orderbook?depth=10"

const market = '26tkBYU6bv77TUDRHX9Yj3aWNKf8jgcgrDobzGnkZSSNs'

const book = await fetch(
  `https://api.aura.markets/v1/markets/${market}/orderbook?depth=10`
).then((r) => r.json())

console.log('best yes bid', book.bestBidYes)
console.log('top ask', book.yes.asks[0])

market = "26tkBYU6bv77TUDRHX9Yj3aWNKf8jgcgrDobzGnkZSSNs"

book = requests.get(
    f"https://api.aura.markets/v1/markets/{market}/orderbook",
    params={"depth": 10},
).json()

print("best yes bid", book["bestBidYes"])

{
  "marketAddress": "26tkBYU6bv77TUDRHX9Yj3aWNKf8jgcgrDobzGnkZSSNs",
  "yes": {
    "bids": [{ "price": 640, "totalQuantity": "12000000000000000000", "orderCount": 3 }],
    "asks": [{ "price": 655, "totalQuantity": "8000000000000000000", "orderCount": 2 }]
  },
  "no": { "bids": [], "asks": [] },
  "bestBidYes": 640,
  "bestAskYes": 655,
  "bestBidNo": 345,
  "bestAskNo": 360
}

Every Aura market has two books, one for yes shares and one for no shares. They are linked: buying a yes at 640 and buying a no at 360 together mint a complete share pair, which is how the matcher can fill both sides at once. See How trading works for the mechanics. depth defaults to 20 and caps at 100.

Get a simple price

If you just want the current probability and not a whole book:

curl -s "https://api.aura.markets/v1/markets/${MARKET}/prices"

{ "yesPrice": 0.64, "noPrice": 0.36, "priceTimestamp": 1720000000 }

These come back as floats between 0 and 1, which is friendlier for display than ticks. A market with no trade history reports 0.5 on both sides with a timestamp of 0.

Rate limits

Anonymous reads are limited to 60 requests per minute per IP. That is plenty for exploring and thin for a production bot, so if you are polling, sign in to get a per-account limit, or better, stop polling and use the realtime stream. See Rate limits.

Place your first order

Add authentication and go from a market address to a live on-chain order.

Realtime stream

Subscribe to order, fill, and resolution events instead of polling.

Integrator guide

Practical guidance for bots: which auth you need, error handling, elevated limits.

Full endpoint reference

Every published endpoint, with schemas and try-it examples.

Get Started

Guides

Reference

Endpoints

Realtime Stream

Your First API Call

Base URLs

List open markets

Prices are ticks

Amounts are strings

Two different ids

Useful filters

Read the order book

Get a simple price

Rate limits

Next

Place your first order

Realtime stream

Integrator guide

Full endpoint reference

​Base URLs

​List open markets

Prices are ticks

Amounts are strings

Two different ids

​Useful filters

​Read the order book

​Get a simple price

​Rate limits

​Next

Place your first order

Realtime stream

Integrator guide

Full endpoint reference

Base URLs

List open markets

Useful filters

Read the order book

Get a simple price

Rate limits

Next