# Get user purchases

`GET https://api.cryptohopper.com/v1/user/purchases`

Part of [Users](https://www.cryptohopper.com/api-documentation/api-reference/users.md) in the Cryptohopper API reference.

Returns the user's paid Marketplace purchases, newest first, at most 200. Copy trading purchases are left out.

OAuth scope: `read`, `user`

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/user/purchases" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": "623000",
            "seller_id": "234567",
            "buyer_id": "123456",
            "transaction_id": "391000",
            "payment_method_id": "2",
            "confirm_code": null,
            "payment_link": null,
            "item_id": "45678",
            "item_type": "template",
            "status": "Completed",
            "price": "25.00",
            "subtotal": "25.00",
            "payment_fee": "0.00",
            "tax": "0.00",
            "total": "25.00",
            "user_params": null,
            "tax_id": "0",
            "payment_cur": "USD",
            "payment_cur_rate": "0.00000000",
            "payment_total": "0.00",
            "created": "2026-09-01 10:15:00",
            "updated": "2026-09-01 10:15:00",
            "current_version": "1",
            "auto_update": "0",
            "update_months": "1",
            "update_until": null,
            "is_eu": "0",
            "eu_business": null,
            "hidden": "0",
            "paid": "0",
            "payout_id": "0",
            "deleted": "0",
            "product_name": "BTC trend template"
        }
    ]
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.
