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

# Listar contratos de token

> Tus contratos de token TRC-20 para Bandwidth automático

## Listar contratos de token

Devuelve los contratos TRC-20 que has añadido para Bandwidth automático. Una suscripción con `token: "CUSTOM"` u `"OWN"` puede usar cualquiera de ellos en `contract`. Requiere el alcance `view`.

USDT y USDD están integrados y nunca aparecen aquí: elígelos con `token`.

### Respuesta

**contracts** `array`

Tus contratos.

**objeto de contrato**

**address** `string`

Dirección del contrato

**symbol** `string`

Símbolo del token, tal como lo informa el contrato (hasta 16 caracteres)

**name** `string | null`

Nombre del token, tal como lo informa el contrato (hasta 40 caracteres); `null` si no tiene

**decimals** `number`

Decimales del token

**bandwidth** `number`

Ancho de banda que consume una transferencia de este token — una guía para el `volume` de la suscripción

> [!WARNING]
>
> `symbol` y `name` provienen del propio contrato, y cualquiera puede desplegar un token que se llame a sí mismo "Tether USD". Identifica siempre un token por su `address`.

### Ejemplo

```bash cURL theme={null}
curl https://api.tronrental.com/v1/bandwidth/auto/contracts \
  -H "X-API-Key: your_api_key"
```

```python Python theme={null}
import requests

resp = requests.get(
    "https://api.tronrental.com/v1/bandwidth/auto/contracts",
    headers={"X-API-Key": "your_api_key"},
)
print(resp.json())
```

```javascript JavaScript theme={null}
const resp = await fetch("https://api.tronrental.com/v1/bandwidth/auto/contracts", {
  headers: { "X-API-Key": "your_api_key" },
});
console.log(await resp.json());
```

```json Response theme={null}
{
  "contracts": [
    {
      "address": "TYourTokenContract1234567890abcdef",
      "symbol": "MTK",
      "name": "My Token",
      "decimals": 6,
      "bandwidth": 345
    }
  ]
}
```

### Errores

| Estado | Código | Cuándo |
| - | - | - |
| `403` | `FORBIDDEN` | La clave API carece del alcance `view` |


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