OptionalfiltersOptionalasset?: {Matches wallets holding a positive balance of the token. Results are ranked by that balance, or by relevance when q is set.
Optionalbalance?: { max?: string; min?: string }Optional balance bounds. Set min, max, or both.
Optionalmax?: stringInclusive upper bound, in whole token units. Fractional allowed.
Optionalmin?: stringInclusive lower bound, in whole token units: "100" is 100 USDC, not its smallest unit. Fractional allowed.
Optionalscope?: "verified" | "all""verified" (default) matches staff-verified tokens only. "all" widens to every token with the symbol — unverified balances are self-reported and may be spam.
Optionalsymbol?: stringToken symbol to filter by across networks, case insensitive, e.g. "USDC". Set either symbol or token. Resolves to verified tokens unless scope is "all".
Optionaltoken?: { network: string; tid: string }An exact token identified by its network and tid. Set either token or symbol. If filters.networks is also set, it must include this network. Reserved for future use: token selectors currently return HTTP 400 with details.kind UnsupportedAssetSelector.
Canonical token identifier including its kind prefix, e.g. erc20:
Optionalcustodial?: booleanMatches custodial wallets when true, and wallets that are not custodial when false.
Optionalnetworks?: string[]Matches wallets on any of these networks.
Optionalstatuses?: ("Active" | "Inactive" | "Archived")[]Matches wallets in any of these statuses. Archived wallets are left out unless this list includes Archived.
OptionalstoreIds?: string[]Scope results to wallets controlled by these key stores.
Optionaltags?: { hasAll?: string[]; hasAny?: string[] }Tag filter: set exactly one of hasAny or hasAll. Tags match exactly and are case sensitive.
OptionalhasAll?: string[]Matches wallets carrying every one of these tags.
OptionalhasAny?: string[]Matches wallets carrying at least one of these tags.
OptionalvaultWallets?: "exclude" | "include"'include' (default) keeps vault-controlled wallets. 'exclude' drops them from browse and text-search results, but an exact identifier still resolves: pasting a wallet id, address, transaction hash or vault id returns the wallet even when it belongs to a vault.
OptionalincludeInline each wallet's assets: 'native' returns its native asset only, 'verified' adds its verified tokens. Omit to return none.
OptionallimitMaximum number of wallets to return, up to 500. Defaults to 50.
OptionalmatchingHow widely to match. 'broad' (the default when omitted) matches identifiers and names, and also looks inside names and tolerates typos. 'precise' matches identifiers and names only: an exact id, an exact name, or the start of a name. It skips the fuzzy work, so it is markedly faster on a large org, but it is not a guarantee against the time limit: a search that also carries several filters can still exceed it.
OptionalpaginationOpaque token used to retrieve the next page. Returned as nextPageToken from the previous request.
OptionalqText to search for. A wallet id, address, external id, transaction hash or vault id resolves to its wallets. Any other text matches wallet names: an exact name first, then names starting with the text, then looser matches such as a word inside a name or a typo.
OptionalsortResult order. Omitted, results are ranked by relevance when q is set, by the filtered token balance with an asset filter, and newest first otherwise. assetBalance requires an asset filter, and an asset filter accepts no other sort.
'asc' for ascending, 'desc' for descending.
What to order by: 'name' (the wallet name), 'dateCreated' (when the wallet was created), or 'assetBalance' (the balance of the token in filters.asset, which requires that filter).
Narrows the results. A wallet is returned only if it matches every filter set here.