Skip to content
Crypto-only, prepaid. Top up a balance and we draw from it monthly — nothing is ever charged automatically.
tcggraph

Ravensburger · 5,480 printings

Lorcana card scanner API

Enchanted variants hide behind ordinary card numbers.

5,480
Matchable printings
5
Languages
38 ms
Median match
$0
Charged for a miss

The problem

Why Lorcana is hard to identify

Lorcana is clean by the standards of this list, which makes the exceptions sharper. Nearly all of the secondary-market value sits in enchanted variants — full-art, foil-treatment versions of existing cards that carry a card number above the set's stated total. The base card and its enchanted version share a name and an ink colour and are separated by a number most tools truncate.

Below that, standard foil and non-foil printings of the same card diverge modestly, and the six-language release schedule means the same card exists in parallel markets at different prices. Because the set is small and consistently laid out, the collector number and total in the bottom corner are reliable, which makes this a game where a match should be near-certain or clearly refused.

wss://api.tcggraph.com/v1/scanidle
    0
    Frames
    0
    Matched
    0
    Unbilled

    A replayed transcript of Lorcana cards from the public demo catalog, including a frame that does not resolve and is not billed. Nothing is being inferred in your browser.

    What settles it

    The fields a match is decided on

    Read in the order a person grading Lorcana would read them. The match returns all of them, so you never have to infer a printing from a card name.

    FieldWhy it decides the price
    Card number and totalA number above the set total marks an enchanted variant.
    FinishFoil and non-foil are separate printings.
    Ink colourConfirms the card against sets that reuse character names.
    LanguageSix printed languages with independent European pricing.

    Where scanners fail

    Lorcana traps that return the wrong printing

    Each of these is a case where the artwork is right and the answer is still wrong. A confident wrong match costs more than a refused one, which is why an unresolved frame is free.

    Enchanted numbering

    Enchanted cards are numbered past the set total — 205/204 and up. Any tool that assumes the number cannot exceed the total drops the most valuable cards in the game onto their base printing.

    Character name reuse

    The same character appears across sets as different cards. The name is not unique, so the set and number carry the identification.

    Integrate it

    Scanning Lorcana in about fifteen lines

    Pin the socket to one game and matching gets both faster and more certain, because there are fewer near-identical candidates to rule out.

    The card inside a match is the same object /v1/cards?game=disney-lorcana returns, including the Lorcana-specific fields. If you already read this API, a scanner is a new input to code you have written rather than a second integration.

    Scanning is metered separately from data, so pointing a camera at a stack all morning cannot spend the credits your repricer needs at midnight.

    Scan pricing

    $29/mo · 6,000 matched cards

    Or $0.012 per matched card with no plan at all. Down to $0.0025 at volume, and a frame we cannot place is never billed.

    Compare scan plans
    Live Lorcana scanning
    const socket = new WebSocket("wss://api.tcggraph.com/v1/scan", [
      "tcggraph.v1",
      `bearer.${process.env.TCGGRAPH_KEY}`,
    ]);
    
    socket.onopen = () =>
      socket.send(
        JSON.stringify({
          type: "config",
          games: ["disney-lorcana"],
          minConfidence: 0.92,
          prices: ["cardmarket", "tcgplayer"],
        }),
      );
    
    socket.onmessage = (event) => {
      const frame = JSON.parse(event.data);
    
      for (const match of frame.matches ?? []) {
        // The printing, not just the card: set, number, language, finish.
        intake.add(match.printing, match.card.prices);
      }
    
      // Unresolved frames arrive too, and cost nothing.
      for (const miss of frame.unresolved ?? []) showHint(miss.reason);
    };
    
    for await (const jpeg of camera.frames()) socket.send(jpeg);
    A match, with both price feeds
    {
      "requestId": "scan_01K5Z8P4XQJ7YB3M",
      "latencyMs": 41,
      "matches": [
        {
          "confidence": 0.9962,
          "billed": true,
          "box": {
            "x": 0.171,
            "y": 0.064,
            "w": 0.658,
            "h": 0.872
          },
          "printing": {
            "id": "lor_46402c967ba2",
            "language": "en",
            "finish": "nonfoil",
            "edition": "unlimited",
            "collectorNumber": "23"
          },
          "card": {
            "id": "lor_46402c967ba2",
            "game": "disney-lorcana",
            "name": "Mickey Mouse — Amber Champion",
            "set": {
              "code": "10",
              "name": "Whispers in the Well"
            },
            "rarity": "Rare",
            "prices": [
              {
                "source": "tcgplayer",
                "region": "NA",
                "currency": "USD",
                "market": 1
              },
              {
                "source": "cardmarket",
                "region": "EU",
                "currency": "EUR",
                "market": 0.87,
                "trend": 0.87,
                "sellers": 16
              }
            ]
          },
          "alternatives": []
        }
      ],
      "scans": {
        "billed": 1,
        "remaining": 5842
      }
    }

    FAQ

    Scanning Lorcana

    Start with Lorcana, add the rest for nothing

    One key covers every game we carry, and scans are pooled across all of them. There is no per-game surcharge and no separate model to enable — a stack with Lorcana, Pokémon and Magic mixed together resolves card by card without you sorting it first.

    Other games