> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Your first request in one minute.

## 1. Get your API key

Create an account on [apinn.io](https://www.apinn.io/signup) — the free trial includes **5,000 requests / hour**. Your key (`pnk_…`) is displayed in your [account area](https://www.apinn.io/account).

## 2. Make your first request

Pass the key in the `X-API-Key` header on every call.

<CodeGroup>
  ```bash curl theme={null}
  # Complete odds history for an event
  curl https://api.apinn.io/api/odds \
    -H "X-API-Key: YOUR_KEY" \
    -G --data-urlencode "event_id=1608247913" \
       --data-urlencode "full_history=1"
  ```

  ```python Python theme={null}
  import requests

  BASE = "https://api.apinn.io"
  H = {"X-API-Key": "YOUR_KEY"}

  r = requests.get(f"{BASE}/api/odds",
      params={"event_id": 1608247913, "full_history": 1}, headers=H)
  odds = r.json()
  print(f"{len(odds)} odds movements")
  ```

  ```javascript Node.js theme={null}
  const BASE = "https://api.apinn.io";
  const H = { "X-API-Key": "YOUR_KEY" };

  const r = await fetch(`${BASE}/api/odds?event_id=1608247913&full_history=1`, { headers: H });
  const odds = await r.json();
  console.log(`${odds.length} odds movements`);
  ```
</CodeGroup>

## 3. Explore the book

```bash theme={null}
# List sports
curl https://api.apinn.io/api/sports -H "X-API-Key: YOUR_KEY"

# Live matches for a sport (29 = Soccer)
curl "https://api.apinn.io/api/fixtures?sport_id=29&live=1" -H "X-API-Key: YOUR_KEY"

# Main odds for a match
curl "https://api.apinn.io/api/odds?event_id=1608247913&main_lines_only=1" -H "X-API-Key: YOUR_KEY"
```

<Tip>
  Every response returns quota headers: `X-Quota-Limit`, `X-Quota-Remaining`, `X-Quota-Cost`. See [Rate limits](/en/rate-limits).
</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/en/api-reference/introduction">
    All endpoints and parameters.
  </Card>

  <Card title="Real-time stream" icon="bolt" href="/en/concepts/streaming">
    Receive deltas pushed via SSE.
  </Card>
</CardGroup>