API Tokens — Documentación Tulkit Enterprise

GET/v1/tokens

Listar tokens del sistema

Devuelve todos los tokens registrados en la plataforma, filtrables por red, entorno y estado activo.

Cuándo usarlo

Para poblar selectores de activo en tu producto o para descubrir qué está disponible antes de pedir su habilitación.

Parámetros

networkstring

Filtra por red, por ejemplo BASE.

environmentTESTNET | MAINNET

Filtra por entorno. Debe coincidir con el de tu API key.

is_activestring

Filtra por tokens activos en la plataforma ("true" o "false").

curl

curl "https://vaultcore.dev.tulkitpay.com/v1/tokens?network=BASE&environment=MAINNET" \
  -H "x-api-key: $TULKIT_API_KEY"

Respuesta de ejemplo

200 OK

{
  "tokens": [
    {
      "id": "tok_01HZX89A...",
      "network": "POLYGON",
      "environment": "TESTNET",
      "symbol": "USDT",
      "name": "Tether USD",
      "decimals": 6,
      "contract_address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
      "is_native": false,
      "is_active": true,
      "created_at": "2026-01-15T10:00:00.000Z"
    },
    {
      "id": "tok_01HZX89B...",
      "network": "POLYGON",
      "environment": "TESTNET",
      "symbol": "POL",
      "name": "Polygon Native",
      "decimals": 18,
      "contract_address": null,
      "is_native": true,
      "is_active": true,
      "created_at": "2026-01-15T10:00:00.000Z"
    }
  ]
}

Buenas prácticas

La respuesta viene envuelta en el objeto { "tokens": [...] }, no en un array plano.