PokéWallet API

https://www.pokewallet.io/
Admin
PokéWallet API is a comprehensive Pokémon Trading Card Game API providing real-time pricing data, a...
Tokens:122,310
Snippets:1,599
Trust Score:2.7
Update:5 months ago
Show doc for...
Tokens:
Raw
### Make Your First PokéWallet API Request

Source: https://www.pokewallet.io/blog/pokewallet-api-game-changer-tcg-developers

This example demonstrates a basic GET request to the PokéWallet API for card search. Ensure you replace 'YOUR_API_KEY' with your actual development or production API key.

```bash
curl -X GET \
  'https://api.pokewallet.io/v1/cards?search=charizard' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

--------------------------------

### Analytics Top Cards Response Example (metric=price, source=tcg)

Source: https://www.pokewallet.io/api-docs

Example 200 OK response for the /analytics/top-cards endpoint when requesting card prices from TCGPlayer.

```json
{
  "metric": "price",
  "source": "tcg",
  "top_cards": [
    {
      "id": "pk_abc123",
      "card_info": {
        "name": "Charizard VSTAR",
        "set_name": "Brilliant Stars",
        "card_number": "018/172",
        "rarity": "Ultra Rare"
      },
      "current_price": 42.50
    }
  ]
}
```

--------------------------------

### API Information Response Example

Source: https://www.pokewallet.io/api-docs

Example response when requesting API information, detailing version, authentication, endpoints, and rate limits.

```json
{
  "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"
  }
}
```

--------------------------------

### Analytics Top Cards Response Example (metric=growth, source=cm)

Source: https://www.pokewallet.io/api-docs

Example 200 OK response for the /analytics/top-cards endpoint when requesting 7-day growth from CardMarket. Note the 'change_7d' field.

```json
{
  "metric": "growth",
  "source": "cm",
  "top_cards": [
    {
      "id": "pk_def456",
      "card_info": {
        "name": "Charizard ex (SV3 125)",
        "set_code": "SV3",
        "card_number": "125"
      },
      "current_price": 18.50,
      "change_7d": "+54.2%"
    }
  ]
}
```

--------------------------------

### TCG Card ID Format Example

Source: https://www.pokewallet.io/api-docs

Provides an example of the 'pk_' prefixed hexadecimal hash format used for TCGPlayer cards.

```text
pk_72046138a4c1908a9f27c93fdd8189ba...
```

--------------------------------

### TCG Card Search Response Example

Source: https://www.pokewallet.io/api-docs

Example response for a card search query that returns TCGPlayer card data, including pricing and card information.

```json
{
  "query": "pikachu",
  "results": [
    {
      "id": "pk_72046138a4c1908a9f27c93fdd8189ba4ac8e683efaed6b9161efcef129302394a9ec1d20d",
      "card_info": {
        "name": "Pikachu ex (Pikachu 60)",
        "clean_name": "Pikachu ex Pikachu 60",
        "set_name": "Battle Academy 2024",
        "set_code": "BA2024",
        "set_id": "23520",
        "card_number": "106",
        "rarity": "Holo Rare",
        "card_type": "Lightning",
        "hp": "200.0",
        "stage": "Basic",
        "card_text": null,
        "attacks": ["[LLC] Thunderbolt (120)"],
        "weakness": "Fx2",
        "resistance": null,
        "retreat_cost": "1.0"
      },
      "tcgplayer": {
        "prices": [{
          "sub_type_name": "Normal",
          "low_price": 7,
          "mid_price": 9.37,
          "high_price": 18,
          "market_price": 8.01,
          "direct_low_price": null,
          "updated_at": "2025-12-27T05:14:43.451818"
        }],
        "url": "https://www.tcgplayer.com/product/556443"
      },
      "cardmarket": null
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 56,
    "total_pages": 3
  },
  "metadata": {
    "total_count": 56,
    "tcg": 18,
    "cardmarket": 38,
    "tcg_only": 18,
    "cardmarket_only": 38,
    "both_sources": 0
  }
}
```

--------------------------------

### Set Statistics Response Example

Source: https://www.pokewallet.io/api-docs

Example of a successful response for the set statistics endpoint, including set information, price statistics from TCGPlayer and CardMarket, and a rarity breakdown.

```json
{
  "set_info": {
    "name": "SV2a_ Pokemon Card 151",
    "set_code": "23599",
    "total_cards": 524
  },
  "price_statistics": {
    "tcgplayer": {
      "avg_market_price": "7.80",
      "min_price": 0.07,
      "max_price": 307.56,
      "most_expensive": { "name": "Charizard ex - 201/165", "price": 307.56 }
    },
    "cardmarket": {
      "avg_price": "2.34",
      "min_price": 0.37,
      "max_price": 17.91,
      "trend_direction": "up"
    }
  },
  "rarity_breakdown": {
    "Common": 199,
    "Uncommon": 186,
    "Rare": 77,
    "Double Rare": 12,
    "Art Rare": 18,
    "Super Rare": 16,
    "Special Art Rare": 8,
    "Ultra Rare": 3,
    "Unknown": 5
  }
}
```

--------------------------------

### Analytics Top Cards Request Example (cURL)

Source: https://www.pokewallet.io/api-docs

Example cURL request to the /analytics/top-cards endpoint. Requires an X-API-Key header. Parameters like metric, source, and limit can be adjusted.

```bash
curl -H "X-API-Key: pk_live_your_key_here" \
     "https://api.pokewallet.io/analytics/top-cards?metric=growth&source=cm&limit=10"
```

--------------------------------

### Create Node.js Project Structure

Source: https://www.pokewallet.io/blog/build-pokemon-card-price-tracker-pokewallet-api-tutorial

Sets up a new Node.js project for the price tracker, including creating the project directory, initializing npm, and creating necessary files.

```bash
mkdir poke-price-tracker
cd poke-price-tracker
npm init -y
npm install dotenv
touch index.js .env
```

--------------------------------

### Get Card Image in Python

Source: https://www.pokewallet.io/api-docs

Downloads a card image using the API and saves it to a file. Ensure you have the 'pokewallet' library installed and an API key configured.

```python
try:
    image_data = get_card_image('pk_xxx', size='high', set_code='CBB3C')

    # Save to file
    with open('charizard.jpg', 'wb') as f:
        f.write(image_data)

    print('Image downloaded successfully')
except Exception as e:
    print(f'Error: {e}')
```

--------------------------------

### Granular Card Filtering API Request

Source: https://www.pokewallet.io/blog/pokemon-tcg-api-usability-developer-guide

Example of a GET request to filter Pokémon cards by type, HP, set, and rarity. This demonstrates server-side querying for efficient data retrieval.

```http
GET /api/cards?type=Water&hp_min=100&set=base1&rarity=holo
```

--------------------------------

### Authenticate with X-API-Key Header

Source: https://www.pokewallet.io/api-docs

Shows how to authenticate API requests using the recommended 'X-API-Key' header. Replace 'pk_live_your_key_here' with your valid API key.

```bash
curl -H "X-API-Key: pk_live_your_key_here" \
     "https://api.pokewallet.io/search?q=pikachu"
```

--------------------------------

### Rate Limit Headers Example

Source: https://www.pokewallet.io/api-docs

Illustrates the rate limit information returned in the response headers, indicating your current usage and remaining limits.

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

--------------------------------

### Healthy API Response Example

Source: https://www.pokewallet.io/api-docs

Example of a successful health check response from the API, indicating all services are operational.

```json
{
  "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"
}
```
Tokens:
Raw