> For the complete documentation index, see [llms.txt](https://docs.tajirchain.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tajirchain.com/etherscan-compatible-explorer-api/token.md).

# Token

The Token module retrieves indexed information about ERC-20, ERC-721 and other supported token contracts.

### Endpoint

```
https://explorer.tajirchain.com/api?module=token
```

### Available Actions

| Action            | Purpose               |
| ----------------- | --------------------- |
| `getToken`        | Get token information |
| `getTokenHolders` | Get token holders     |

### Get Token Information

#### Action

```
getToken
```

#### Parameters

| Parameter         | Required | Description            |
| ----------------- | -------- | ---------------------- |
| `contractaddress` | Yes      | Token contract address |

```bash
curl "https://explorer.tajirchain.com/api?module=token&action=getToken&contractaddress=0xTOKEN_CONTRACT"
```

Example response structure:

```json
{
  "message": "OK",
  "result": {
    "cataloged": true,
    "contractAddress": "0x...",
    "decimals": "18",
    "name": "Token Name",
    "symbol": "TOKEN",
    "totalSupply": "1000000000000000000",
    "type": "ERC-20"
  },
  "status": "1"
}
```

Possible token types include:

* ERC-20
* ERC-721
* ERC-1155
* Other types supported by the Explorer indexer

### Get Token Holders

#### Action

```
getTokenHolders
```

#### Parameters

| Parameter         | Required | Description            |
| ----------------- | -------- | ---------------------- |
| `contractaddress` | Yes      | Token contract address |
| `page`            | No       | Page number            |
| `offset`          | No       | Results per page       |

```bash
curl "https://explorer.tajirchain.com/api?module=token&action=getTokenHolders&contractaddress=0xTOKEN_CONTRACT&page=1&offset=10"
```

Example response:

```json
{
  "message": "OK",
  "result": [
    {
      "address": "0x...",
      "value": "1000000000000000000"
    }
  ],
  "status": "1"
}
```

The `value` field uses the token’s smallest unit. Apply the token’s decimal precision before displaying it.

### Unsupported Action

The following upstream compatibility action is not enabled on the Tajir Chain Explorer:

```
bridgedTokenList
```

Requests using this action currently return `Unknown action`. It should not be used in production integrations.