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

# Price monitoring and alerts

> Dashboards and alerts on a read only key, with no trading permission.

**Who it's for:** media, odds comparison, analytics and research teams. It is also the first
integration for most trading clients.

**What you build:** a dashboard or an alert ("tell me when the best combined price for Team A
moves more than 3c") with no trading permission at all.

## Call sequence

**1. Use a read only key**

Create a key with only the `read` scope.

**2. Read markets and prices**

[List markets](https://docs.lean.xyz/api-reference/markets/list-markets.md),
[Get prices](https://docs.lean.xyz/api-reference/markets/list-prices.md),
[Get a market orderbook](https://docs.lean.xyz/api-reference/markets/retrieve-market-book.md) and
[Get recent trades](https://docs.lean.xyz/api-reference/markets/list-market-trades.md).

**3. Go live**

[Create a stream ticket](https://docs.lean.xyz/api-reference/streaming/create-stream-ticket.md) and connect to the
WebSocket for live books.

## Starter

```bash theme={"dark"}
curl -sS "$LEAN_API_URL/v1/prices?market_ids=$MARKET_ID" \
  -H "Authorization: Bearer $LEAN_READ_KEY"

curl -sS "$LEAN_API_URL/v1/markets/$MARKET_ID/book?depth=10" \
  -H "Authorization: Bearer $LEAN_READ_KEY"
```

## Guardrails

* **Read only by design.** A key with only the `read` scope can't place, cancel or pause
  anything; an order attempt is refused with 403.
* **Revocable.** Revoke a dashboard's key from Lean at any time; the next request gets 401.
* **No money at risk.** Spending caps and trading permissions never come into play.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.