{
  "name": "SpellBook Finance MTG Finance Signals API",
  "url": "https://spellbook-finance.com/developers",
  "baseUrl": "https://api.spellbook-finance.com",
  "description": "Free, keyless JSON and RSS API for MTG market data: price movers, all-time-high breaks, set value trends, sealed product EV rankings, and feeds.",
  "isAccessibleForFree": true,
  "requiresAccount": false,
  "requiresApiKey": false,
  "cors": "open",
  "rateLimit": "120 requests per minute per IP for public feed and embed endpoints. 429 responses include Retry-After.",
  "recommendedCitation": "SpellBook Finance",
  "listedIn": [
    {
      "name": "awesome-mtg Developer Resources",
      "url": "https://github.com/astrospective/awesome-mtg#developer-resources"
    }
  ],
  "sourceBoundary": {
    "useScryfallFor": "Card objects, oracle text, rulings, images, and canonical card identity.",
    "useSpellBookFinanceFor": "Derived MTG finance signals from market-history snapshots, sealed EV calculations, all-time-high detection, buyout detection, and RSS feeds."
  },
  "refreshCadence": [
    {
      "surface": "Card prices",
      "cadence": "Daily market snapshots"
    },
    {
      "surface": "Price movers",
      "cadence": "Daily and weekly views computed from price-history snapshots"
    },
    {
      "surface": "All-time-high breaks",
      "cadence": "Computed from SpellBook historical price series"
    },
    {
      "surface": "Buyout and spike detection",
      "cadence": "Hourly detection feed"
    },
    {
      "surface": "Sealed EV rankings",
      "cadence": "Daily recomputation from current singles prices and set distribution models"
    }
  ],
  "endpoints": [
    {
      "method": "GET",
      "path": "/cards/find?q={query}",
      "format": "application/json",
      "description": "Find Magic card printings by name for spreadsheet and lightweight lookup use.",
      "exampleUrl": "https://api.spellbook-finance.com/cards/find?q=Lightning%20Bolt"
    },
    {
      "method": "GET",
      "path": "/movers?timeframe=daily",
      "format": "application/json",
      "description": "Daily MTG card price gainers and losers.",
      "exampleUrl": "https://api.spellbook-finance.com/movers?timeframe=daily"
    },
    {
      "method": "GET",
      "path": "/ath",
      "format": "application/json",
      "description": "Cards that just broke or are near their all-time-high price.",
      "exampleUrl": "https://api.spellbook-finance.com/ath"
    },
    {
      "method": "GET",
      "path": "/ticker",
      "format": "application/json",
      "description": "Compact market ticker of notable daily movers.",
      "exampleUrl": "https://api.spellbook-finance.com/ticker"
    },
    {
      "method": "GET",
      "path": "/buyouts",
      "format": "application/json",
      "description": "Cards detected spiking or getting bought out in the last 7 days.",
      "exampleUrl": "https://api.spellbook-finance.com/buyouts"
    },
    {
      "method": "GET",
      "path": "/sets",
      "format": "application/json",
      "description": "Magic set catalog with codes and release info.",
      "exampleUrl": "https://api.spellbook-finance.com/sets"
    },
    {
      "method": "GET",
      "path": "/embed/ev/rankings?count=10",
      "format": "application/json",
      "description": "Top booster boxes ranked by sealed expected-value ratio.",
      "exampleUrl": "https://api.spellbook-finance.com/embed/ev/rankings?count=10"
    },
    {
      "method": "GET",
      "path": "/embed/ev/{boxId}",
      "format": "application/json",
      "description": "Expected value and notable-card breakdown for one sealed product.",
      "exampleUrl": "https://api.spellbook-finance.com/embed/ev/96350"
    },
    {
      "method": "GET",
      "path": "/feeds/movers.xml",
      "format": "application/rss+xml",
      "description": "Daily price movers as an RSS feed.",
      "exampleUrl": "https://api.spellbook-finance.com/feeds/movers.xml"
    },
    {
      "method": "GET",
      "path": "/feeds/buyouts.xml",
      "format": "application/rss+xml",
      "description": "Buyout and spike detections as an RSS feed.",
      "exampleUrl": "https://api.spellbook-finance.com/feeds/buyouts.xml"
    }
  ]
}