---
title: "Get Alive Token"
method: GET
path: "/v1/benches/{token_address}"
tags: ["dashboard"]
---

# Get Alive Token

`GET /v1/benches/{token_address}`

## Request

- Base URL: `https://alive-api.alphakek.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://alive-api.alphakek.ai/v1/benches/{token_address}`
- Auth: none declared

Get a single alive token by address.

## Path parameters

- `token_address` string, required

## Query parameters

- `fields` string, nullable: Comma-separated fields to include (e.g. 'name,symbol,conviction')

## Response `200`

Successful Response

- TokenWithLevel: Alive token for API responses. Level fields are LIVE as of migration 061. ``level`` is a high-water-mark ratchet column maintained by the fee worker (``max(level, floor(total_fees_sol / 0.5))``; was generated until migration 092); the other two are computed in dashboard.py from ``total_fees_sol``, ``level``, and ``LEVEL_FEE_THRESHOLD_SOL``. Frontend renders these as a level number + progress bar to the next level — the gamification surface for "earn fees → earn compute."
  - `id` string, uuid, required
  - `token_address` string, required
  - `name` string, required
  - `symbol` string, required
  - `image_url` string, nullable
  - `onchain_description` string, nullable
  - `conviction` string, nullable
  - `hot_wallet_address` string, nullable
  - `creator_wallet_address` string, nullable
  - `total_fees_usd` string, required
  - `total_fees_sol` string, required
  - `total_requests` integer, required
  - `is_active` boolean, required
  - `created_at` string, date-time, required
  - `activated_at` string, date-time, nullable
  - `level` integer
  - `level_progress` number
  - `fees_to_next_level` string
  - `max_data_sources` integer
  - `quality_tier` string
  - `bench_summary` object, nullable
  - `market_cap_usd` string, nullable
  - `market_cap_raw` number, nullable
  - `volume_24h` number, nullable
  - `liquidity_usd` number, nullable
  - `bounty_balance_raw` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `b6d96e7673dc`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/alphakek-ai/apis/aikek-api/changes/v1/benches/:token_address/get.md)

---

[API](https://skmtc.dev/alphakek-ai/apis/aikek-api.md) - [All operations](https://skmtc.dev/alphakek-ai/apis/aikek-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alphakek-ai/apis/aikek-api/revisions/b6d96e7673dc?raw)
