Query: tokensBySimilarAddress

Search for tokens by partial or full contract address substring. This performs a case-insensitive match on the token’s address field and returns a paginated result.

Example Query

query TokensBySimilarAddress($address: String!, $limit: Int, $offset: Int, $sortBy: String, $sortOrder: String) {
  tokensBySimilarAddress(address: $address, limit: $limit, offset: $offset, sortBy: $sortBy, sortOrder: $sortOrder) {
    tokens {
      asset_id
      symbol
      chain
      address
      last_updated
    }
    total_count
  }
}

Arguments

Argument	Type	Description
address	String!	Substring to match against token addresses (case-insensitive)
limit	Int	(Default: 10) Maximum number of tokens to return
offset	Int	(Default: 0) Number of records to skip (for pagination)
sortBy	String	(Default: "Symbol") Field to sort by (e.g., symbol, chain, etc.)
sortOrder	String	(Default: "ASC") Sorting order, either ASC (ascending) or DESC

Returns

Returns a TokenPagination object:

TokenPagination

Field	Type	Description
tokens	[Token!]	List of tokens matching the search
total_count	Int	Total number of matches (before paging)

Token Object

Field	Type	Description
asset_id	ID!	Unique internal identifier for the token
symbol	String!	Token symbol (e.g., USDC, ETH)
chain	String!	Blockchain network name (e.g., ETHEREUM, POLYGON)
address	String!	Smart contract address of the token
last_updated	String!	ISO 8601 timestamp of the last metadata update