ESO Market Tracker API

A lightweight read-only API for the Elder Scrolls Online Market Tracker. This service returns platform-specific pricing and trading information for items.

Base URL

Replace with your deployed API URL:

https://data.esomarkettracker.com

Endpoints

Search items

GET /search/:term

Example:

curl "https://data.esomarkettracker.com/search/dreugh%20wax"

Response:

{
  "ok": true,
  "kind": "item",
  "query": [1393740546, 604228140, 556206086, 623099135],
  "results": [
    {
      "pricing": {
        "xbox-na": {
          "--": {
            "--": {
              "average": 2865,
              "date": "2025-12-06",
              "commonQuantity": 1,
              "minimum": 719,
              "maximum": 6685
            }
          }
        },
        "xbox-eu": {
          "--": {
            "--": {
              "average": 6881,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 4945,
              "maximum": 9302
            }
          }
        },
        "ps-eu": {
          "--": {
            "--": {
              "average": 7890,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 3300,
              "maximum": 60045
            }
          }
        },
        "ps-na": {
          "--": {
            "--": {
              "average": 3435,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 45,
              "maximum": 5625
            }
          }
        }
      },
      "item": {
        "internalId": 1393740546,
        "name": "Dreugh Wax",
        "description": "Improve quality from purple to gold.",
        "icon": "data/images/41/0_/no/crafting_outfitter_potion_014.png",
        "bindType": -1,
        "knownIds": "[54177]"
      }
    }
  ]
}

Fetch a single item

GET /item/:key

Example:

curl "https://data.esomarkettracker.com/item/1393740546"

Response:

{
  "ok": true,
  "kind": "item",
  "query": [
    "1393740546"
  ],
  "results": [
    {
      "pricing": {
        "xbox-na": {
          "--": {
            "--": {
              "average": 2865,
              "date": "2025-12-06",
              "commonQuantity": 1,
              "minimum": 719,
              "maximum": 6685
            }
          }
        },
        "xbox-eu": {
          "--": {
            "--": {
              "average": 6881,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 4945,
              "maximum": 9302
            }
          }
        },
        "ps-eu": {
          "--": {
            "--": {
              "average": 7890,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 3300,
              "maximum": 60045
            }
          }
        },
        "ps-na": {
          "--": {
            "--": {
              "average": 3435,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 45,
              "maximum": 5625
            }
          }
        }
      },
      "item": {
        "internalId": 1393740546,
        "name": "Dreugh Wax",
        "description": "Improve quality from purple to gold.",
        "icon": "data/images/41/0_/no/crafting_outfitter_potion_014.png",
        "bindType": -1,
        "knownIds": "[54177]"
      }
    }
  ]
}

Response format

{
  "ok": true,
  "kind": "item",
  "query": [
    "1393740546"                    // Any internal IDs that were tested in the lookup
  ],
  "results": [
    {
      "pricing": {
        "xbox-na": {                // The relevant ESO megaserver
          "--": {                   // The trait for the item (if applicable)
            "--": {                 // The quality for the item (if variable)
              "average": 2865,      // The average this item has sold for recently
              "date": "2025-12-06", // The date this data was compiled
              "commonQuantity": 1,  // The common stack size for this item
              "minimum": 719,       // The lowest this item sold for recently
              "maximum": 6685       // The most this item sold for recently
            }
          }
        },
        "xbox-eu": {
          "--": {
            "--": {
              "average": 6881,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 4945,
              "maximum": 9302
            }
          }
        },
        "ps-eu": {
          "--": {
            "--": {
              "average": 7890,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 3300,
              "maximum": 60045
            }
          }
        },
        "ps-na": {
          "--": {
            "--": {
              "average": 3435,
              "date": "2025-12-24",
              "commonQuantity": 1,
              "minimum": 45,
              "maximum": 5625
            }
          }
        }
      },
      "item": {
        "internalId": 1393740546,
        "name": "Dreugh Wax",
        "description": "Improve quality from purple to gold.",
        "icon": "data/images/41/0_/no/crafting_outfitter_potion_014.png",
        "bindType": -1,
        "knownIds": "[54177]"
      }
    }
  ]
}

Error format

{
  "ok": false,
  "error": "Message"
}

Status codes

200 - success
400 - bad request
404 - not found
405 - method not allowed