> For the complete documentation index, see [llms.txt](https://roqqu-api-services.gitbook.io/ras/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roqqu-api-services.gitbook.io/ras/transaction/token-deposits.md).

# Token Deposits

Retrieve token deposit transactions for the authenticated merchant.

**Endpoint:** `GET /transaction/token-deposit`

**Authentication:** Required (`x-api-key` for live, `x-staging-api-key` for test)

#### **Example Request**

```
curl -X GET https://service.roqqu.com/v1/transaction/token-deposit \
  -H "x-api-key: YOUR_API_KEY"
```

#### **Example Response (Success)**

```
{
  "status": "success",
  "message": "deposits retrieved successfully",
  "data": [
    {
      "ref": "48291037465829103746",
      "status": 1,
      "genesis": 0,
      "email": "merchant@business.com",
      "value": 2,
      "network": "erc20",
      "token": "usdt",
      "address": "0xfa624f26737cdd712572b45bd5d5ebc9f9f124c3",
      "sender": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "extra": null,
      "tx_hash": "0xdeccb101ea58b71a57ca4dc4a2dbf0887de775409a8096b05a277518e96010ce",
      "output_pos": null,
      "customer": null,
      "total_received": 0,
      "created_at": "2025-12-20T20:42:28.000Z",
      "updated_at": "2025-12-21T17:45:49.000Z",
      "deleted_at": null
    }
  ]
}
```

**Deposit status values**

| Status | Meaning  |
| ------ | -------- |
| 1      | Credited |

`network` is the network code to parse (e.g. `erc20`, `bitcoin`).

**Error Responses**

**Invalid merchant:**

```
{
  "status": "fail",
  "message": "Invalid merchant"
}
```

**Merchant does not exist:**

```
{
  "status": "fail",
  "message": "Merchant does not exist"
}
```