Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.monetary.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
1) Set your environment

export MONETARY_API_BASE_URL="https://api.monetary.dev"
export MONETARY_API_TOKEN="<your_api_token>"

​
2) Verify connectivity

/health is public and does not require auth. 
curl -sS "$MONETARY_API_BASE_URL/health"
Expected shape: 
{
  "result": [{ "ok": 1 }],
  "status": "ok",
  "uptime": 1234.56
}

​
3) Make an authenticated request

curl -sS "$MONETARY_API_BASE_URL/v1/companies?query=nvidia&limit=5" \
  -H "Authorization: Bearer $MONETARY_API_TOKEN" \
  -H "Accept: application/json"

​
4) Try prediction market endpoints

curl -sS "$MONETARY_API_BASE_URL/v1/prediction_markets/events?provider=kalshi&status=open&limit=10" \
  -H "Authorization: Bearer $MONETARY_API_TOKEN" \
  -H "Accept: application/json"

​
JavaScript example

const baseUrl = process.env.MONETARY_API_BASE_URL;
const token = process.env.MONETARY_API_TOKEN;

const response = await fetch(
  `${baseUrl}/v1/prediction_markets/markets?provider=polymarket&limit=20`,
  {
    headers: {
      Accept: "application/json",
      Authorization: `Bearer ${token}`,
    },
  },
);

if (!response.ok) {
  const err = await response.json();
  throw new Error(err.message ?? "Request failed");
}

const payload = await response.json();
console.log(payload.data.length);

​
5) Optional: subscribe to realtime updates

const ws = new WebSocket("ws://127.0.0.1:3001/ws");

ws.addEventListener("open", () => {
  ws.send(JSON.stringify({
    action: "subscribe",
    channels: ["events", "markets", "trades"],
  }));
});
Next: read Authentication & Errors, browse endpoint docs, and see Realtime Stream for websocket payloads.