# Get the language model results of an AI

`GET https://api.cryptohopper.com/v1/ai/{ai_id}/airesults`

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

Returns the verdicts the language model gave for one of your AIs, newest first: the buy, sell or neutral signal per market with its value, explanation and credit cost.

The handler checks no OAuth scope. An AI that is not yours returns 404 AI not found.

## Headers

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

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `ai_id` | string | yes | Numeric ID of one of your AIs. |

## Query parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `pair` | string | no | Optional market to filter on, in the exchange's own market notation as returned in the pair field. |
| `start` | string | no | Optional row offset for paging. Default 0. |
| `exchange` | string | no | Optional exchange key to filter on, for example binance. |
| `limit` | string | no | Optional number of results, 1 to 500. Default 500. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/ai/AI_ID/airesults" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": [
        {
            "id": "13722001",
            "exchange": "binance",
            "pair": "BTCUSDT",
            "base": "BTC",
            "quote": "USDT",
            "model": "deepseek/deepseek-chat",
            "signal": "buy",
            "signal_value": "72.00",
            "signal_description": "Higher lows on the 1h chart and rising volume support a continuation.",
            "ai_credits": "0.50",
            "created": "2026-09-25 08:00:04"
        }
    ]
}
```

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.