# List your AI credit transactions

`GET https://api.cryptohopper.com/v1/ai/credits/transactions`

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

Returns the credits added to and used from your AI credit balance, newest first, up to 500, with the name of the AI that used them.

The handler checks no OAuth scope. transaction_type is in for credits added and out for credits used. ai_id is 0 and ai_name null for transactions not tied to an AI.

## 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/ai/credits/transactions" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": "66901",
            "user_id": "123456",
            "ai_id": "87001",
            "transaction_type": "out",
            "total_credits": "0.50",
            "description": "AI Credits use",
            "created": "2026-09-25 08:00:04",
            "ai_name": "My BTC AI"
        }
    ]
}
```

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.