📚 Dragon Ball Super API

Dragon Ball Super API
Documentation

REST reference for the Dragon Ball Super API: sets, cards, search and images, with prices from TCGPlayer and CardMarket. Same API key as the Pokémon and One Piece APIs.

198 SetsFull Dragon Ball catalog
Dual MarketTCGPlayer (USD) + CardMarket (EUR)
Updated DailyPrices refreshed every day
Base pathhttps://api.pokewallet.io/dbs
Sets198 Dragon Ball Super sets
Card IDsdbs_ + hex for cards on TCGPlayer; 64 hex characters for CardMarket-only cards
PricesTCGPlayer (USD) for every finish and CardMarket (EUR) for normal and foil, refreshed daily
Free on every planSets, set cards, card details, search and images
Ultra plan or 7-day trialPrices by set, set statistics, completion value, trending sets and top cards
API keyThe same key as the Pokémon and One Piece APIs, with shared rate limits
Base URL:https://api.pokewallet.io
One API key works for every game. Pick a game in the tabs below: each tab documents that game's endpoints — Pokémon at /cards, /sets…, One Piece at /op/…, the other games at /mtg/…, /ygo/…, /lor/… and so on.

Quick Start

Get started with PokéWallet API in 4 simple steps:

1

Create an Account

Sign up for free to start using the API. Upgrade anytime from your dashboard.

Sign Up Now
2

Generate an API Key

Create your first API key from the dashboard.

3

Make Your First Request

Start querying the API with your key.

cURL
curl -H "X-API-Key: pk_live_your_key_here" \
       "https://api.pokewallet.io/dbs/sets"
4

Join the Discord Community

Stay up to date with new features, ask for help, and connect with other developers.

Join Discord

Authentication

All API requests (except /health) require authentication using an API key.

API Key Format

API keys follow this format:

  • Production keys: pk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  • Development keys: pk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Security Warning: Never expose your API keys in client-side code, public repositories, or logs. Always use environment variables.

Authentication Methods

You can authenticate using either the X-API-Key header or Authorization header:

X-API-Key Header (Recommended)
curl -H "X-API-Key: pk_live_your_key_here" \
     "https://api.pokewallet.io/search?q=pikachu"
Authorization Header
curl -H "Authorization: Bearer pk_live_your_key_here" \
     "https://api.pokewallet.io/search?q=pikachu"

Rate Limits

Rate limits vary depending on your subscription plan:

PlanHourly LimitDaily LimitPrice
Free100 requests1,000 requests$0/month
Early Access ⭐1,000 requests10,000 requestsNo longer available
Coffee ☕1,000+ requests10,000+ requestsBuy a coffee on Ko-fi
Pro5,000 requests50,000 requests€20/month
Ultra7,000 requests70,000 requests€29/month
BusinessCustomCustomContact us
All new users start on the Free plan. Upgrade from your dashboard.
Early Access was our initial launch tier and is no longer available for new users.
Please note: After upgrading your plan, activation may require a couple of hours.

Rate Limit Headers

Every API response includes rate limit information:

X-RateLimit-Limit-Hour: 100
X-RateLimit-Remaining-Hour: 95
X-RateLimit-Limit-Day: 1000
X-RateLimit-Remaining-Day: 823

Rate Limit Exceeded (429)

When you exceed your rate limit, you'll receive a 429 Too Many Requests response:

{
  "error": "Rate limit exceeded",
  "message": "Hourly limit exceeded",
  "limits": {
    "hourly": {
      "limit": 100,
      "used": 100,
      "remaining": 0
    },
    "daily": {
      "limit": 1000,
      "used": 523,
      "remaining": 477
    }
  }
}

Public Endpoints

No Authentication Required: These endpoints are publicly accessible.
GET/healthNo Auth Required

Check API status, database, cache, and storage health with response times.

Example Request:

cURL
curl "https://api.pokewallet.io/health"

Response Example (Healthy):

200 OK
{
  "status": "healthy",
  "timestamp": "2025-12-16T10:30:00.000Z",
  "version": "1.1.0",
  "checks": {
    "database": {
      "status": "healthy",
      "responseTime": 45
    },
    "cache": {
      "status": "healthy",
      "responseTime": 3
    },
    "storage": {
      "status": "healthy",
      "responseTime": 12
    }
  },
  "responseTime": 60,
  "region": "FRA"
}

Response Example (Unhealthy):

503 Service Unavailable
{
  "status": "unhealthy",
  "timestamp": "2025-12-16T10:30:00.000Z",
  "version": "1.1.0",
  "message": "Critical services unavailable - API may not function correctly",
  "checks": {
    "database": {
      "status": "unhealthy",
      "responseTime": null,
      "message": "Connection failed"
    },
    "cache": {
      "status": "healthy",
      "responseTime": 3
    },
    "storage": {
      "status": "healthy",
      "responseTime": 12
    }
  },
  "responseTime": 1050,
  "region": "FRA"
}
GET/No Auth Required

Get API information, version, and available endpoints.

Example Request:

cURL
curl "https://api.pokewallet.io/"

Response Example:

200 OK
{
  "name": "PokeWallet API",
  "version": "1.1.0",
  "status": "production",
  "authentication": {
    "required": true,
    "method": "API Key",
    "header": "X-API-Key",
    "format": "pk_live_xxxxxxxxxxxxx"
  },
  "endpoints": {
    "health": { "path": "/health", "auth_required": false },
    "search": { "path": "/search?q=charizard&limit=20", "auth_required": true },
    "cardDetail": { "path": "/cards/:id", "auth_required": true },
    "sets": { "path": "/sets", "auth_required": true },
    "setDetails": { "path": "/sets/:setCode?page=1&limit=50", "auth_required": true },
    "images": { "path": "/images/:id?size=high", "auth_required": true }
  },
  "rate_limits": {
    "per_hour": 100,
    "per_day": 1000,
    "plan": "free"
  }
}
GET/gamesNo Auth Required

Lists the games available under their own prefix (/mtg, /ygo, …) with their routes. Pokémon and One Piece are not in this list: they use /cards, /sets… and /op/….

Example Request:

cURL
curl "https://api.pokewallet.io/games"

Response Example (first of ten games):

200 OK
{
  "success": true,
  "data": [
    {
      "code": "mtg",
      "name": "Magic: the Gathering",
      "endpoints": {
        "sets": "/mtg/sets",
        "set": "/mtg/sets/:set",
        "card": "/mtg/cards/:id",
        "search": "/mtg/search?q=",
        "image": "/mtg/images/:id"
      }
    }
  ]
}
Dragon Ball Super PRO endpoints: Ultra plan required

The Pro plan does not include them: Pro covers Pokémon and One Piece only. Ultra (€29/month) includes everything in Pro plus the paid endpoints of all 12 games. Free endpoints (sets, cards, search, images) work on every plan.

Compare plans →

Dragon Ball Super

All Dragon Ball Super endpoints live under /dbs. Same API key, same rate limits and the same response format as the Pokémon endpoints.

Card IDs

FormatExampleUsed for
dbs_ + hexdbs_0990dc88bb22b009f369…Every card with a TCGPlayer product, even if it also has CardMarket data
64 hex characters, no prefixe26f12b8b1fabf19…Cards that exist only on CardMarket
A dbs_… ID only works under /dbs/. Finishes of the same product (Normal, Foil, …) are one card with one ID; each finish has its own TCGPlayer price. If you request a card by its CardMarket ID and it is linked to a TCGPlayer product, the response uses the canonical dbs_… ID.

Response Format

Same shape as the Pokémon API: card_info, images, tcgplayer.prices and cardmarket.prices as arrays, pagination, errors as { "error", "message" }. Differences:

FieldDragon Ball Super
Game fields in card_info Instead of Pokémon's hp, stage, attacks…, the game's own fields in snake_case (present when the card has them): color, power, combo_power, energy_color_cost, character, era, special_trait, combo_energy, character_traits, cost, bandai_disclaimer, z_energy_cost, gtin
card_type, card_textFilled from the game's card type and rules text. card_text may contain HTML (<strong>, <em>…) as provided by TCGPlayer.
card_info.variants, card_info.set_idAlways present, on every endpoint
product_type"card", "sealed" or null when unknown — see Data Notes
release_dateISO format, e.g. "2025-03-07T00:00:00" (Pokémon uses "16th June, 2023")
images.languages["en"], or [] when there is no image

Dragon Ball Super Endpoints

GET/dbs/sets

All Dragon Ball Super sets.

Response Fields:

FieldTypeDescription
namestringSet name
set_codestring | nullShort code. Not unique: several sets can share it.
set_idstringUnique set identifier. Negative for sets that exist only on CardMarket.
card_countintegerCards in the set (sealed products excluded). Omitted, not 0, if temporarily unavailable.
sealed_countintegerSealed products in the set (booster boxes, displays, decks). Omitted, not 0, if temporarily unavailable.
languagestring | nullSet language
release_datestring | nullISO date

Example Request:

cURL
curl -H "X-API-Key: pk_live_your_key_here" \
     "https://api.pokewallet.io/dbs/sets"

Response Example (first two sets):

200 OK
{
  "success": true,
  "data": [
    {
      "name": "5th Anniversary Set",
      "set_code": "DBS-BE21",
      "set_id": "3109",
      "card_count": 79,
      "sealed_count": 5,
      "language": "eng",
      "release_date": "2022-10-28T00:00:00"
    },
    {
      "name": "Assault of the Saiyans",
      "set_code": "DBS-B07",
      "set_id": "2473",
      "card_count": 181,
      "sealed_count": 5,
      "language": "eng",
      "release_date": "2019-08-02T00:00:00"
    }
  ],
  "total": 198
}
GET/dbs/sets/:set

Cards of one set, paginated. Prices are empty in set listings, as on the Pokémon API: use /dbs/cards/:id for prices.

Parameters:

ParameterTypeRequiredDescription
setstringRequiredset_id (recommended, always unique) or set_code (exact match, case-insensitive)
pagenumberOptionalPage number (default: 1)
limitnumberOptionalResults per page (default: 50, max: 200)

Example Request:

cURL
curl -H "X-API-Key: pk_live_your_key_here" \
     "https://api.pokewallet.io/dbs/sets/2565?limit=1"

Response Example:

200 OK
{
  "success": true,
  "set": {
    "name": "Tournament Promotion Cards",
    "set_code": "TPR",
    "set_id": "2565",
    "total_cards": 1361,
    "language": "eng",
    "release_date": null
  },
  "cards": [
    {
      "id": "dbs_4d481cf07b7bc46288aae1a1739bc154ddb7f629fd7c61842c4f3dd5c9833f8fa23d49d019fcd59266",
      "card_info": {
        "name": "DBSCG Championship 2019 Warrior (Merit Card) - Universe 1 \"Iwan\"",
        "clean_name": "DBSCG Championship 2019 Warrior Merit Card Universe 1 Iwan",
        "set_name": "Tournament Promotion Cards",
        "set_code": "TPR",
        "set_id": "2565",
        "card_number": "1",
        "rarity": "Merit",
        "card_type": null,
        "product_type": "card",
        "variants": [
          "Normal"
        ],
        "card_text": "<em>Merit cards are proof that a player got to a certain place in a tournament. \r\nPlayers can't use them in their decks, but they can be used as tokens or other purposes.</em>",
        "bandai_disclaimer": "This promotional card is marked “Not For Sale” by BANDAI, as the manufacturer prefers that Stores do not sell these cards."
      },
      "images": {
        "languages": [
          "en"
        ]
      },
      "tcgplayer": {
        "prices": [],
        "url": "https://www.tcgplayer.com/product/191783/dragon-ball-super-ccg-tournament-promotion-cards-dbscg-championship-2019-warrior-merit-card-universe-1-iwan"
      },
      "cardmarket": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 1,
    "total": 1361,
    "total_pages": 1361
  }
}

Disambiguation Response:

When a set_code is shared by several sets, the API returns the candidates instead of a set (status 200, as on the Pokémon API). Call again with the set_id you need.

200 OK — /dbs/sets/BT26
{
  "disambiguation": true,
  "message": "Multiple sets found for set_code 'BT26'. Use set_id to specify which one.",
  "matches": [
    {
      "set_id": "23646",
      "set_code": "BT26",
      "name": "Ultimate Advent",
      "language": "eng",
      "release_date": "2024-10-11T00:00:00"
    },
    {
      "set_id": "23647",
      "set_code": "BT26",
      "name": "Ultimate Advent Pre-Release Cards",
      "language": "eng",
      "release_date": "2024-10-11T00:00:00"
    }
  ],
  "total": 2
}
GET/dbs/cards/:id

Full card with prices. id is a dbs_… ID or a 64-character CardMarket ID.

Example Request:

cURL
curl -H "X-API-Key: pk_live_your_key_here" \
     "https://api.pokewallet.io/dbs/cards/dbs_0990dc88bb22b009f369d37790ffaa61304fd5329495c6fdbf9a9a5e38c5c42999ade67956e3d9f53069fc849ea923"

Response Example:

200 OK
{
  "id": "dbs_0990dc88bb22b009f369d37790ffaa61304fd5329495c6fdbf9a9a5e38c5c42999ade67956e3d9f53069fc849ea923",
  "card_info": {
    "name": "Senzu Bean (Alt. Art Card Set 2023 Vol. 3)",
    "clean_name": "Senzu Bean Alt Art Card Set 2023 Vol 3",
    "set_name": "Tournament Promotion Cards",
    "set_code": "TPR",
    "set_id": "2565",
    "card_number": "BT1-053",
    "rarity": "Promo",
    "card_type": "Extra",
    "product_type": "card",
    "variants": [
      "Foil"
    ],
    "card_text": "[Activate: Battle] Choose up to 1 of your cards. It gains +5000 power for the duration of the turn. Then, choose up to 2 of your energy and switch them to Active Mode.",
    "color": "Blue",
    "energy_color_cost": "1(B)",
    "bandai_disclaimer": "This promotional card is marked “Not For Sale” by BANDAI, as the manufacturer prefers that Stores do not sell these cards."
  },
  "images": {
    "languages": [
      "en"
    ]
  },
  "tcgplayer": {
    "prices": [
      {
        "low_price": 75,
        "mid_price": 75.28,
        "high_price": 200,
        "market_price": 43.24,
        "direct_low_price": null,
        "updated_at": "2026-09-20T12:41:45.471825+00:00",
        "sub_type_name": "Foil"
      }
    ],
    "url": "https://www.tcgplayer.com/product/517115/dragon-ball-super-ccg-tournament-promotion-cards-senzu-bean-alt-art-card-set-2023-vol-3"
  },
  "cardmarket": {
    "product_name": "Senzu Bean",
    "prices": [
      {
        "variant_type": "normal",
        "avg": 15,
        "low": 34,
        "trend": 16.87,
        "avg1": 15,
        "avg7": 22.75,
        "avg30": 22.75,
        "updated_at": "2026-09-30T14:49:58.736632+00:00"
      },
      {
        "variant_type": "foil",
        "avg": 20.4,
        "low": 34,
        "trend": 18.25,
        "avg1": 20.49,
        "avg7": 26.23,
        "avg30": 24.63,
        "updated_at": "2026-09-30T14:49:58.736632+00:00"
      }
    ]
  }
}
One entry in tcgplayer.prices per finish, identified by sub_type_name, and one entry in cardmarket.prices per finish, identified by variant_type (normal, foil). updated_at is when that price last changed, not when it was last checked. A CardMarket-only card has tcgplayer: null and empty variants.
GET/dbs/images/:id

The card image, one resolution (X-Image-Size: unsized): the size parameter of the Pokémon image endpoint does not apply. Cached for 24 hours.

Example Request:

cURL
curl -H "X-API-Key: pk_live_your_key_here" \
     "https://api.pokewallet.io/dbs/images/dbs_0990dc88bb22b009f369d37790ffaa61304fd5329495c6fdbf9a9a5e38c5c42999ade67956e3d9f53069fc849ea923" \
     --output card

Ultra endpoints

Available on Ultra and Business plans, or during the 7-day trial. The Pro plan covers Pokémon and One Piece only: with Pro these endpoints answer 403 with an upgrade_url. Ultra includes everything in Pro. Same parameters and response format as the Pokémon endpoints of the same name.

EndpointWhat it returns
GET /dbs/prices/:setTCGPlayer and CardMarket prices for every card of a set, one row per finish. ?source=tcg|cm
GET /dbs/sets/:set/statisticsPrice statistics and rarity breakdown. Sealed products excluded. ?variant=normal|foil
GET /dbs/sets/:set/completion-valueCost of one copy of every card in the set. Sealed products excluded.
GET /dbs/sets/trendingSets whose CardMarket prices moved most: 7-day average against 30-day average, cards from 1 € up. ?period=7d ?limit=
GET /dbs/analytics/top-cardsMost expensive cards, or fastest-growing on CardMarket (7-day average against 30-day average, cards from 1 € up; current_price is the 7-day average). ?metric=price|growth ?source=tcg|cm ?limit=
Price history is a Pokémon feature: for this game there is no /cards/:id/price-history. Current prices are in the card detail and in /dbs/prices/:set; metric=growth works with source=cm only, and trending supports period=7d only.

GET /dbs/prices/:set (first rows)

200 OK
{
  "success": true,
  "source": "both",
  "set_code": "TPR",
  "set_id": "2565",
  "data": [
    {
      "id": "dbs_4d481cf07b7bc46288aae1a1739bc154ddb7f629fd7c61842c4f3dd5c9833f8fa23d49d019fcd59266",
      "card_number": "1",
      "name": "DBSCG Championship 2019 Warrior (Merit Card) - Universe 1 \"Iwan\"",
      "product_type": "card",
      "variant": "Normal",
      "tcgplayer": {
        "low_price": 0.77,
        "mid_price": 1.18,
        "high_price": 1.79,
        "market_price": 1,
        "direct_low_price": null,
        "updated_at": "2026-09-30T20:40:32.208613+00:00"
      },
      "cardmarket": null
    },
    {
      "id": "dbs_f7869c0feb939f9e3a355fe025630793718f31f084339273d40056759eee2d774f2c6f3dfe3c2c3f8c",
      "card_number": "2",
      "name": "DBSCG Championship 2019 Warrior (Merit Card) - Universe 2 \"Heles\"",
      "product_type": "card",
      "variant": "Normal",
      "tcgplayer": {
        "low_price": 0.8,
        "mid_price": 1.79,
        "high_price": 1.79,
        "market_price": 1.79,
        "direct_low_price": null,
        "updated_at": "2026-09-20T12:41:45.329897+00:00"
      },
      "cardmarket": null
    },
    {
      "id": "dbs_589dde060b8190d11d9da43d7fd5d7b10fcd6fdf60f8c43ae9d55f3b4fd9fb63b2f7f88f9e2009c78b",
      "card_number": "3",
      "name": "DBSCG Championship 2019 Warrior (Merit Card) - Universe 3 \"Mosco\"",
      "product_type": "card",
      "variant": "Normal",
      "tcgplayer": {
        "low_price": 0.77,
        "mid_price": 1.44,
        "high_price": 3,
        "market_price": 1.58,
        "direct_low_price": null,
        "updated_at": "2026-09-30T20:40:32.208613+00:00"
      },
      "cardmarket": null
    }
  ],
  "total": 1372
}

GET /dbs/sets/:set/statistics

200 OK
{
  "set_info": {
    "name": "Tournament Promotion Cards",
    "set_code": "TPR",
    "set_id": "2565",
    "total_cards": 1314
  },
  "price_statistics": {
    "tcgplayer": {
      "avg_market_price": "13.87",
      "min_price": 0.1,
      "max_price": 2025,
      "most_expensive": {
        "id": "dbs_d1b4852567193dfa3157584f8069d628ef94af77c3d761dde99e18e2323cce47710e89ea7b87aa1d629ee6af4faecd9b",
        "name": "Son Goku, Adventure (Serial Numbered)",
        "price": 2025
      }
    },
    "cardmarket": {
      "avg_price": "11.65",
      "min_price": 0.02,
      "max_price": 1500,
      "most_expensive": {
        "id": "dbs_09a6e2ca49a7585e0d9e923ceb6232e0477d206d7e602a3c44d20dc4976c45b3b4e3e3d42c8cc5bf93f73bb476db1a",
        "name": "Vegito // Fusion Warrior Super Saiyan Vegito (Championship 2023 Golden Card Vol.3)",
        "price": 1500
      },
      "trend_direction": "stable"
    }
  },
  "rarity_breakdown": {
    "Merit": 22,
    "Promo": 1030,
    "Secret Rare": 5,
    "Common": 19,
    "Uncommon": 104,
    "Rare": 32,
    "Super Rare": 45,
    "Special Rare": 2,
    "Son Gohan Rare": 1,
    "Dragon Ball Rare": 4,
    "Giant Force Rare": 1,
    "Expansion Rare": 7,
    "None": 16,
    "Starter Rare": 5,
    "Token": 21
  }
}

GET /dbs/sets/:set/completion-value

200 OK
{
  "set_info": {
    "name": "Tournament Promotion Cards",
    "set_code": "TPR",
    "set_id": "2565",
    "total_cards": 1314
  },
  "completion_cost": {
    "tcgplayer": {
      "currency": "USD",
      "low_estimate": 223643.76,
      "market_estimate": 211171.96,
      "high_estimate": 461325.41
    },
    "cardmarket": {
      "currency": "EUR",
      "low_estimate": 16535.96,
      "avg_estimate": 16701.98,
      "trend_estimate": 1153.99
    },
    "note": "One copy per card (base finish). TCGPlayer prices in USD, CardMarket prices in EUR. Cross-currency comparison not available."
  },
  "breakdown_by_rarity": {
    "Merit": {
      "count": 22,
      "total_cost": 211.28
    },
    "Promo": {
      "count": 1030,
      "total_cost": 7073.09
    },
    "Secret Rare": {
      "count": 5,
      "total_cost": 2025
    },
    "Common": {
      "count": 19,
      "total_cost": 20.81
    },
    "Uncommon": {
      "count": 104,
      "total_cost": 710.81
    },
    "Rare": {
      "count": 32,
      "total_cost": 98.91
    },
    "Super Rare": {
      "count": 45,
      "total_cost": 1026.73
    },
    "Special Rare": {
      "count": 2,
      "total_cost": 18.21
    },
    "Son Gohan Rare": {
      "count": 1,
      "total_cost": 2.36
    },
    "Dragon Ball Rare": {
      "count": 4,
      "total_cost": 11.9
    },
    "Giant Force Rare": {
      "count": 1,
      "total_cost": 4.75
    },
    "Expansion Rare": {
      "count": 7,
      "total_cost": 22.93
    },
    "None": {
      "count": 16,
      "total_cost": 2024.27
    },
    "Starter Rare": {
      "count": 5,
      "total_cost": 22.29
    },
    "Token": {
      "count": 21,
      "total_cost": 52.29
    }
  }
}

GET /dbs/analytics/top-cards

200 OK
{
  "metric": "price",
  "source": "tcg",
  "top_cards": [
    {
      "id": "dbs_752e01e514d525b3efc0a9af04eeab239c627394e5ab9cff5080c87baa9b24d6c83ffc4ebb97cb179d6d828ea404f6",
      "card_info": {
        "name": "Son Goku - FP-001 (Serial Numbered)",
        "clean_name": "Son Goku FP 001 Serial Numbered",
        "set_name": "Fusion World Promotion Cards and Packs",
        "set_code": "DBSFW_PR",
        "set_id": "23428",
        "card_number": "FP-001",
        "rarity": "Promo",
        "card_type": "Battle",
        "product_type": "card",
        "variants": [
          "Holofoil"
        ],
        "card_text": "[Permanent] If your Leader is awakened, this card gets +5000 power.\r\n<br><span style=\"color:red\">A numbered series of 777 copies of this card was given out as top event winner prizing for Awakened Pulse tournaments. <strong>The number on the card you receive will vary from the number pictured in the listing unless otherwise shown in a Listing with Photo.</strong></span>",
        "cost": "2(R)",
        "color": "Red",
        "power": "20000",
        "combo_power": "5000",
        "character_traits": "Saiyan"
      },
      "current_price": 8000
    },
    {
      "id": "dbs_b22eedd43d2cb2fa99b05a4050fe4317fb28bade8e0a51985e18e7df2ae85452d9e59aa88ee7901ccbf5cf84f5",
      "card_info": {
        "name": "Energy Marker (E-48) (Gold)",
        "clean_name": "Energy Marker E 48 Gold",
        "set_name": "Fusion World Energy Markers",
        "set_code": "DBSFW_EM",
        "set_id": "23430",
        "card_number": "E-48",
        "rarity": "None",
        "card_type": null,
        "product_type": "card",
        "variants": [
          "Holofoil"
        ],
        "card_text": "At the start of the game, the player who goes second places 1 Energy Marker in their Energy Area.<br>\nRemoving 1 Energy Marker from the game is equivalent to switching 1 card from your energy (with the same color as your Leader) to Rest Mode."
      },
      "current_price": 2400
    }
  ]
}

GET /dbs/analytics/top-cards?metric=growth&source=cm

200 OK
{
  "metric": "growth",
  "source": "cm",
  "top_cards": [
    {
      "id": "dbs_fe2c5596629c9287d61cfaf1e0f2486106df2627ece9a542e6f32423dac88c35c04845f04f3af2bd2e855cc080018ece",
      "card_info": {
        "name": "SS3 Son Goku, Calamity Conqueror",
        "clean_name": "SS3 Son Goku Calamity Conqueror",
        "set_name": "Cross Spirits",
        "set_code": "DBS-B14",
        "set_id": "2858",
        "card_number": "BT14-035",
        "rarity": "Rare",
        "card_type": "Battle",
        "product_type": "card",
        "variants": [
          "Normal",
          "Foil"
        ],
        "card_text": "[Deflect]\r\n<br>[Auto] [Limit 1] B, if your Leader Card is blue : When this card attacks, it gets +5000 power for the turn, and if you have a blue Unison Card with a specified cost of 3 in play, switch this card to Active Mode and it gains [Double Strike] for the turn.\r\n<br>[Activate:Main] [Spirit Boost 1] BBBB : Play this card from your hand.",
        "era": "Hirudegarn Saga",
        "color": "Blue",
        "power": "25000",
        "character": "Son Goku",
        "combo_power": "10000",
        "combo_energy": "1",
        "special_trait": "Saiyan",
        "energy_color_cost": "6(BBBB)"
      },
      "current_price": 8.8,
      "change_7d": "+652.1%"
    },
    {
      "id": "6b76487c06c479632562a30fe3b95d9dcaadb01b945fc718c5445a6af52a8c0c",
      "card_info": {
        "name": "Master Roshi, Masterly Majesty",
        "clean_name": "Master Roshi, Masterly Majesty",
        "set_name": "Malicious Machinations",
        "set_code": "DBS-B08",
        "set_id": "2536",
        "card_number": "032",
        "rarity": null,
        "card_type": null,
        "product_type": "card",
        "variants": [],
        "card_text": null
      },
      "current_price": 20.27,
      "change_7d": "+422.4%"
    },
    {
      "id": "dbs_53bd24aad0b0c55321a4ccbcae0dbcd397ecb0b61377366f042fe7aa4189df25d5d151d657f2f2b4f41a58598a2d5140",
      "card_info": {
        "name": "Zamasu // SS Rose Goku Black, Wishes Fulfilled",
        "clean_name": "Zamasu SS Rose Goku Black Wishes Fulfilled",
        "set_name": "Realm of the Gods",
        "set_code": "DBS-B16",
        "set_id": "2986",
        "card_number": "BT16-072",
        "rarity": "Uncommon",
        "card_type": "Leader",
        "product_type": "card",
        "variants": [
          "Normal",
          "Foil"
        ],
        "card_text": "[Auto] When this card attacks, add up to 2 [Dragon Ball] cards from your deck and/or life to your hand; shuffle any areas you looked through using this skill.\r\n<br>[Wish] When your life is at 3 or less or there are 7 [Dragon Ball] cards in your Drop Area : Draw 1 card, then place all [Dragon Ball] cards from your Drop Area at the bottom of your deck in any order and flip this card over.\r\n<br><br><strong>SS Rose Goku Black, Wishes Fulfilled</strong>\r\n<br>[Activate:Main] [Once per turn] Choose one—\r\n<br>• Draw 1 card.\r\n<br>• Add up to 1 [Dragon Ball] card from your deck to your hand, then shuffle your deck.\r\n<br>• Remove 7 [Dragon Ball] cards in your Drop Area from the game. If you do, play up to 1 \"Zamasu\" card with an energy cost of 2 or less and [Indestructible] from your Warp, and this card gains [Triple Attack] for the turn.",
        "era": "Future Trunks Saga",
        "color": "Yellow",
        "power": "10000/15000",
        "character": "Goku Black",
        "special_trait": "Saiyan/God/Shenron"
      },
      "current_price": 7.17,
      "change_7d": "+391.1%"
    }
  ]
}

GET /dbs/sets/trending

200 OK

Data Notes

Prices. TCGPlayer and CardMarket prices are refreshed daily. CardMarket has one entry per finish (normal, foil); a finish CardMarket does not price is left out, so cardmarket.prices can be empty. updated_at is when that price last changed, not when it was last checked: a stable price keeps an older date.
product_type. Cards and sealed products are told apart using TCGPlayer data, then CardTrader. Tokens, emblems and oversized cards count as "card". For the very few products whose type cannot be determined, product_type is null, not "card".
CardMarket-only sets. Sets with a negative set_id exist only on CardMarket: their cards have 64-character IDs and tcgplayer: null.
Missing links. cardmarket.product_url is absent for some cards; the card data is still valid. Sets with no cards are not listed: they appear as soon as cards are added.

Error Handling

The API uses standard HTTP status codes to indicate success or failure:

200
OK

Request successful

400
Bad Request

Invalid parameters or malformed request

401
Unauthorized

Missing or invalid API key

403
Forbidden

Paid endpoint without the required plan or an active trial: Pro for Pokémon and One Piece, Ultra for the other games. The body includes redeem_url (trial not activated yet) or upgrade_url (trial expired).

404
Not Found

Card, set or image does not exist

405
Method Not Allowed

The API only accepts GET requests.

409
Conflict

/sets/:setCode/image: the set code matches several sets. Retry with ?language= or the numeric set_id.

429
Too Many Requests

Rate limit exceeded

500
Internal Server Error

Something went wrong on our side

502
Bad Gateway

An image could not be fetched from its source. Temporary: retry later.

Errors on game endpoints (/mtg, /ygo, …)

StatuserrorWhen
400Invalid or corrupted card IDID is neither <game>_… nor 64 hex, or belongs to another game
400Query parameter requiredq missing, shorter than 2 or longer than 100 characters
400Search query rejectedq contains SQL-like text: rephrase it
400Invalid or corrupted card ID + did_you_meanThe ID belongs to another game (e.g. a lor_… ID on /mtg/cards): did_you_mean has the right path
404Set not found + suggestionsNo set with that set_id/set_code. If you wrote the set name, suggestions lists the matching sets with their set_id
404Card not found, Image not foundCard or image does not exist
502Image not availableImage source temporarily unreachable
503Search temporarily unavailableThe search took too long under load. Retry after the seconds in the Retry-After header, or use more specific words

Error Response Format

Every error has error (short, stable) and message (what to fix). When the API can tell what you meant, did_you_mean contains the corrected path:

// GET /magic/sets
  {
    "error": "Endpoint not found",
    "message": "Did you mean /mtg/sets?",
    "did_you_mean": "/mtg/sets",
    "docs": "https://pokewallet.io/api-docs"
  }

Authentication errors (401) also include an example request. A trailing slash is ignored: /sets/ and /sets are the same endpoint.

Best Practices

Use Environment Variables

Never hardcode API keys. Always use environment variables or secure secret management.

Handle Rate Limits Gracefully

Implement exponential backoff when you receive a 429 response. Check rate limit headers to avoid hitting limits.

Cache Results

Cache API responses when appropriate to reduce requests and improve performance.

Use Search Endpoint

Always use /search for the most complete and accurate data.

Monitor Your Usage

Check your dashboard regularly to track API usage and avoid unexpected rate limit hits.

Error Handling

Always implement proper error handling for network failures, rate limits, and invalid responses.

Security Reminder: Keep your API keys secure. If you suspect a key has been compromised, revoke it immediately from your dashboard and generate a new one.

Need Help?

If you have questions or run into issues, we're here to help!