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

# asset.list

> Obtén listas masivas de assets revisados por ChainPatrol, filtradas por tipo, estado de amenaza, rango de fechas y slug de la organización, con el método asset.list.

El método `asset.list` te permite obtener listas masivas de los **assets** (activos digitales: URL, direcciones, perfiles, apps, etc.) que ChainPatrol ya revisó, con potentes opciones de filtrado por tipo, estado y rango de fechas. Este método es ideal para el análisis masivo y la generación de reportes.

## Referencia de la API

### Firma del método

```typescript theme={null}
client.asset.list(request: AssetListInput): Promise<AssetListOutput>
```

### Parámetros

**request** `AssetListInput` *required*

El objeto de solicitud de la lista de assets, con los criterios de filtrado.

**Propiedades de AssetListInput**

**type** `enum\<string\>` *required*

El tipo de assets que quieres obtener.

Tipos compatibles: `URL`, `PAGE`, `ADDRESS`.

**status** `enum\<string\>` *required*

Filtra los assets por su estado de amenaza.

Estados compatibles: `BLOCKED`, `ALLOWED`, `UNKNOWN`.

**startDate** `string` *required*

Fecha de inicio del rango de la consulta, en formato `YYYY-MM-DD`.

**endDate** `string` *required*

Fecha de fin del rango de la consulta, en formato `YYYY-MM-DD`.

Debe ser mayor o igual que `startDate`.

**organizationSlug** `string`

Slug opcional de la organización, para filtrar los assets de una organización específica.

### Valor devuelto

**assets** `array` *required*

Arreglo de objetos de asset que coinciden con los criterios de filtrado.

**Propiedades del objeto Asset**

**type** `enum\<string\>` *required*

El tipo del asset: `URL`, `PAGE` o `ADDRESS`.

**content** `string` *required*

El contenido del asset:

* Para `URL`/`PAGE`: la URL del asset
* Para `ADDRESS`: la dirección de la wallet o del contrato

**status** `enum\<string\>` *required*

El estado de amenaza: `UNKNOWN`, `ALLOWED` o `BLOCKED`.

**updatedAt** `string` *required*

Marca de tiempo ISO de la última actualización del asset.

**reason** `string` *deprecated*

**Obsoleto:** El motivo de la clasificación del estado. Este campo está obsoleto y no debe usarse en implementaciones nuevas.

### Opciones de filtrado

> [card] Por tipo de asset
>
> Filtra por `URL`, `PAGE` o `ADDRESS` para enfocarte en categorías específicas de assets.

&#x20;

> [card] Por estado
>
> Filtra por el estado `BLOCKED`, `ALLOWED` o `UNKNOWN`.

&#x20;

> [card] Por rango de fechas
>
> Especifica las fechas de inicio y de fin para analizar períodos específicos.

> [card] Por organización
>
> Usa `organizationSlug` para obtener resultados específicos de una organización.

## Primeros pasos

### Inicio rápido

```typescript Basic List Query theme={null}
import { ChainPatrolClient } from "@chainpatrol/sdk";

const client = new ChainPatrolClient({
apiKey: "cp_live_your_api_key_here",
});

const result = await client.asset.list({
type: "URL",
status: "BLOCKED",
startDate: "2023-01-01",
endDate: "2023-12-31",
});

console.log(`Found ${result.assets.length} blocked URLs`);

```

```typescript Organization-Specific Query theme={null}
const result = await client.asset.list({
  type: "ADDRESS",
  status: "BLOCKED",
  startDate: "2024-01-01",
  endDate: "2024-01-31",
  organizationSlug: "ethereum-foundation",
});

result.assets.forEach(asset => {
  console.log(`Blocked address: ${asset.content}`);
  console.log(`Updated: ${asset.updatedAt}`);
});
```

```json Example Response theme={null}
{
  "assets": [
    {
      "type": "URL",
      "content": "phishing-site.com",
      "status": "BLOCKED",
      "updatedAt": "2023-06-15T10:30:00.000Z"
    },
    {
      "type": "URL",
      "content": "scam-airdrop.net",
      "status": "BLOCKED",
      "updatedAt": "2023-06-14T15:45:00.000Z"
    }
  ]
}
```

### Patrones de uso básicos

```typescript theme={null}
// Get recent threats
async function getRecentThreats(days: number = 7) {
  const endDate = new Date().toISOString().split("T")[0];
  const startDate = new Date(Date.now() - days * 24 * 60 * 60 * 1000)
    .toISOString()
    .split("T")[0];

  return await client.asset.list({
    type: "URL",
    status: "BLOCKED",
    startDate,
    endDate,
  });
}

// Count assets by status
async function getAssetStats(dateRange: { start: string; end: string }) {
  const [blocked, allowed] = await Promise.all([
    client.asset.list({
      type: "URL",
      status: "BLOCKED",
      startDate: dateRange.start,
      endDate: dateRange.end,
    }),
    client.asset.list({
      type: "URL",
      status: "ALLOWED",
      startDate: dateRange.start,
      endDate: dateRange.end,
    }),
  ]);

  return {
    blocked: blocked.assets.length,
    allowed: allowed.assets.length,
  };
}
```

## Guía de implementación

### Casos de uso y patrones

> [accordion] Reportes de inteligencia de amenazas
>
> Genera reportes periódicos sobre los assets bloqueados para el análisis de seguridad.
>
> ```typescript theme={null}
> async function generateThreatReport(month: string) {
>   const startDate = `${month}-01`;
>   const endDate = `${month}-31`;
>
>   const threats = await client.asset.list({
>     type: "URL",
>     status: "BLOCKED",
>     startDate,
>     endDate,
>   });
>
>   // Group by update date
>   const byDate = threats.assets.reduce((acc, asset) => {
>     const date = asset.updatedAt.split('T')[0];
>     acc[date] = (acc[date] || 0) + 1;
>     return acc;
>   }, {} as Record<string, number>);
>
>   return {
>     total: threats.assets.length,
>     dailyBreakdown: byDate,
>     period: `${startDate} to ${endDate}`,
>   };
> }
> ```

> [accordion] Auditoría de cumplimiento
>
> Exporta los datos de los assets para cumplir con requisitos normativos y de auditoría.
>
> ```typescript theme={null}
> async function exportComplianceData(orgSlug: string, year: string) {
>   const result = await client.asset.list({
>     type: "ADDRESS",
>     status: "BLOCKED",
>     startDate: `${year}-01-01`,
>     endDate: `${year}-12-31`,
>     organizationSlug: orgSlug,
>   });
>
>   return result.assets.map(asset => ({
>     address: asset.content,
>     blockedDate: asset.updatedAt,
>     organization: orgSlug,
>   }));
> }
> ```

> [accordion] Análisis de tendencias
>
> Analiza las tendencias de amenazas a lo largo del tiempo comparando distintos rangos de fechas.
>
> ```typescript theme={null}
> async function analyzeTrends() {
>   const currentMonth = await client.asset.list({
>     type: "URL",
>     status: "BLOCKED",
>     startDate: "2024-02-01",
>     endDate: "2024-02-29",
>   });
>
>   const previousMonth = await client.asset.list({
>     type: "URL", 
>     status: "BLOCKED",
>     startDate: "2024-01-01",
>     endDate: "2024-01-31",
>   });
>
>   const change = currentMonth.assets.length - previousMonth.assets.length;
>   const percentChange = (change / previousMonth.assets.length) * 100;
>
>   return {
>     current: currentMonth.assets.length,
>     previous: previousMonth.assets.length,
>     change,
>     percentChange: Math.round(percentChange * 100) / 100,
>   };
> }
> ```

### Análisis masivo

```typescript theme={null}
async function analyzeThreats(timeRange: { start: string; end: string }) {
  const [blockedUrls, blockedAddresses, allowedUrls] = await Promise.all([
    client.asset.list({
      type: "URL",
      status: "BLOCKED",
      startDate: timeRange.start,
      endDate: timeRange.end,
    }),
    client.asset.list({
      type: "ADDRESS",
      status: "BLOCKED",
      startDate: timeRange.start,
      endDate: timeRange.end,
    }),
    client.asset.list({
      type: "URL",
      status: "ALLOWED",
      startDate: timeRange.start,
      endDate: timeRange.end,
    }),
  ]);

  return {
    blockedUrls: blockedUrls.assets.length,
    blockedAddresses: blockedAddresses.assets.length,
    allowedUrls: allowedUrls.assets.length,
  };
}
```

### Exportación y procesamiento de datos

```typescript theme={null}
async function exportThreats(outputFormat: "csv" | "json" = "json") {
  const threats = await client.asset.list({
    type: "URL",
    status: "BLOCKED",
    startDate: "2024-01-01",
    endDate: "2024-12-31",
  });

  const processedData = threats.assets.map((asset) => ({
    url: asset.content,
    status: asset.status,
    lastUpdated: asset.updatedAt,
  }));

  if (outputFormat === "csv") {
    // Convert to CSV format
    const headers = Object.keys(processedData[0]).join(",");
    const rows = processedData.map((row) => Object.values(row).join(","));
    return [headers, ...rows].join("\n");
  }

  return processedData;
}
```

## Detalles técnicos

### Requisitos de formato

> [!WARNING]
>
> **Requisitos del formato de fecha** - Las fechas deben estar en formato `YYYY-MM-DD` -
> `endDate` debe ser mayor o igual que `startDate` - El rango máximo de fechas
> puede estar limitado según tu plan

### Manejo de errores

```typescript theme={null}
import { ChainPatrolClientError } from "@chainpatrol/sdk";

try {
  const result = await client.asset.list({
    type: "URL",
    status: "BLOCKED",
    startDate: "2024-01-01",
    endDate: "2024-01-31",
  });
} catch (error) {
  if (error instanceof ChainPatrolClientError) {
    console.error("API Error:", error.message);
  } else {
    console.error("Unexpected error:", error);
  }
}
```

### Límites de solicitudes y rendimiento

> [!NOTE]
>
> **Límites de solicitudes** - Solicitudes paginadas: hasta 5 solicitudes por segundo - Los resultados
> se paginan cuando los conjuntos de datos son grandes - Considera guardar en caché los resultados de los datos
> que consultas con frecuencia

> [!WARNING]
>
> **Consejos de rendimiento** - Usa rangos de fechas específicos para limitar el tamaño de la respuesta - Guarda
> los resultados en caché cuando sea posible para reducir las llamadas a la API - Considera la paginación para conjuntos de datos
> muy grandes

## Recursos relacionados

### Métodos relacionados

> [card] [asset.check](https://chainpatrol.com/docs/es/sdk/chainpatrol-client/instance-methods/asset-check.md)
>
> Consulta el estado de amenaza de un asset individual

> [card] [asset.submit](https://chainpatrol.com/docs/es/sdk/chainpatrol-client/instance-methods/asset-submit.md)
>
> Envía assets para la clasificación de amenazas

### Documentación adicional

* [Guía de tipos de asset](https://chainpatrol.com/docs/es/glossary/asset-types/page.md)
* [Gestión de organizaciones](https://chainpatrol.com/docs/general/concepts)
* [Autenticación de la API](https://chainpatrol.com/docs/es/external-api/authentication.md)


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