API Reference

Watchlist

Manage your model watchlist. Watchlisted models can trigger price change alerts when prices update.

Get Watchlist

Returns all models in the authenticated user's watchlist. Accepts either an API key (Bearer) or a dashboard session cookie.

Toggle Watchlist

Adds or removes a model (toggle behavior). Returns added: true if added, added: false if removed.

// Request body
{ "model_id": 42 }

// Response — added
{ "added": true }

// Response — removed
{ "added": false }

// 403 — limit reached
{ "error": "Watchlist limit reached. Your plan allows a maximum of 5 models." }

Get Watchlist Response

[
  {
    "id": 42,
    "name": "GPT-4o",
    "slug": "gpt-4o",
    "provider": "OpenAI",
    "price_input": 0.005,
    "unit": "1k_tokens"
  }
]

Code Examples

// Get watchlist
const res = await fetch('https://api.tallyify.com/watchlist', {
  headers: { Authorization: 'Bearer tly_live_yourkey' }
});
const watchlist = await res.json();

// Toggle a model
await fetch('https://api.tallyify.com/watchlist', {
  method: 'POST',
  headers: { Authorization: 'Bearer tly_live_yourkey', 'Content-Type': 'application/json' },
  body: JSON.stringify({ model_id: 42 })
});