---
title: "Search assets"
method: GET
path: "/search"
tags: ["Flash"]
---

# Search assets

`GET /search`

Search tradable assets by symbol, name, or contract address.

Results are ranked by relevance and market quality, most relevant first. The returned `address` and `chain` feed directly into `POST /quote` as `targetAsset`/`contraAsset` and `targetChain`/`contraChain`.

Pass `chain` to restrict results to a single chain.

## Query parameters

- `query` string, required — Symbol, name, or contract address.
- `chain` 'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'hyperevm' | 'plasma' | 'monad' | 'robinhood' — Restrict results to a single chain.
- `limit` integer — Maximum assets to return. Defaults to 10; capped at 25.

## Response `200`

Assets returned successfully

- FlashSearchAssetsResponse
  - `assets` FlashAsset[], required
    - `chain` 'arbitrum' | 'avalanche' | 'base' | 'bsc' | 'ethereum' | 'optimism' | 'polygon' | 'solana' | 'hyperevm' | 'plasma' | 'monad' | 'robinhood', required — Chain of the target (traded) asset. May differ from `contraChain` for a cross-chain market order.
    - `address` string, required — Pass straight back to `POST /quote` as `targetAsset` or `contraAsset`. EVM native assets use the `0xEeee…EEeE` sentinel.
    - `symbol` string, required
    - `name` string, required — Human-readable name. Falls back to `symbol` when Definitive has no distinct name, so it may equal `symbol`.
    - `decimals` integer, required
    - `price` string, required — Price in USD. `"0"` means Definitive has no current price for this asset — treat it as unknown, not as zero.
    - `marketCap` string, required — Circulating market cap in USD. `"0"` may mean unknown, as with `price`.
    - `liquidity` string, required — Liquidity in USD. `"0"` may mean unknown, as with `price`.
    - `volume24h` string, required — 24h trading volume in USD. `"0"` may mean unknown, as with `price`.
    - `priceChange24h` string, required — 24h price change as a decimal fraction — `-0.0342` is -3.42%. Multiply by 100 to display.
    - `holders` integer, required — Distinct holding addresses.
    - `imageUrl` string, required
    - `riskFlagged` boolean, required — Set when the asset shows common risk indicators — very low liquidity, supply concentrated in the deployer or a small group of wallets, or a contract that can mint or freeze tokens. Treat this as a caution signal, not a safety guarantee.

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication failed
- `403` — Permission denied
- `404` — Resource not found
- `422` — Resource state prevents the requested operation
- `429` — Rate limit exceeded
- `500` — Internal server error
- `503` — Service temporarily unavailable
- `504` — Gateway timeout

## Changes

> 10 revisions in range; 7 could not be searched.

- **2026-07-31** `e7536bd95e54` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/definitive/apis/definitive-flash-api/changes/search/get.md)

---

[API](https://skmtc.dev/definitive/apis/definitive-flash-api.md) · [All operations](https://skmtc.dev/definitive/apis/definitive-flash-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definitive/definitive-flash-api/revisions/a3fee79d0a4d/schema)