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

# List Security Tokens

> List the ERC-3643 tokens your instance has imported

Returns the ERC-3643 security tokens imported into your instance and still active, newest first. These are the tokens you can open an order book on.

Only tokens whose framework is recorded as ERC-3643 appear. A token imported under another framework is not tradable on this venue, because the settlement path depends on the T-REX delivery role.

Importing a token is a separate step from opening a book on it. This endpoint shows what has been imported; [Create Order Book](/endpoints/external-securities-trading/create-order-book) is what makes one tradable.

## Response Fields

<ResponseField name="data" type="object">
  <Expandable>
    <ResponseField name="tokens" type="array">
      <Expandable>
        <ResponseField name="id" type="string">Import record ID.</ResponseField>
        <ResponseField name="tokenAddress" type="string">Security token contract.</ResponseField>
        <ResponseField name="name" type="string">Token name.</ResponseField>
        <ResponseField name="symbol" type="string">Token symbol.</ResponseField>
        <ResponseField name="decimals" type="integer">Token decimals as reported on chain.</ResponseField>
        <ResponseField name="framework" type="string">`erc3643`.</ResponseField>
        <ResponseField name="assetType" type="string">Issuer-declared asset class, or `null`.</ResponseField>
        <ResponseField name="imageURI" type="string">Token image, or `null`.</ResponseField>
        <ResponseField name="totalSupply" type="string">Supply recorded at import, in base units.</ResponseField>
        <ResponseField name="status" type="string">`active`.</ResponseField>
        <ResponseField name="importedAt" type="string">ISO 8601 timestamp.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  `decimals` here is the token's own decimals. Order quantities are order book units with 6 decimal places, and the book converts between the two. A token with fewer than 6 decimals constrains the quantities it will accept; see [Units and decimals](/endpoints/external-securities-trading/introduction#units-and-decimals).
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.trusset.org/orderbooks/external-securities/api/security-tokens" \
    -H "X-API-Key: trusset_your_key_here"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    'https://api.trusset.org/orderbooks/external-securities/api/security-tokens',
    { headers: { 'X-API-Key': 'trusset_your_key_here' } }
  );
  const { data } = await res.json();
  for (const t of data.tokens) console.log(t.symbol, t.tokenAddress, t.decimals);
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "tokens": [
        {
          "id": "clx_extimp_017",
          "tokenAddress": "0x51f2b9d0e77c4a1b83ce6d4a9271e5f3a0c8b912",
          "name": "Helvetia Growth Fund",
          "symbol": "HELG",
          "decimals": 18,
          "framework": "erc3643",
          "assetType": "FUND",
          "imageURI": "ipfs://bafybeigd...",
          "totalSupply": "1000000000000000000000000",
          "status": "active",
          "importedAt": "2025-05-20T14:12:00.000Z"
        }
      ]
    }
  }
  ```
</ResponseExample>

## Error Codes

| Code                  | HTTP  | Cause                                               |
| --------------------- | ----- | --------------------------------------------------- |
| `SERVICE_NOT_ENABLED` | `403` | The Trading service is not enabled on this instance |