> For the complete documentation index, see [llms.txt](https://trident-cas.sabn.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trident-cas.sabn.xyz/api/irl-in-real-life-cases.md).

# IRL (In Real Life) Cases

This document describes the API endpoints for managing IRL (Real-Life Items) cases.

**Base URL**: `/irl`

***

### Endpoints

#### 1. GET `/irl`

Fetch all available IRL cases.

* **Authentication Required**: No
* **Method**: `GET`
* **URL**: `/irl`

**Response**

Returns an array of case objects, sorted in reverse chronological order (newest first).

```json
[
  {
    "id": "luxury-liquidity",
    "name": "Luxury Liquidity",
    "price": 3700,
    "items": [
      {
        "name": "Richard Mille RM055 Replica",
        "image": "https://cdn.luckyrust.gg/irl-items/...",
        "price": "8100",
        "percentage": 2
      },
      ...
    ],
    "spins": 1500
  },
  ...
]
```

| Field   | Type   | Description                                      |
| ------- | ------ | ------------------------------------------------ |
| `id`    | String | Unique identifier for the case.                  |
| `name`  | String | Display name of the case.                        |
| `price` | Number | Cost to open the case.                           |
| `items` | Array  | List of items contained in the case.             |
| `spins` | Number | Total number of times this case has been opened. |

**CaseItem Object:**

| Field        | Type   | Description                                                        |
| ------------ | ------ | ------------------------------------------------------------------ |
| `name`       | String | Name of the item.                                                  |
| `image`      | String | URL to the item's image.                                           |
| `price`      | String | Value of the item.                                                 |
| `percentage` | Number | Probability of winning this item (default split if not specified). |

**Errors**

| Status Code | Description            |
| ----------- | ---------------------- |
| `500`       | Internal Server Error. |

***

#### 2. GET `/irl/:id`

Fetch a specific IRL case by its ID.

* **Authentication Required**: No
* **Method**: `GET`
* **URL**: `/irl/:id`

**Parameters**

| Parameter | Type   | Description                                    |
| --------- | ------ | ---------------------------------------------- |
| `id`      | String | The ID of the case (e.g., `luxury-liquidity`). |

**Response**

Returns a single case object. Items are sorted by percentage (ascending).

```json
{
  "id": "luxury-liquidity",
  "name": "Luxury Liquidity",
  "price": 3700,
  "items": [
    {
      "name": "Item Name",
      "image": "https://...",
      "price": "100",
      "percentage": 0.5
    },
    ...
  ]
}
```

| Field   | Type   | Description                          |
| ------- | ------ | ------------------------------------ |
| `id`    | String | Unique identifier for the case.      |
| `name`  | String | Display name of the case.            |
| `price` | Number | Cost to open the case.               |
| `items` | Array  | List of items, sorted by percentage. |

**Errors**

| Status Code | Description            |
| ----------- | ---------------------- |
| `400`       | Invalid Case ID.       |
| `404`       | Case not found.        |
| `500`       | Internal Server Error. |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://trident-cas.sabn.xyz/api/irl-in-real-life-cases.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.