# Token smart money bias

- Method: `GET`
- Path: `/token/{id}/smart-money-bias`
- Tier: Pro
- HTML docs: https://docs.hiddensystems.ai/nebula/reference/get-token-id-smart-money-bias/
- Interactive docs: https://docs.hiddensystems.ai/nebula/#endpoint=get-token-id-smart-money-bias

## Description

Current bias (smart money sentiment minus overall sentiment) in basis points.

## cURL Example

```bash
curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/token/bitcoin/smart-money-bias' \
  --header 'X-API-Key: YOUR_API_KEY'
```

## Path Parameters

- `id` (string, required): Token identifier. Accepts internal token_id (integer) or coingecko_id (string, e.g. bitcoin).

## Query Parameters

- `hours` (integer, optional): Lookback window in hours.
- `granularity` (string, optional): Optional bucket size override. If provided, response is aggregated at this interval regardless of lookback window.

## Response

OK

- `current` (object): Latest point-in-time smart-money bias metrics.
- `current.bucket_start` (string (date-time)): UTC bucket start timestamp.
- `current.overall_sentiment_score` (number (double)): Overall sentiment score (0-100).
- `current.sentiment_bias_bps` (number (double)): Difference between smart-money and overall sentiment, in basis points.
- `current.smart_money_sentiment_score` (number (double)): Smart-money cohort sentiment score (0-100).

Media type: `application/json`

## JSON Response

```json
{
  "current": {
    "bucket_start": "2026-01-15T12:00:00Z",
    "overall_sentiment_score": 0,
    "sentiment_bias_bps": 0,
    "smart_money_sentiment_score": 0
  }
}
```