---
title: "Search Assets"
method: POST
path: "/v0/platform/assets/search"
tags: ["Asset Management"]
---

# Search Assets

`POST /v0/platform/assets/search`

Search and filter platform assets (addresses/domains) using structured filters, pagination, and sorting.

## Request body

- object
  - `filter` object — A set of fields used to filter asset search results.
    - `identifier_type` string[] — Return only results matching the specified asset identifier type (blockchain address or domain).
    - `chain` union — A filter object that supports common query operators.
      - object — Filter by exact value match.
        - `eq` string, required — Return only results where the field equals this value.
      - object — Filter by matching any value in a list.
        - `in` string[], required — Return only results where the field matches any value in this list.
      - object — Filter by requiring all listed values to be present.
        - `contains_all` string[], required — Return only results where the field contains all values in this list.
      - object — Filter by substring match.
        - `contains` string, required — Return results where the field contains the given value (substring match).
    - `tags` union — A filter object that supports common query operators.
      - object — Filter by exact value match.
        - `eq` string, required — Return only results where the field equals this value.
      - object — Filter by matching any value in a list.
        - `in` string[], required — Return only results where the field matches any value in this list.
      - object — Filter by requiring all listed values to be present.
        - `contains_all` string[], required — Return only results where the field contains all values in this list.
      - object — Filter by substring match.
        - `contains` string, required — Return results where the field contains the given value (substring match).
    - `name` union — A filter object that supports common query operators.
      - object — Filter by exact value match.
        - `eq` string, required — Return only results where the field equals this value.
      - object — Filter by matching any value in a list.
        - `in` string[], required — Return only results where the field matches any value in this list.
      - object — Filter by requiring all listed values to be present.
        - `contains_all` string[], required — Return only results where the field contains all values in this list.
      - object — Filter by substring match.
        - `contains` string, required — Return results where the field contains the given value (substring match).
  - `page_size` integer — Determine how many results are returned per page.
  - `page` integer — Return only results for the specified page number.
  - `sort` object[], required — Sort results based on the specified rules.
    - `field` 'identifier' | 'created_at', required — Which field to sort results by.
    - `operator` 'asc' | 'desc', required — Sort order: ascending or descending.

## Response `200`

- object — Successful response containing paginated search results.
  - `total` integer, required — Total number of results matching the request.
  - `page` integer, required — Current page number returned. This is relevant only if a specific page number was mentioned in the request.
  - `pages` integer, required — Total number of pages available.
  - `size` integer, required — Number of items returned in the current response.
  - `items` union[], required — List of assets returned in the response.
    - union
      - AddressResponse
        - `identifier_type` 'address', required — The asset type.
        - `identifier` string, required — The contract or wallet address for this asset.
        - `asset_id` string, required
        - `alias` string — The alias of the asset.
        - `tags` string[], required — Tags assigned to this asset.
        - `added_by` string, required — The user who added the asset.
        - `created_at` string, date-time, required — The date and time the asset was created.
        - `address_details` BaseAddressDetails, required
          - `chain` string, required — The chain of the asset.
          - `runtime` 'evm' | 'sui' | 'solana' | 'stellar' | 'hedera' | 'bitcoin' | 'hyperliquid' | 'polymarket' | 'aster' | 'lighter' | 'tron', required — The runtime name
          - `properties` string[], required — The properties list of the asset.
          - `address` string, required — The address of the asset.
      - DomainResponse
        - `identifier_type` 'domain', required — The asset type.
        - `identifier` string, required — The domain name for this asset.
        - `asset_id` string, required
        - `alias` string — The alias of the asset.
        - `tags` string[], required — Tags assigned to the asset.
        - `added_by` string, required — The user who added the asset.
        - `created_at` string, date-time, required — The date and time the asset was created.

---

[API](https://skmtc.net/blockaid-official/apis/blockaid-api.md) · [All operations](https://skmtc.net/blockaid-official/apis/blockaid-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blockaid-official/blockaid-api/revisions/17c41f337b2e/schema)