---
title: "Include-scoped token intelligence (PRO+)"
method: GET
path: "/rhc/tokens/{address}/intelligence"
tags: ["Robinhood Chain"]
---

# Include-scoped token intelligence (PRO+)

`GET /rhc/tokens/{address}/intelligence`

## Request

- Base URL: `https://madeonsol.com/api/v1`
- URL: `https://madeonsol.com/api/v1/rhc/tokens/{address}/intelligence`
- Auth: HTTP bearer

Include-scoped token intelligence for terminals: name the panels you need with `include` (comma-separated, no default). Each module is the existing keyed endpoint run in process with your plan, returned with its own `status` (ready | partial_history | unverified | unavailable | timeout), `as_of`, `provenance` and history coverage. One module failing never fails or zeroes another. Trade-derived modules are `partial_history` unless the source proves a complete interval. There is no global readiness claim. Budget: at most 5 modules and total cost 8. Modules: `snapshot` (cost 2, point_in_time, source /api/v1/rhc/tokens/{address}); `risk` (cost 2, point_in_time, source /api/v1/rhc/tokens/{address}/risk); `buyer_quality` (cost 2, trade_derived, source /api/v1/rhc/tokens/{address}/buyer-quality); `holders` (cost 3, point_in_time, source /api/v1/rhc/tokens/{address}/holders); `holder_count` (cost 1, point_in_time, source rhc_token_concentration() + rhc_token_holder_recon (same count as /api/v1/rhc/tokens/{address}/holders concentration.holder_count)); `flow` (cost 3, trade_derived, source /api/v1/rhc/tokens/{address}/flow); `kol` (cost 1, trade_derived, source /api/v1/rhc/tokens/{address}/kol-consensus); `locks` (cost 1, point_in_time, source /api/v1/rhc/tokens/{address}/locks); `top_traders` (cost 2, trade_derived, source /api/v1/rhc/tokens/{address}/top-traders).

## Path parameters

- `address` string, required

## Query parameters

- `include` string, required

## Response `200`

Per-module results.

- object
  - `contract_version` 1, required
  - `chain` 'robinhood-chain', required
  - `chain_id` 4663, required
  - `address` string, required
  - `address_format` 'evm_hex', required
  - `native_asset` 'ETH', required
  - `requested` string[], required
  - `generated_at` string, date-time, required: Response assembly time, not an observation time.
  - `budget` object, required
  - `summary` object, required
  - `modules` object, required

## Other responses

- `400`: invalid_address, include_required, unknown_include or include_budget_exceeded.
- `401`: Missing or invalid API key, or an expired free-tier key. Authentication-stage error: no `X-RateLimit-*` headers, no `_rid`.
- `403`: Plan below PRO.
- `404`: Not enabled (TOKEN_INTELLIGENCE_API off).
- `429`: Rate or daily limit reached (the composite counts as one call).
- `500`: Unexpected server error from the route (`Internal server error`, with `_rid`). Safe to retry with backoff. A failed API-key lookup is a 503 `auth_backend_unavailable`, never a 500.
- `503`: The API-key or subscription lookup could not be answered (authentication stage). Retryable and not your fault: it is never counted as a failed authentication. Honour `Retry-After`; no `X-RateLimit-*`, no `_rid`.

---

[API](https://skmtc.dev/madeonsol/apis/madeonsol-api.md) · [All operations](https://skmtc.dev/madeonsol/apis/madeonsol-api/llms.txt) · [OpenAPI document](https://skmtc.dev/madeonsol/apis/madeonsol-api/revisions/d9531a28d83b?raw)