Quickstart

Get up and running with the Relay44 API in under 5 minutes using curl.

1. Check health

Verify the API is reachable.

bash
curl https://relay44.com/health

2. List markets

Fetch the first 10 markets from all sources.

bash
curl 'https://relay44.com/v1/evm/markets?limit=10&offset=0&source=all'

3. Get a nonce

Start the SIWE authentication flow by requesting a nonce.

bash
curl https://relay44.com/v1/auth/siwe/nonce

4. Authenticate

Sign the SIWE message with your wallet and submit the signature.

bash
curl -X POST https://relay44.com/v1/auth/siwe/login \
  -H 'Content-Type: application/json' \
  -d '{"message": "<siwe-message>", "signature": "<hex-signature>"}'

The response includes access_token and refresh_token.

5. Fetch order book

Get the order book for a specific market.

bash
curl 'https://relay44.com/v1/evm/markets/<market_id>/orderbook?outcome=yes&depth=20'

6. Place an order

Place a limit order using your JWT.

bash
curl -X POST https://relay44.com/v1/orders \
  -H 'Authorization: Bearer <access_token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "market_id": "<market_id>",
    "outcome": "yes",
    "side": "buy",
    "price": 0.55,
    "quantity": 100
  }'