traded.gg logotraded.gg
Skip to documentation content
On This Page

REST API

Quick Start

Create an API key, make your first request, and read a card price.

1. Get a Key

Create a key at Developer Settings. Access is invite-only for now. DM @traded_gg on X with the email or wallet you use on traded.gg.

2. Send a Request

Ask for the Base Set Charizard price (base1-4), sending your key as an Authorization: Bearer header:

Price request example
export TRADED_API_KEY="your-key"

curl "https://api.traded.gg/v1/prices?ids=base1-4&grade=PSA%3A10" \
  -H "Authorization: Bearer $TRADED_API_KEY"

3. Read the Response

A successful response returns ok: true with one result per requested card. This illustrative excerpt is shortened and is not a live quote:

Price response excerpt
{
  "ok": true,
  "data": {
    "results": [
      {
        "id": "base1-4",
        "price": { "value_usd": 1550.0, "status": "ok", "as_of": "2026-10-02" }
      }
    ]
  }
}
Value
value_usd is the returned price in US dollars.
Status
Keep status alongside the value so missing data is not mistaken for a price.
Freshness
Check as_of before displaying or relying on a price.

Explore all endpoints in the API Reference.