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

# SVM Token Information

> Fetch token metadata, Token-2022 extensions, liquidity, and market data for Solana tokens.

Look up on-chain token metadata and a fuller market report for Solana tokens.

## Get Token Metadata

Returns name, symbol, decimals, total supply, and Token-2022 extension data when present.

**Endpoint:** `/svm/token/meta`

| Parameter | Type | Required | Description |
| - | - | - | - |
| `chain` | string | Yes | Always `sol` |
| `token` | string | Yes | Token mint address |

**Example:**

> [tab] Socket.IO
>
> ```typescript theme={null}
> socket.emit("/svm/token/meta", {
>   chain: "sol",
>   token: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", // BONK
> });
> ```

> [tab] HTTP
>
> ```typescript theme={null}
> await fetch("https://api.chainworks.co/svm/token/meta", {
>   method: "POST",
>   headers: {
>     "Content-Type": "application/json",
>     Authorization: CHAINWORKS_API_AUTH_TOKEN,
>   },
>   body: JSON.stringify({
>     chain: "sol",
>     token: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", // BONK
>   }),
> });
> ```

**Response:**

```json theme={null}
{
  "success": true,
  "result": {
    "chain": "sol",
    "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "name": "Bonk",
    "symbol": "Bonk",
    "decimals": 5,
    "totalSupply": "88416809930247420",
    "slot": 318472901,
    "tokenType": "Token"
  }
}
```

| Field | Type | Description |
| - | - | - |
| `chain` | string | Always `sol` |
| `token` | string | Token mint address |
| `name` | string | Token name. Empty string if no metadata is found |
| `symbol` | string | Token ticker symbol. Empty string if no metadata is found |
| `decimals` | number | Token decimals |
| `totalSupply` | string | Total supply in raw units (decimals not applied) |
| `slot` | number | Slot the metadata was read at |
| `tokenType` | string | `Token` (SPL Token) or `Token2022` (Token-2022 program) |
| `transferFee` | object | Token-2022 transfer fee extension. Present only on `Token2022` mints that enable it. See below |
| `transferHook` | object | Token-2022 transfer hook extension. Present only on `Token2022` mints that enable it. See below |

### Token-2022 `transferFee`

Present only when `tokenType` is `Token2022` and the mint has the transfer fee extension enabled. The object reports the currently effective fee schedule.

```json theme={null}
{
  "transferFee": {
    "feeBps": 100,
    "maximumFee": "5000000000"
  }
}
```

| Field | Type | Description |
| - | - | - |
| `feeBps` | number | Transfer fee in basis points (100 = 1%, max 10000 = 100%) |
| `maximumFee` | string | Maximum fee per transfer in raw token units (decimals not applied) |

### Token-2022 `transferHook`

Present only when `tokenType` is `Token2022` and the mint has an active transfer hook.

```json theme={null}
{
  "transferHook": {
    "authority": "HookAuthorityPublicKey",
    "programId": "HookProgramPublicKey",
    "extraAccountMetas": [
      {
        "pubkey": "ExtraAccountPublicKey",
        "isSigner": false,
        "isWritable": true
      }
    ]
  }
}
```

| Field | Type | Description |
| - | - | - |
| `authority` | string | Authority allowed to update the hook program |
| `programId` | string | Transfer hook program address |
| `extraAccountMetas` | object\[] | Extra accounts the hook program requires on a transfer. May be absent |
| `extraAccountMetas[].pubkey` | string | Account address |
| `extraAccountMetas[].isSigner` | boolean | Whether the account signs |
| `extraAccountMetas[].isWritable` | boolean | Whether the account is writable |

The request is rejected with `NOT_A_TOKEN` if the address is not found on chain or is not a valid token mint.

***

## Get Token Report

Returns the token metadata plus market data and the token's liquidity pools.

**Endpoint:** `/svm/token/report`

| Parameter | Type | Required | Description |
| - | - | - | - |
| `chain` | string | Yes | Always `sol` |
| `token` | string | Yes | Token mint address |

**Example:**

> [tab] Socket.IO
>
> ```typescript theme={null}
> socket.emit("/svm/token/report", {
>   chain: "sol",
>   token: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", // BONK
> });
> ```

> [tab] HTTP
>
> ```typescript theme={null}
> await fetch("https://api.chainworks.co/svm/token/report", {
>   method: "POST",
>   headers: {
>     "Content-Type": "application/json",
>     Authorization: CHAINWORKS_API_AUTH_TOKEN,
>   },
>   body: JSON.stringify({
>     chain: "sol",
>     token: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263", // BONK
>   }),
> });
> ```

**Response:**

```json theme={null}
{
  "success": true,
  "result": {
    "chain": "sol",
    "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
    "name": "Bonk",
    "symbol": "Bonk",
    "decimals": 5,
    "totalSupply": "88416809930247420",
    "slot": 318472901,
    "tokenType": "Token",
    "marketCapUSD": 1284000000,
    "priceUSD": 0.00001452,
    "liquidity": {
      "deepestPool": {
        "type": "RaydiumV4",
        "lp": "8Qs4S2D7uQ4D9onb5N4hM9YtPGFCgvqB5jHPNSjxFM9k",
        "token": "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "backingToken": "So11111111111111111111111111111111111111112",
        "rawPrice": 0.00000156,
        "tokenReserve": "412000000000000",
        "backingReserve": "642720000000",
        "isTokenBase": true
      },
      "otherPools": []
    }
  }
}
```

The report carries every [Get Token Metadata](#get-token-metadata) field (including `transferFee` and `transferHook` on Token-2022 mints), plus:

| Field | Type | Description |
| - | - | - |
| `marketCapUSD` | number \| null | Estimated market cap in USD. `null` when no priced pool is available |
| `priceUSD` | number \| null | Estimated price per token in USD. `null` when no priced pool is available |
| `liquidity` | object \| null | Liquidity pools for the token. `null` when no pools are found |
| `liquidity.deepestPool` | object | The pool with the most liquidity. See pool fields below |
| `liquidity.otherPools` | object\[] | Remaining pools, deepest first. May be empty |

### Pool object

Each pool in `deepestPool` and `otherPools` has these base fields:

| Field | Type | Description |
| - | - | - |
| `type` | string | DEX type. One of the [supported DEXes](https://docs.chainworks.org/svm/overview.md) (`RaydiumV4`, `RaydiumCLMM`, `RaydiumCPMM`, `RaydiumLaunchLab`, `PumpFun`, `PumpSwap`, `MeteoraDLMM`, `MeteoraDYN`, `MeteoraDYN2`, `MeteoraDBC`, `Whirlpool`, `MetaplexGenesis`, `Humi`, `FluxBeam`) |
| `lp` | string | Pool (liquidity pair) address |
| `token` | string | The token mint this report is for |
| `backingToken` | string | The paired backing token mint (for example wrapped SOL) |
| `rawPrice` | number | Price of the token in raw backing-token units (decimals not applied) |
| `tokenReserve` | string | Token reserve held by the pool, in raw units |
| `backingReserve` | string | Backing-token reserve held by the pool, in raw units |
| `isTokenBase` | boolean | Whether the token is the base side of the pair |

Bonding-curve pools carry extra fields:

| Field | Type | Description |
| - | - | - |
| `bondingProgress` | number | Bonding curve progress. Present on `PumpFun`, `MetaplexGenesis`, `MeteoraDBC`, and `RaydiumLaunchLab` pools |
| `completedBonding` | boolean | Whether the curve has completed bonding. Present on the same pool types as `bondingProgress` |
| `configAddress` | string | Launchpad config address. Present on `MeteoraDBC` and `RaydiumLaunchLab` pools only |

The request is rejected with `NOT_A_TOKEN` if the address is not found on chain or is not a valid token mint. When the token exists but liquidity or pricing cannot be resolved, the failure response may include a `partialResult` carrying the fields that were available.


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