tickermint

Use this when the user names a trading card or sealed product and you need its TickerMint product_id (required by card_price and price_history) or its set id (group_id, required by set_prices). Returns up to 25 matches with name, set, collector number, the latest raw market price in USD and the page URL. Covers Pokemon, One Piece, Lorcana, Riftbound, Yu-Gi-Oh and Gundam only.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Card or product name, optionally with set or collector number, e.g. 'charizard ex 199/165'.",
      "title": "Query",
      "type": "string"
    },
    "game": {
      "anyOf": [
        {
          "enum": [
            "pokemon",
            "one-piece",
            "lorcana",
            "riftbound",
            "yugioh",
            "gundam"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Limit to one game (pokemon, one-piece, lorcana, riftbound, yugioh, gundam). Omit to search every game.",
      "title": "Game"
    },
    "limit": {
      "default": 10,
      "description": "Results to return, 1 to 25.",
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "search_cardsArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Result",
      "type": "array"
    }
  },
  "required": [
    "result"
  ],
  "title": "search_cardsOutput"
}

Use this when the user asks what one specific card or sealed product is worth today. Returns the latest daily TCGplayer market price and lowest listed price per printing (Normal, Holofoil, Reverse Holofoil, 1st Edition...) with the date of the price, in USD, plus the page URL. Raw (ungraded) prices only; not an appraisal of a particular copy. Needs a product_id from search_cards.

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "TickerMint product_id from search_cards.",
      "title": "Product Id",
      "type": "integer"
    }
  },
  "required": [
    "product_id"
  ],
  "title": "card_priceArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "card_priceDictOutput"
}

Use this when the user asks whether a card's price is going up or down, how it moved over a period, or what it was worth on a past date. Returns the daily market price per printing for the last `days` days (7 to 1000; history starts February 2024, later for newer cards) in USD. Past prices only, no forecasts.

{
  "type": "object",
  "properties": {
    "product_id": {
      "description": "TickerMint product_id from search_cards.",
      "title": "Product Id",
      "type": "integer"
    },
    "days": {
      "default": 90,
      "description": "How many recent days, 7 to 1000.",
      "title": "Days",
      "type": "integer"
    }
  },
  "required": [
    "product_id"
  ],
  "title": "price_historyArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "price_historyDictOutput"
}

Use this when the user asks for the most expensive or most valuable cards in one game right now. Returns up to 25 singles ranked by today's raw market price (USD) with set and printing. Raw prices only, not graded values.

{
  "type": "object",
  "properties": {
    "game": {
      "default": "pokemon",
      "description": "Card game, one of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam.",
      "enum": [
        "pokemon",
        "one-piece",
        "lorcana",
        "riftbound",
        "yugioh",
        "gundam"
      ],
      "title": "Game",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "1 to 25.",
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "most_valuableArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "most_valuableDictOutput"
}

Use this when the user asks which cards in one game rose or fell the most recently. Returns the biggest percentage moves over the last `days` (1 to 90) for cards worth $5 or more, with the start and end market price in USD. Describes past moves only; not a prediction.

{
  "type": "object",
  "properties": {
    "game": {
      "default": "pokemon",
      "description": "Card game, one of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam.",
      "enum": [
        "pokemon",
        "one-piece",
        "lorcana",
        "riftbound",
        "yugioh",
        "gundam"
      ],
      "title": "Game",
      "type": "string"
    },
    "days": {
      "default": 7,
      "description": "Look-back window, 1 to 90 days.",
      "title": "Days",
      "type": "integer"
    },
    "limit": {
      "default": 20,
      "description": "1 to 100.",
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "moversArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "moversDictOutput"
}

Use this when the user asks which cards in one game are at a record price. Returns cards that set an all-time high market price (since February 2024) in the last 7 days and still hold it, with the date of the high, in USD.

{
  "type": "object",
  "properties": {
    "game": {
      "default": "pokemon",
      "description": "Card game, one of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam.",
      "enum": [
        "pokemon",
        "one-piece",
        "lorcana",
        "riftbound",
        "yugioh",
        "gundam"
      ],
      "title": "Game",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "1 to 200.",
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "all_time_highsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "all_time_highsDictOutput"
}

Use this when the user asks which cards in one game are at their lowest price or have crashed. Returns cards worth $5+ sitting at their all-time low market price after falling at least 50% from their high, with the high and the percent below it, in USD.

{
  "type": "object",
  "properties": {
    "game": {
      "default": "pokemon",
      "description": "Card game, one of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam.",
      "enum": [
        "pokemon",
        "one-piece",
        "lorcana",
        "riftbound",
        "yugioh",
        "gundam"
      ],
      "title": "Game",
      "type": "string"
    },
    "limit": {
      "default": 25,
      "description": "1 to 200.",
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "all_time_lowsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "all_time_lowsDictOutput"
}

Use this when the user asks about sealed product prices in one game: booster boxes, elite trainer boxes, bundles, packs, tins and cases. Returns today's market price (USD) and 30-day percent change per product, most expensive first. For one named product, search_cards plus card_price is more direct.

{
  "type": "object",
  "properties": {
    "game": {
      "default": "pokemon",
      "description": "Card game, one of: pokemon, one-piece, lorcana, riftbound, yugioh, gundam.",
      "enum": [
        "pokemon",
        "one-piece",
        "lorcana",
        "riftbound",
        "yugioh",
        "gundam"
      ],
      "title": "Game",
      "type": "string"
    },
    "limit": {
      "default": 50,
      "description": "1 to 300.",
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "sealed_pricesArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "sealed_pricesDictOutput"
}

Use this when the user asks what a set is worth, what it costs to complete, or which cards in one set are the most valuable. Returns the number of priced singles, the sum of their market prices today (one copy of each, USD), the 25 most valuable singles and the 10 priciest sealed products of the set. Needs a group_id from search_cards.

{
  "type": "object",
  "properties": {
    "group_id": {
      "description": "Set id (group_id) from search_cards.",
      "title": "Group Id",
      "type": "integer"
    }
  },
  "required": [
    "group_id"
  ],
  "title": "set_pricesArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "set_pricesDictOutput"
}

Use this to look up trading cards or sealed products (Pokemon, One Piece, Lorcana, Riftbound, Yu-Gi-Oh, Gundam) by name. Returns up to 10 matches with ids to pass to `fetch`.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Card or sealed product name.",
      "title": "Query",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "title": "searchArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "searchDictOutput"
}

Use this after `search` to read one product: today's market price per printing (USD), its move over the last 90 days and the page URL.

{
  "type": "object",
  "properties": {
    "id": {
      "description": "Product id from `search` results.",
      "title": "Id",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "title": "fetchArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "fetchDictOutput"
}