API Introduction

https://api.matchr.xyz/v1

import requests

response = requests.get(
    "https://api.matchr.xyz/v1/events",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 10, "sort": "volume"}
)

events = response.json()
for event in events["data"]:
    print(f"{event['title']}: {event['markets'][0]['price']}")

const response = await fetch(
  'https://api.matchr.xyz/v1/events?limit=10&sort=volume',
  {
    headers: {
      'Authorization': 'Bearer YOUR_API_KEY'
    }
  }
);

const { data: events } = await response.json();
events.forEach(event => {
  console.log(`${event.title}: ${event.markets[0].price}`);
});

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1699876543

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 1000
  }
}

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key",
    "details": {}
  }
}

import { Matchr } from '@matchr/sdk';

const matchr = new Matchr({
  apiKey: 'YOUR_API_KEY'
});

// Get matched markets with spreads
const matches = await matchr.getMatchedMarkets({
  minSpread: 0.03
});

// Place an order
const order = await matchr.placeOrder({
  marketId: 'market_123',
  side: 'BUY',
  amount: 100
});

await matchr.webhooks.subscribe({
  url: 'https://your-server.com/webhook',
  events: ['order.filled', 'market.resolved', 'spread.alert']
});