# Get list of all assets

Returns a paginated list of all blockchain assets with filtering options.

Endpoint: GET /assets
Version: 1.0.0
Security: ApiKeyAuth

## Query parameters:

  - `limit` (integer)
    Maximum number of items to return
    Example: 20

  - `page` (integer)
    Page number for pagination
    Example: 1

  - `sort_by` (string)
    Field to sort results by. Use "-" prefix for descending order
    Enum: "gid", "-gid", "namespace", "-namespace", "reference", "-reference", "status", "-status", "created_at", "-created_at"

  - `chain_gids` (array)
    Filter assets by blockchain chain GIDs
    Example: ["eip155:1","eip155:56","eip155:137"]

  - `namespaces` (array)
    Filter assets by asset namespaces
    Enum: "erc20", "trc20", "bep20", "token", "slip44"

  - `statuses` (array)
    Filter assets by status
    Enum: "active", "unknown", "invalid"

## Response 200 fields (application/json):

  - `items` (array, required)
    Array of asset objects

  - `items.gid` (string, required)
    Asset identifier in CAIP-19 format. Identifies a asset across blockchains.
Format: /:
Examples: - Ethereum ETH: eip155:1/slip44:60 - Ethereum USDT ERC-20: eip155:1/erc20:0xdAC17F958D2ee523a2206206994597C13D831ec7
    Example: "eip155:1/erc20:0xdAC17F958D2ee523a2206206994597C13D831ec7"

  - `items.status` (string, required)
    Current status of the asset
    Enum: "active", "unknown", "invalid"

  - `items.created_at` (string, required)
    Timestamp when the resource was created
    Example: "2024-01-15T10:30:00Z"

  - `items.updated_at` (string, required)
    Timestamp when the resource was last updated
    Example: "2024-01-15T10:30:00Z"

  - `meta` (object, required)

  - `meta.limit` (integer, required)
    Number of items per page
    Example: 20

  - `meta.page` (integer, required)
    Current page number
    Example: 1

  - `meta.total` (integer, required)
    Total number of items available
    Example: 42

  - `meta.total_pages` (integer, required)
    Total number of pages available
    Example: 3

## Response 400 fields (application/problem+json):

  - `type` (string, required)
    A URI reference that identifies the problem type
    Example: "https://docs.vilna.io/apis/problems/invalid-request"

  - `title` (string, required)
    A short, human-readable summary of the problem type
    Example: "Invalid Request"

  - `status` (integer, required)
    The HTTP status code
    Example: 400

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "Validation error"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/errors?id=XXXXXX-xxxxx"

  - `fields` (array)
    List of invalid fields in the request

  - `fields.name` (string, required)
    The name of the invalid field
    Example: "meta"

  - `fields.reason` (string, required)
    Why this field is invalid
    Example: "Exceeded maximum data size — must not exceed 1000 characters"

## Response default fields (application/problem+json):

  - `detail` (string)
    A human-readable explanation specific to this occurrence of the problem
    Example: "An unexpected error occurred while processing your request"

  - `instance` (string)
    A URI reference that identifies the specific occurrence of the problem
    Example: "/errors/1234567890"

  - `status` (integer, required)
    The HTTP status code
    Example: 500

  - `title` (string, required)
    A short, human-readable summary of the problem type
    Example: "Internal Server Error"

  - `type` (string, required)
    A URI reference that identifies the problem type
    Example: "https://api.vilna.io/problems/internal-error"