> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inkyswap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Token

> Read one token's indexed identity, launch context, lifecycle, liquidity, and metrics.

## Query parameters

<ParamField query="chainId" type="number" required>
  `57073` for Ink or `4663` for Robinhood.
</ParamField>

<ParamField query="address" type="string" required>
  Token contract address.
</ParamField>

## Request

```bash theme={null}
curl "https://inkypump.com/api/token?chainId=57073&address=0x5fc71b21bd8c7e76fa7514d9fec1f91898a86c7f"
```

## Response

The success body is the token object itself, not `{ "token": ... }`.

Fields used for safe routing include:

| Field | Type | Meaning |
| - | - | - |
| `chain_id` | number | Token chain |
| `address` | string | Token address |
| `owner` | string | Indexed creator |
| `launchpad_version` | string | `v1` or `v2` |
| `hook_address` | string or null | Hook that owns this V2 launch |
| `launch_id` | string, number, or null | On-chain launch ID |
| `denomination_kind` | string or null | Native or xStocks quote family |
| `is_finalized` | boolean or null | Whether the curve has bonded |
| `lifecycle_state` | string or null | Indexed execution lifecycle |
| `chain_canonical` | boolean or null | Whether the source event remains canonical |
| `finality_status` | string or null | Current indexer finality |
| `transaction_hash` | string or null | Creation transaction |

The object can also include identity, social links, curve state, pool identity, price, volume, liquidity, holder data, and xStocks valuation evidence. Fields may be added. Keep unknown fields and nullable values safe.

<Warning>
  Do not infer zero from `null`. Do not replace `hook_address` with the active creation hook. An older token must remain on the deployment that created it.
</Warning>

## Errors

| Status | Response |
| -: | - |
| `400` | Missing/invalid address or unsupported chain |
| `404` | `{ "error": "Token not found", "otherChain": ... }` |
| `429` | Rate limited |
| `500` | Failed indexed lookup |

A `404` just after your own confirmed `LaunchCreated` receipt can mean the indexer has not published the record yet. Retry the read; do not resubmit the launch.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.