All Prices

The All Prices Abstract Model describes the properties of card prices based on a card UUID.

Price Providers

MTGJSON currently has affiliated with the following price providers to keep a limited history of price data. The following are examples of game formats and price providers:

Model Overview

json
{
  // Card UUID
  "<Card UUID>": {
    // Game format
    "<Game Format>": {
      // Price provider
      "<Price Provider>": {
        // Provider buylist values
        "buylist": {
          // Foil prices
          "foil": {
            // Date as key and price as value
            "<YYYY-MM-DD>": float
          },
          // Normal prices
          "normal": {
            // Date as key and price as value
            "<YYYY-MM-DD>": float
          }
        },
        // Currency of the provider
        "currency": string,
        // Provider retail values
        "retail": {
          // Foil prices
          "foil": {
            // Date as key and price as value
            "<YYYY-MM-DD>": float
          },
          // Normal prices
          "normal": {
            // Date as key and price as value
            "<YYYY-MM-DD>": float
          }
        }
      },
      ... // More price providers
    },
    ... // More game formats
  },
  ... // More card UUIDs
}

Example Model

json
{
  "0120a941-9cfb-50b5-b5e4-4e0c7bd32410": {
    "mtgo": {
      "cardhoarder": {
        "currency": "USD",
        "retail": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.02
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.02
          }
        }
      },
    },
    "paper": {
      "cardkingdom": {
        "buylist": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.6
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.01
          }
        },
        "currency": "USD",
        "retail": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.12
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.02
          }
        }
      },
      "cardmarket": {
        "buylist": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.6
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.01
          }
        },
        "currency": "EUR",
        "retail": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.12
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.02
          }
        }
      },
      "cardsphere": {
        "currency": "USD",
        "retail": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.12
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.02
          }
        }
      },
      "tcgplayer": {
        "buylist": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.6
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.01
          }
        },
        "currency": "USD",
        "retail": {
          "foil": {
            ..., // More entries
            "2020-04-21": 0.12
          },
          "normal": {
            ..., // More entries
            "2020-04-21": 0.02
          }
        }
      }
    }
  }
}

Need more data? Join the Discord and let us know or open an issue on GitHub. We'll be happy to discuss your needs.