Scrydex

https://scrydex.com/docs
Admin
Scrydex is a comprehensive trading card API that provides developers with instant access to data on...
Tokens:70,911
Snippets:537
Trust Score:6.8
Update:1 month ago
Show doc for...
Tokens:
Raw
### Example Pokémon API Request with Headers

Source: https://scrydex.com/docs/pokemon/api-reference

This cURL example demonstrates how to make a GET request to the Pokémon API, including required API key and team ID headers.

```bash
curl -X GET 'https://api.scrydex.com/pokemon/v1/cards' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Example API Request using CURL

Source: https://scrydex.com/docs/onepiece/api-reference

This example demonstrates how to make a GET request to the One Piece API using CURL, including necessary API key and team ID headers.

```CURL
curl -X GET 'https://api.scrydex.com/onepiece/v1/cards?q=printings:PRB01' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'
```

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

### Search Expansions by Name Prefix (CURL)

Source: https://scrydex.com/docs/onepiece/expansions

Example CURL request to find expansions where the name starts with 'rom'. Wildcard matching is used here.

```curl
curl -X GET 'https://api.scrydex.com/onepiece/v1/expansions?q=name:rom*' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'
```

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

### Search Sealed Products by Name Prefix (cURL)

Source: https://scrydex.com/docs/pokemon/sealed

Example of searching for sealed products where the name starts with 'char' using a wildcard in the 'q' parameter.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/pokemon/v1/sealed?q=name:char*' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Fetching and Searching Expansions Example

Source: https://scrydex.com/docs/pokemon/expansions

Demonstrates how to use query parameters to retrieve and search for expansions via the Scrydex API.

```text
?q=series:XY language:japanese
```

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

### Example Price Update Request (cURL)

Source: https://scrydex.com/docs/magicthegathering/webhooks

Example of how to make a POST request to your webhook endpoint to receive price update notifications. Ensure to set the correct Content-Type and include the X-Scrydex-Signature header.

```cURL
curl -X POST 'https://your-app.com/webhooks' \
-H 'Content-Type: application/json' \
-H 'X-Scrydex-Signature: t=123,v1=abc' \
-d '{"id":"evt_mtg_prices_123","name":"magicthegathering.expansions.prices.raw_updated","data":{"expansion_ids":["CNS"]}}'
```

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

### Search Lorcana Expansions with Lucene-like Query (cURL)

Source: https://scrydex.com/docs/lorcana/expansions

Example cURL request to search for Lorcana expansions using a query parameter 'q'. This example searches for expansions with 'type:promo' and excludes those with 'name:challenge'.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/lorcana/v1/expansions?q=type:promo%20-name:challenge' \
  --header 'X-Api-Key: <api_key_here>'
  --header 'X-Team-ID: <team_id_here>'
```

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

### Fetch All Sealed Products (cURL)

Source: https://scrydex.com/docs/pokemon/sealed

Example of fetching all sealed products, paginated, without any filters, using the base endpoint.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/pokemon/v1/sealed' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Pokémon Listing Object Example

Source: https://scrydex.com/docs/pokemon/listings

An example JSON object representing a single Pokémon listing, including details like ID, source, card information, condition, and price.

```json
{
  "id": "6d690f4c-e467-432a-9735-2ecc493ba012",
  "source": "ebay",
  "card_id": "zsv10pt5-105",
  "title": "2025 Pokemon Blk En-Black Bolt Illustration Rare Seismitoad #105 PSA 10",
  "variant": "holofoil",
  "company": "PSA",
  "grade": "10",
  "is_perfect": false,
  "is_error": false,
  "is_signed": false,
  "url": "https://www.ebay.com/itm/306453556017?nordt=true&rt=nc&orig_cvip=true",
  "price": 2399.0,
  "currency": "USD",
  "sold_at": "2025/08/19"
}
```

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

### Search Sealed Products by Name Prefix and Suffix (cURL)

Source: https://scrydex.com/docs/pokemon/sealed

Example of searching for sealed products where the name starts with 'char' and ends with 'der' using wildcards in the 'q' parameter.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/pokemon/v1/sealed?q=name:char*der' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Example API Request to Fetch Card Data

Source: https://scrydex.com/docs/pokemon/cards

This cURL command demonstrates how to make a GET request to the Pokémon API to retrieve data for a specific card. Ensure you replace placeholder values with your actual API key and team ID.

```curl
curl --request GET \
  --url https://api.scrydex.com/pokemon/v1/cards/xy1-1 \
  --header 'X-Api-Key: <api_key_here>'
  --header 'X-Team-ID: <team_id_here>'


```

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

### Fetch Sealed Products for a Specific Expansion (cURL)

Source: https://scrydex.com/docs/pokemon/sealed

Example of fetching all sealed products for a specific expansion ('me1'), paginated, using the expansion-scoped endpoint.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/pokemon/v1/expansions/me1/sealed' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Get All Expansions

Source: https://scrydex.com/docs/lorcana/expansions

Fetches a list of all Lorcana expansions. Supports filtering and pagination through query parameters.

```APIDOC
## GET /lorcana/v1/expansions

### Description
Retrieves a list of all Lorcana expansions. Supports filtering and pagination through query parameters.

### Method
GET

### Endpoint
https://api.scrydex.com/lorcana/v1/expansions

### Query Parameters
- **q** (string) - Optional - A search query for advanced filtering. Examples: `name:reign`, `type:promo total:[* TO 20]`, `name:reign*jafar`.
- **page** (integer) - Optional - The page of data to access. Defaults to `1`.
- **page_size** (integer) - Optional - The maximum number of cards to return per page. Defaults to `100`, max is `100`.
- **select** (comma-separated string) - Optional - Specifies which fields to return in the response (e.g., `"name,logo"`). If omitted, all fields are returned.
- **casing** (string) - Optional - Allows changing the output format of the response. Supported values: `camel`, `snake`.

### Request Example
```curl
curl --request GET \
  --url https://api.scrydex.com/lorcana/v1/expansions \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```
```

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

### Example Population Report Request (cURL)

Source: https://scrydex.com/docs/magicthegathering/webhooks

Example of a cURL request to your webhook endpoint for population report updates. This demonstrates the necessary headers and the JSON payload structure.

```cURL
curl -X POST 'https://your-app.com/webhooks' \
-H 'Content-Type: application/json' \
-H 'X-Scrydex-Signature: t=123,v1=abc' \
-d '{"id":"evt_mtg_pop_123","name":"magicthegathering.expansions.pop_reports.updated","data":{"expansion_ids":["CNS"]}}'
```

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

### Sample Riftbound Card Search Response

Source: https://scrydex.com/docs/riftbound/cards

Example JSON structure for a successful card search query, including card data and pagination details.

```json
{
  "status": "success",
  "data": [
    {
      "id": "OGN-296",
      "name": "Void Gate",
      "domain": "Colorless",
      "type": "Battlefield"
    }
  ],
  "page": 1,
  "pageSize": 1,
  "totalCount": 1
}
```

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

### Order Sealed Products by Name (cURL)

Source: https://scrydex.com/docs/pokemon/sealed

Example of ordering sealed products by their name in ascending order using the 'orderBy' query parameter.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/pokemon/v1/sealed?orderBy=name' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Search Riftbound Cards by Name Prefix

Source: https://scrydex.com/docs/riftbound/cards

Use wildcard matching to find cards where the name starts with a specific prefix.

```lucene
name:voi*
```

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

### Get All Sealed Products

Source: https://scrydex.com/docs/riftbound/sealed

Fetches all sealed products from the database, paginated and unfiltered. Use for general browsing.

```http
GET https://api.scrydex.com/riftbound/v1/sealed
```

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

### Identify Card via URL Implementation

Source: https://scrydex.com/docs/vision/overview

Examples of how to call the identification endpoint using Node.js, Python, and cURL.

```javascript
const axios = require('axios');

const identifyViaUrl = async (imageUrl) => {
  const response = await axios.post('https://api.scrydex.com/vision/v1/cards/identify', {
    image_url: imageUrl,
    games: ['pokemon']
  }, {
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'X-Team-ID': 'YOUR_TEAM_ID'
    }
  });

  return response.data;
};
```

```python
import requests

def identify_via_url(image_url):
    url = "https://api.scrydex.com/vision/v1/cards/identify"
    payload = {
        "image_url": image_url,
        "games": ["pokemon"]
    }
    headers = {
        "X-Api-Key": "YOUR_API_KEY",
        "X-Team-ID": "YOUR_TEAM_ID"
    }

    response = requests.post(url, json=payload, headers=headers)
    return response.json()
```

```bash
curl -X POST 'https://api.scrydex.com/vision/v1/cards/identify' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Team-ID: YOUR_TEAM_ID' \
-d '{
  "image_url": "https://i.ebayimg.com/images/g/f7AAAeSwDgxp9s3N/s-l1600.jpg",
  "games": ["pokemon"]
}'
```

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

### Get All Riftbound Cards (cURL)

Source: https://scrydex.com/docs/riftbound/api-reference

Use this cURL command to fetch a list of all Riftbound cards. Ensure you replace 'YOUR_API_KEY' and 'YOUR_TEAM_ID' with your actual credentials.

```cURL
curl -X GET 'https://api.scrydex.com/riftbound/v1/cards' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'
```

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

### Search Sealed Products by Name (cURL)

Source: https://scrydex.com/docs/pokemon/sealed

Example of searching for sealed products that contain 'charizard' in their name using the 'q' parameter.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/pokemon/v1/sealed?q=name:charizard' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Search Sealed Products by Name (Wildcard)

Source: https://scrydex.com/docs/riftbound/sealed

Filters sealed products by name where the name starts with a specified prefix. Use for partial name matching.

```lucene
name:ori*
```

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

### Identify TCG cards via file upload

Source: https://scrydex.com/docs/vision/overview

Examples for uploading a local image file to the identification endpoint using Node.js, Python, and cURL.

```javascript
const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const identifyFile = async (filePath) => {
  const form = new FormData();
  form.append('image', fs.createReadStream(filePath));
  form.append('games', 'pokemon');

  const response = await axios.post('https://api.scrydex.com/vision/v1/cards/identify', form, {
    headers: {
      ...form.getHeaders(),
      'X-Api-Key': 'YOUR_API_KEY',
      'X-Team-ID': 'YOUR_TEAM_ID'
    }
  });

  return response.data;
};
```

```python
import requests

def identify_file(file_path):
    url = "https://api.scrydex.com/vision/v1/cards/identify"
    files = {'image': open(file_path, 'rb')}
    data = {'games': 'pokemon'}
    headers = {
        "X-Api-Key": "YOUR_API_KEY",
        "X-Team-ID": "YOUR_TEAM_ID"
    }

    response = requests.post(url, files=files, data=data, headers=headers)
    return response.json()
```

```bash
curl -X POST 'https://api.scrydex.com/vision/v1/cards/identify' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Team-ID: YOUR_TEAM_ID' \
-F 'image=@/path/to/your/card.png' \
-F 'games=pokemon'
```

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

### Identify Cards via Vision API

Source: https://scrydex.com/docs/vision/overview

Examples for sending a POST request to the card identification endpoint using different programming environments. Requires valid API and Team IDs.

```javascript
const axios = require('axios');

const identifyCard = async (imageUrl) => {
  const response = await axios.post('https://api.scrydex.com/vision/v1/cards/identify', {
    image_url: imageUrl,
    games: ['pokemon']
  }, {
    headers: {
      'X-Api-Key': 'YOUR_API_KEY',
      'X-Team-ID': 'YOUR_TEAM_ID'
    }
  });

  return response.data;
};
```

```python
import requests

def identify_card(image_url):
    url = "https://api.scrydex.com/vision/v1/cards/identify"
    payload = {
        "image_url": image_url,
        "games": ["pokemon"]
    }
    headers = {
        "X-Api-Key": "YOUR_API_KEY",
        "X-Team-ID": "YOUR_TEAM_ID"
    }

    response = requests.post(url, json=payload, headers=headers)
    return response.json()
```

```bash
curl -X POST 'https://api.scrydex.com/vision/v1/cards/identify' \
-H 'Content-Type: application/json' \
-H 'X-Api-Key: YOUR_API_KEY' \
-H 'X-Team-ID: YOUR_TEAM_ID' \
-d '{
  "image_url": "https://i.ebayimg.com/images/g/f7AAAeSwDgxp9s3N/s-l1600.jpg",
  "games": ["pokemon"]
}'
```

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

### Search Riftbound Expansions with Query Parameters

Source: https://scrydex.com/docs/riftbound/expansions

Demonstrates how to search for Riftbound expansions using various query parameters like 'q' for filtering, 'page' and 'pageSize' for pagination, and 'select' for field selection. The example shows ordering by release date in descending order.

```url
?orderBy=-release_date
```

```url
?select=id,name
```

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

### Riftbound Expansion Search Response Example

Source: https://scrydex.com/docs/riftbound/expansions

A sample JSON response for a Riftbound expansion search query, illustrating the structure of returned data including pagination details.

```json
{
  "data": [
    {
      "id": "OGN",
      "name": "Origins",
      "type": "Main",
      "total": 352,
      "language": "English",
      "language_code": "EN",
      "release_date": "2025/10/31"
    }
  ],
  "page": 1,
  "pageSize": 1,
  "totalCount": 1
}
```

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

### Get One Piece Card Data

Source: https://scrydex.com/docs/onepiece/cards

Example of how to retrieve data for a specific One Piece card using its ID.

```cURL
curl -X GET 'https://api.scrydex.com/onepiece/v1/cards/OP13-118' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'
```

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

### Search Response Example

Source: https://scrydex.com/docs/onepiece/expansions

This JSON object shows a sample response from a One Piece expansion search query, including pagination details and a list of matching expansions.

```json
{
  "data": [
    {
      "id": "OP01",
      "name": "Romance Dawn",
      "type": "Booster Pack",
      "total": 121,
      "language": "English",
      "language_code": "EN",
      "release_date": "2022/12/02"
    }
  ],
  "page": 1,
  "pageSize": 1,
  "totalCount": 1
}
```

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

### Search Query Examples (q parameter)

Source: https://scrydex.com/docs/onepiece/cards

Demonstrates various search query syntaxes for filtering cards by name, type, colors, and more. Supports keyword, phrase, exclusion, wildcard, exact, and range matching.

```lucene
name:luffy
```

```lucene
name:"Monkey.D.Luffy"
```

```lucene
name:luffy type:Character
```

```lucene
name:luffy (colors:Red OR colors:Green)
```

```lucene
type:Character -colors:Blue
```

```lucene
name:mon*
```

```lucene
name:mon*fy
```

```lucene
!name:Monkey.D.Luffy
```

```lucene
cost:[1 TO 5]
```

```lucene
power:[* TO 5000]
```

```lucene
power:[8000 TO *]
```

```lucene
expansion.id:OP01
```

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

### Get a Specific Magic: The Gathering Card (Ruby)

Source: https://scrydex.com/docs/magicthegathering/cards

Fetch a single Magic: The Gathering card using its ID in Ruby. This example uses the 'httparty' gem and requires your API and Team IDs.

```Ruby
require 'httparty'
response = HTTParty.get('https://api.scrydex.com/magicthegathering/v1/cards/KTK-214', headers: { 
  'X-Api-Key' => 'YOUR_API_KEY',
  'X-Team-ID' => 'YOUR_TEAM_ID'
})
```

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

### Get Card with Population Reports (Node.js)

Source: https://scrydex.com/docs/getting-started/pop-reports

Use this Node.js snippet to fetch card data including population reports. Ensure you have axios installed and replace 'YOUR_API_KEY' with your actual API key.

```javascript
const axios = require('axios');

const getCardWithPopReports = async (cardId) => {
  try {
    const response = await axios.get(`https://api.scrydex.com/pokemon/v1/cards/${cardId}`, {
      params: {
        include: 'pop_reports'
      },
      headers: {
        'X-Api-Key': 'YOUR_API_KEY'
      }
    });
    console.log(response.data.data.variants[0].pop_reports);
  } catch (error) {
    console.error(error);
  }
};

```

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

### Sample API Response for Expansions

Source: https://scrydex.com/docs/pokemon/expansions

Illustrates the structure of a typical JSON response when fetching expansion data, including pagination details.

```json
{
  "data": [
    {
      "id": "sm11",
      "name": "Unified Minds",
      "series": "Sun & Moon",
      "total": 260,
      "printed_total": 236,
      "language": "English",
      "language_code": "EN",
      "release_date": "2019/08/02",
      "is_online_only": false,
      "logo": "https://images.scrydex.com/pokemon/sm11-logo/logo",
      "symbol": "https://images.scrydex.com/pokemon/sm11-symbol/symbol"
    },
    {
      "id": "sm10",
      "name": "Unbroken Bonds",
      "series": "Sun & Moon",
      "total": 234,
      "printed_total": 214,
      "language": "English",
      "language_code": "EN",
      "release_date": "2019/05/03",
      "is_online_only": false,
      "logo": "https://images.scrydex.com/pokemon/sm10-logo/logo",
      "symbol": "https://images.scrydex.com/pokemon/sm10-symbol/symbol"
    },
    ...
  ],
  "page": 1,
  "pageSize": 100,
  "totalCount": 200
}
```

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

### Fetch Single One Piece Sealed Product with Select and Include (cURL)

Source: https://scrydex.com/docs/onepiece/sealed

This cURL example demonstrates how to fetch a specific sealed product while selecting only certain fields and including related resources like prices. Replace placeholders with your API key and Team ID.

```cURL
curl -X GET 'https://api.scrydex.com/onepiece/v1/sealed/OP01-s1?select=id,name,expansion.name&include=prices' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'
```

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

### Get an Expansion

Source: https://scrydex.com/docs/onepiece/expansions

Retrieves detailed information about a specific One Piece expansion using its unique ID. This is useful for getting all available data for a single expansion.

```APIDOC
## GET /onepiece/v1/expansions/{id}

### Description
Retrieve details about a specific One Piece expansion.

### Method
GET

### Endpoint
`https://api.scrydex.com/onepiece/v1/expansions/<id>`

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier for the expansion (e.g., `OP01`).

### Request Example
```curl
curl -X GET 'https://api.scrydex.com/onepiece/v1/expansions/OP01' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'
```

### Response
#### Success Response (200)
- **id** (string) - The unique identifier for the expansion.
- **name** (string) - The name of the expansion.
- **type** (string) - The type of expansion.
- **code** (string) - The code for the expansion.
- **total** (integer) - The total number of cards in the expansion.
- **release_date** (string) - The release date of the expansion (YYYY/MM/DD).
- **logo** (string) - URL for the expansion logo.
- **language** (string) - The language of the expansion.
- **language_code** (string) - The language code of the expansion.

#### Response Example
```json
{
  "id": "OP13",
  "name": "Carrying On His Will",
  "type": "Booster Pack",
  "code": "OP13",
  "total": 120,
  "release_date": "2025/11/07",
  "logo": "https://images.scrydex.com/onepiece/OP13-logo/logo",
  "language": "English",
  "language_code": "EN"
}
```
```

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

### Get Gundam Card Data

Source: https://scrydex.com/docs/gundam/cards

Use this GET request to retrieve details for a specific Gundam card. Ensure you replace `<api_key_here>` and `<team_id_here>` with your actual credentials.

```curl
curl --request GET \
  --url https://api.scrydex.com/gundam/v1/cards/ST02-002 \
  --header 'X-Api-Key: <api_key_here>'
  --header 'X-Team-ID: <team_id_here>'
```

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

### Riftbound Expansion Object Example

Source: https://scrydex.com/docs/riftbound/expansions

A JSON representation of a Riftbound expansion, detailing its properties like ID, name, type, card counts, release date, and language.

```json
{
  "id": "OGN",
  "name": "Origins",
  "type": "Main",
  "code": "OGN",
  "total": 352,
  "printed_total": 298,
  "release_date": "2025/10/31",
  "logo": "https://images.scrydex.com/riftbound/OGN-logo/logo",
  "language": "English",
  "language_code": "EN"
}
```

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

### Order Sealed Products by Multiple Fields (cURL)

Source: https://scrydex.com/docs/pokemon/sealed

Example of ordering sealed products by name in ascending order and then by expansion sort order in descending order using the 'orderBy' query parameter.

```cURL
curl --request GET \
  --url 'https://api.scrydex.com/pokemon/v1/sealed?orderBy=name,-expansion_sort_order' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

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

### Implement Caching with Redis in Python

Source: https://scrydex.com/docs/getting-started/best-practices

This Python example shows how to retrieve card data from the Scrydex API and store it in Redis for 15 minutes. It prioritizes cached data, fetching from the API only when necessary.

```python
import requests
import redis
import json

# Initialize Redis
redis_conn = redis.Redis()

def fetch_card_data_with_cache(card_id, redis_conn):
    cache_key = f"scrydex:card:{card_id}"

    # Check if data is cached in Redis
    if redis_conn.exists(cache_key):
        print("Fetching data from Redis cache...")
        cached_data = redis_conn.get(cache_key)
        return json.loads(cached_data)

    # If not cached, fetch data from the API
    print("Fetching data from Scrydex API...")
    url = f"https://api.scrydex.com/pokemon/v1/cards/{card_id}"
    headers = {
        "X-Api-Key": "YOUR_API_KEY",
        "X-Team-ID": "YOUR_TEAM_ID"
    }

    response = requests.get(url, headers=headers)

    if response.status_code == 200:
        # Parse JSON response and cache it in Redis for 15 minutes
        data = response.json()
        redis_conn.setex(cache_key, 15 * 60, json.dumps(data))
        return data
    else:
        print(f"Error fetching data: {response.status_code} - {response.reason}")
        return None

# Example usage
if __name__ == "__main__":
    card_id = "xy1-1"  # Replace this with a valid card ID
    card_data = fetch_card_data_with_cache(card_id, redis_conn)
    print(card_data)

```

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

### Implement Caching with Redis in Ruby

Source: https://scrydex.com/docs/getting-started/best-practices

This Ruby example demonstrates how to fetch card data from the Scrydex API and cache it in Redis for 15 minutes. It checks the cache first and only queries the API if the data is not present or has expired.

```ruby
require "httparty"
require "json"
require "redis"

# Initialize Redis
redis = Redis.new

# Fetch data from the Scrydex API with caching
def fetch_card_data_with_cache(card_id, redis_conn)
  cache_key = "scrydex:card:#{card_id}"

  # Check if data is cached in Redis
  if redis_conn.exists(cache_key)
    puts "Fetching data from Redis cache..."
    cached_data = redis_conn.get(cache_key)
    return JSON.parse(cached_data)
  end

  puts "Fetching data from Scrydex API..."
  response = HTTParty.get(
    "https://api.scrydex.com/pokemon/v1/cards/#{card_id}",
    headers: {
      "X-Api-Key" => "YOUR_API_KEY",
      "X-Team-ID" => "YOUR_TEAM_ID"
    }
  )

  if response.code == 200
    # Parse JSON and cache in Redis for 15 minutes
    redis_conn.setex(cache_key, 15 * 60, response.body)
    return JSON.parse(response.body)
  else
    puts "Error fetching data: #{response.code} #{response.message}"
    return nil
  end
end

# Example usage
card_id = "xy1-1" # Replace with a valid card ID
card_data = fetch_card_data_with_cache(card_id, redis)
puts card_data

```

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

### Get Specific Expansion

Source: https://scrydex.com/docs/lorcana/expansions

Retrieves a specific Lorcana expansion by its unique identifier.

```APIDOC
## GET /lorcana/v1/expansions/{id}

### Description
Retrieves a specific Lorcana expansion by its unique identifier.

### Method
GET

### Endpoint
https://api.scrydex.com/lorcana/v1/expansions/<id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the expansion to retrieve.

#### Query Parameters
- **select** (comma-separated string) - Optional - Specifies which fields to return in the response (e.g., `"name,logo"`).
- **casing** (string) - Optional - Allows changing the output format of the response. Supported values: `camel`, `snake`.

### Request Example
```curl
curl --request GET \
  --url https://api.scrydex.com/lorcana/v1/expansions/ROJ \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```
```

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

### Get Japanese Expansions

Source: https://scrydex.com/docs/pokemon/api-reference

Retrieves a list of Pokemon expansions specifically for the Japanese language.

```APIDOC
## GET /pokemon/v1/ja/expansions

### Description
Retrieves a list of Pokemon expansions specifically for the Japanese language.

### Method
GET

### Endpoint
https://api.scrydex.com/pokemon/v1/ja/expansions

### Request Example
```curl
curl -X GET 'https://api.scrydex.com/pokemon/v1/ja/expansions' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```
```

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

### Search Gundam Cards with Query Parameters

Source: https://scrydex.com/docs/gundam/cards

Demonstrates how to search for Gundam cards using various query parameters like 'q' for advanced filtering, 'select' for specific fields, and 'orderBy' for sorting.

```plaintext
plaintext name:freedom 
```

```plaintext
plaintext name:"freedom gundam" 
```

```plaintext
plaintext name:gundam colors:green 
```

```plaintext
plaintext name:gundam (colors:green OR colors:blue) 
```

```plaintext
plaintext name:gundam -colors:blue 
```

```plaintext
plaintext name:sky* 
```

```plaintext
plaintext name:sky*easy 
```

```plaintext
plaintext !name:skygrasper 
```

```plaintext
plaintext level:[1 TO 3] 
```

```plaintext
plaintext level:[* TO 3] 
```

```plaintext
plaintext level:[5 TO *] 
```

```plaintext
plaintext expansion.id:ST02 
```

```plaintext
plaintext effects.timings:deploy 
```

```plaintext
plaintext ?orderBy=number 
```

```plaintext
plaintext ?orderBy=name,-number 
```

```plaintext
plaintext ?select=id,name 
```

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

### Get English Expansions

Source: https://scrydex.com/docs/pokemon/api-reference

Retrieves a list of Pokemon expansions specifically for the English language.

```APIDOC
## GET /pokemon/v1/en/expansions

### Description
Retrieves a list of Pokemon expansions specifically for the English language.

### Method
GET

### Endpoint
https://api.scrydex.com/pokemon/v1/en/expansions

### Request Example
```curl
curl -X GET 'https://api.scrydex.com/pokemon/v1/en/expansions' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```
```

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

### Get Japanese Cards

Source: https://scrydex.com/docs/pokemon/api-reference

Retrieves a list of Pokemon cards specifically for the Japanese language.

```APIDOC
## GET /pokemon/v1/ja/cards

### Description
Retrieves a list of Pokemon cards specifically for the Japanese language.

### Method
GET

### Endpoint
https://api.scrydex.com/pokemon/v1/ja/cards

### Request Example
```curl
curl -X GET 'https://api.scrydex.com/pokemon/v1/ja/cards' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```
```

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

### Get English Cards

Source: https://scrydex.com/docs/pokemon/api-reference

Retrieves a list of Pokemon cards specifically for the English language.

```APIDOC
## GET /pokemon/v1/en/cards

### Description
Retrieves a list of Pokemon cards specifically for the English language.

### Method
GET

### Endpoint
https://api.scrydex.com/pokemon/v1/en/cards

### Request Example
```curl
curl -X GET 'https://api.scrydex.com/pokemon/v1/en/cards' \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```
```

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

### Get Pokemon Price History

Source: https://scrydex.com/docs/pokemon/price-history

Fetches the price history for a given Pokémon card by its ID.

```APIDOC
## GET /pokemon/v1/cards/{cardId}/price_history

### Description
Retrieves the historical pricing data for a specific Pokémon card identified by its unique ID.

### Method
GET

### Endpoint
/pokemon/v1/cards/{cardId}/price_history

### Parameters
#### Path Parameters
- **cardId** (string) - Required - The unique identifier of the Pokémon card.

#### Query Parameters
None

#### Request Body
None

### Request Example
```curl
curl --request GET \
  --url https://api.scrydex.com/pokemon/v1/cards/xy1-1/price_history \
  --header 'X-Api-Key: <api_key_here>' \
  --header 'X-Team-ID: <team_id_here>'
```

### Response
#### Success Response (200)
- **data** (array) - An array of price history objects.
  - **variant** (string) - The variant of the card (e.g., "reverseHolofoil").
  - **condition** (string) - The condition of the card (e.g., "MP").
  - **is_perfect** (boolean) - Indicates if the card is in perfect condition.
  - **is_signed** (boolean) - Indicates if the card is signed.
  - **is_error** (boolean) - Indicates if there was an error retrieving this data point.
  - **type** (string) - The type of price data (e.g., "raw").
  - **low** (number) - The lowest recorded price.
  - **market** (number) - The market price.
  - **currency** (string) - The currency of the prices (e.g., "USD").
- **page** (integer) - The current page number of the results.
- **page_size** (integer) - The number of results per page.
- **count** (integer) - The number of results on the current page.
- **total_count** (integer) - The total number of results available.

#### Response Example
```json
{
  "data": [
    {
      "variant": "holofoil",
      "condition": "NM",
      "is_perfect": false,
      "is_signed": false,
      "is_error": false,
      "type": "raw",
      "low": 0.12,
      "market": 0.16,
      "currency": "USD"
    },
    {
      "variant": "reverseHolofoil",
      "condition": "MP",
      "is_perfect": false,
      "is_signed": false,
      "is_error": false,
      "type": "raw",
      "low": 0.24,
      "market": 0.06,
      "currency": "USD"
    }
  ],
  "page": 1,
  "page_size": 30,
  "count": 2,
  "total_count": 2
}
```
```

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

### Get Card Information

Source: https://scrydex.com/docs/gundam/cards

Retrieves detailed information about a specific Gundam card using its ID.

```APIDOC
## GET /gundam/v1/cards/{cardId}

### Description
Retrieves detailed information about a specific Gundam card.

### Method
GET

### Endpoint
/gundam/v1/cards/{cardId}

### Parameters
#### Path Parameters
- **cardId** (string) - Required - The unique identifier of the card.

#### Query Parameters
None

#### Request Body
None

### Request Example
```curl
curl --request GET \
  --url https://api.scrydex.com/gundam/v1/cards/ST02-002 \
  --header 'X-Api-Key: <api_key_here>'
  --header 'X-Team-ID: <team_id_here>'
```

### Response
#### Success Response (200)
- **name** (string) - The name of the card.
- **images** (array) - A list of image objects for the card.
  - **type** (string) - The type of image (e.g., 'front').
  - **small** (string) - URL for the small version of the image.
  - **medium** (string) - URL for the medium version of the image.
  - **large** (string) - URL for the large version of the image.
- **prices** (array) - A list of pricing information for the card (currently empty in example).

#### Response Example
```json
{
  "name": "ST02-002",
  "images": [
    {
      "type": "front",
      "small": "https://images.scrydex.com/gundam/ST02-002/small",
      "medium": "https://images.scrydex.com/gundam/ST02-002/medium",
      "large": "https://images.scrydex.com/gundam/ST02-002/large"
    }
  ],
  "prices": []
}
```
```

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

### Sample API Response for Expansion Search

Source: https://scrydex.com/docs/lorcana/expansions

A sample JSON response structure for a query that retrieves Lorcana expansion data, including details like id, name, and total cards.

```json
{
  "data": [
    {
      "id": "ITI",
      "name": "Into the Inklands",
      "code": "3",
      "type": "Main",
      "total": 226,
      "printed_total": 204,
      "release_date": "2024/02/23",
      "language": "English",
      "language_code": "EN",
      "logo": "https://images.scrydex.com/lorcana/ITI-logo/logo"
    },
    {
      "id": "ROTF",
      "name": "Rise of the Floodborn",
      "code": "2",
      "type": "Main",
      "total": 216,
      "printed_total": 204,
      "release_date": "2023/11/17",
      "language": "English",
      "language_code": "EN",
      "logo": "https://images.scrydex.com/lorcana/ROTF-logo/logo"
    },
    ...
  ],
  "page": 1,
  "pageSize": 100,
  "totalCount": 200
}
```

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

### Authenticate API Request using Python

Source: https://scrydex.com/docs/getting-started/authentication

This Python script shows how to make an authenticated GET request to the Scrydex API using the requests library. Remember to substitute YOUR_API_KEY and YOUR_TEAM_ID with your actual API key and Team ID.

```python
import requests

headers = {
    'X-Api-Key': 'YOUR_API_KEY',
    'X-Team-ID': 'YOUR_TEAM_ID'
}
response = requests.get('https://api.scrydex.com/pokemon/v1/cards', headers=headers)
print(response.text)
```

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

### Get Card Data

Source: https://scrydex.com/docs/onepiece/cards

Retrieves detailed information for a specific One Piece card using its ID.

```APIDOC
## GET /onepiece/v1/cards/{cardId}

### Description
Retrieves detailed information for a specific One Piece card.

### Method
GET

### Endpoint
/onepiece/v1/cards/{cardId}

### Parameters
#### Path Parameters
- **cardId** (string) - Required - The unique identifier of the card.

#### Request Headers
- **X-Api-Key** (string) - Required - Your API key for authentication.
- **X-Team-ID** (string) - Required - Your team ID for authentication.

### Response
#### Success Response (200)
- **is_error** (boolean) - Indicates if an error occurred.
- **type** (string) - The type of data returned.
- **low** (float) - The lowest market price.
- **market** (float) - The current market price.
- **currency** (string) - The currency of the prices.
- **trends** (object) - Price trends over different periods.
  - **days_1** (object) - Trends for the last 1 day.
    - **price_change** (float) - The price change in the last day.
    - **percent_change** (float) - The percentage price change in the last day.
  - **days_7** (object) - Trends for the last 7 days.
    - **price_change** (float) - The price change in the last 7 days.
    - **percent_change** (float) - The percentage price change in the last 7 days.

### Request Example
```curl
curl -X GET 'https://api.scrydex.com/onepiece/v1/cards/OP13-118' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'
```

### Response Example
```json
{
  "is_error": false,
  "type": "raw",
  "low": 20000.0,
  "market": 8566.65,
  "currency": "USD",
  "trends": {
    "days_1": {
      "price_change": 0.0,
      "percent_change": 0.0
    },
    "days_7": {
      "price_change": 0.0,
      "percent_change": 0.0
    }
  }
}
```
```

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

### Sample API Response for Sealed Products

Source: https://scrydex.com/docs/onepiece/sealed

A sample JSON response illustrating the structure of data returned for a sealed product search query.

```json
{
  "status": "success",
  "data": [
    {
      "id": "OP01-s1",
      "name": "Romance Dawn - Booster Pack",
      "type": "Booster Pack",
      "images": [
        {
          "type": "front",
          "small": "https://images.scrydex.com/onepiece/OP01-s1/small",
          "medium": "https://images.scrydex.com/onepiece/OP01-s1/medium",
          "large": "https://images.scrydex.com/onepiece/OP01-s1/large"
        }
      ],
      "expansion": {
        "id": "OP01",
        "name": "Romance Dawn",
        "type": "Booster Pack",
        "code": "OP01",
        "total": 121,
        "total_unique_variants": 158,
        "release_date": "2022/12/02",
        "logo": "https://images.scrydex.com/onepiece/OP01-logo/logo",
        "language": "English",
        "language_code": "EN"
      },
      "expansion_sort_order": 1,
      "variants": [
        {
          "name": "normal",
          "prices": []
        }
      ]
    }
  ],
  "page": 1,
  "pageSize": 1,
  "totalCount": 1
}
```

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

### Get price history

Source: https://scrydex.com/docs/gundam/price-history

Retrieves a list of historical price points for a specific card by its unique identifier.

```APIDOC
## GET /gundam/v1/cards/<id>/price_history

### Description
This endpoint retrieves a list of historical price points for a specific card by its unique identifier.

### Method
GET

### Endpoint
/gundam/v1/cards/<id>/price_history

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the card to retrieve price history for.

#### Query Parameters
- **days** (integer) - Optional - The number of days back from the current day to fetch price history for.
- **start_date** (string) - Optional - The start date for the price history range (format: YYYY-MM-DD).
- **end_date** (string) - Optional - The end date for the price history range (format: YYYY-MM-DD).
- **variant** (string) - Optional - Filter the results by variant.
- **condition** (string) - Optional - Filter the results by condition (e.g., "NM", "LP").
- **company** (string) - Optional - Filter the results by grading company.
- **grade** (string) - Optional - Filter the results by grade.
- **is_perfect** (boolean) - Optional - Filter by perfect condition.
- **is_error** (boolean) - Optional - Filter by error card.
- **is_signed** (boolean) - Optional - Filter by signed card.
- **page** (integer) - Optional - The current page of results.
- **page_size** (integer) - Optional - The number of results per page.

### Request Example
```curl
curl --request GET \
  --url https://api.scrydex.com/gundam/v1/cards/GD01-001/price_history \
  --header 'X-Api-Key: <api_key_here>'
  --header 'X-Team-ID: <team_id_here>'
```
```

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

### Order Expansions by Name and Total

Source: https://scrydex.com/docs/lorcana/expansions

Combine ascending and descending order for multiple fields, such as sorting by name (ASC) and then by total (DESC).

```text
?orderBy=name,-total
```

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

### Search Sealed Products by Name Wildcard

Source: https://scrydex.com/docs/onepiece/sealed

Finds sealed products where the 'name' field starts with 'rom'.

```http
GET ?q=name:rom*
```

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

### Search Lorcana Cards by Name Prefix

Source: https://scrydex.com/docs/lorcana/cards

Finds Lorcana cards where the name starts with a specified prefix.

```plaintext
plaintext name:mi* 
```

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

### Get All Riftbound Cards (Paginated)

Source: https://scrydex.com/docs/riftbound/cards

Retrieve all Riftbound cards with pagination. Supports query parameters for filtering and selection.

```http
GET https://api.scrydex.com/riftbound/v1/cards
```
Tokens:
Raw