# ordinals_getTokenByIdOrTicker

Retrieves detailed information about a BSV21 token by its ID (txid_vout format). Returns token data including symbol, supply, decimals, funding status, and current state.

## Result

Token lookup data as JSON text. The current lookup accepts a token ID, not a ticker.

## Permissions

No spending approval is requested by this handler. Public network lookups can still fail or require a compatible service.

## Definition 1 (full)

Registered in: Before wallet setup; Legacy local wallet; Legacy local identity; Local Vault · broadcasting disabled; Local Vault · all roles; Local Vault · payment role only; Project · payments scope; External BRC-100 wallet; Local Vault + sponsor; Droplit wallet.

Retrieves detailed information about a BSV21 token by its ID (txid_vout format). Returns token data including symbol, supply, decimals, funding status, and current state.

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| id | string | Yes | BSV21 token ID in outpoint format (txid_vout) |  |

Nested requirements apply when their parent is supplied.

### Input schema

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "BSV21 token ID in outpoint format (txid_vout)"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

[All tools](https://bsvmcp.com/docs/tools)