> 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/payment/coin.md).

# Coin

This document describes the API endpoints for managing coin-related data (deposits, withdrawals, and prices).

**Base URL**: `/coin`

***

### Endpoints

#### 1. GET `/coin/deposits`

Fetch the deposit history for the authenticated user.

* **Authentication Required**: Yes \<JWT Token (Bearer)>
* **Method**: `GET`
* **URL**: `/coin/deposits`

**Response**

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

```json
[
  {
    "steamid": "76561198012345678",
    "txhash": "0x123abc...",
    "asset": "ETH",
    "amount": "0.1",
    "usdAmount": 350.50,
    "sweepstakeAmount": 350.50,
    "source": "coinbase",
    "date": "2023-10-27T10:00:00.000Z"
  },
  ...
]
```

| Field              | Type   | Description                                                 |
| ------------------ | ------ | ----------------------------------------------------------- |
| `steamid`          | String | The SteamID of the user.                                    |
| `txhash`           | String | The transaction hash on the blockchain.                     |
| `asset`            | String | The cryptocurrency asset symbol (e.g., ETH, BTC).           |
| `amount`           | String | The amount deposited in crypto units.                       |
| `usdAmount`        | Number | The value of the deposit in USD at the time of transaction. |
| `sweepstakeAmount` | Number | The sweepstake value associated with the deposit.           |
| `source`           | String | The source of the deposit.                                  |
| `date`             | Date   | The timestamp of the deposit.                               |

**Errors**

| Status Code | Description                          |
| ----------- | ------------------------------------ |
| `401`       | Unauthorized. User is not logged in. |
| `500`       | Internal Server Error.               |

***

#### 2. GET `/coin/withdraws`

Fetch the withdrawal history for the authenticated user.

* **Authentication Required**: Yes \<JWT Token (Bearer)>
* **Method**: `GET`
* **URL**: `/coin/withdraws`

**Response**

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

```json
[
  {
    "steamid": "76561198012345678",
    "to": "0xUserWalletAddress...",
    "txhash": "0x456def...",
    "asset": "BTC",
    "amount": "0.005",
    "usdAmount": 450.00,
    "date": "2023-10-28T14:30:00.000Z"
  },
  ...
]
```

| Field       | Type   | Description                                                    |
| ----------- | ------ | -------------------------------------------------------------- |
| `steamid`   | String | The SteamID of the user.                                       |
| `to`        | String | The destination wallet address.                                |
| `txhash`    | String | The transaction hash on the blockchain.                        |
| `asset`     | String | The cryptocurrency asset symbol.                               |
| `amount`    | String | The amount withdrawn in crypto units.                          |
| `usdAmount` | Number | The value of the withdrawal in USD at the time of transaction. |
| `date`      | Date   | The timestamp of the withdrawal.                               |

**Errors**

| Status Code | Description                          |
| ----------- | ------------------------------------ |
| `401`       | Unauthorized. User is not logged in. |
| `500`       | Internal Server Error.               |

***

#### 3. GET `/coin/prices`

Fetch current cryptocurrency prices (Bitcoin, Ethereum, Litecoin) in USD.

* **Authentication Required**: No
* **Method**: `GET`
* **URL**: `/coin/prices`
* **Caching**: This endpoint caches prices for 1 hour to optimize performance and respect API rate limits.

**Response**

Returns an object containing the current prices.

```json
{
    "Bitcoin": 95000,
    "Ethereum": 3500,
    "Litecoin": 90,
    "Tether": 1
}
```

**Errors**

| Status Code | Description                                                                                         |
| ----------- | --------------------------------------------------------------------------------------------------- |
| `500`       | Internal Server Error. May occur if the upstream price API fails or `COINGECKO_API_KEY` is missing. |


---

# 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/payment/coin.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.