Enhanced Token Filtering & Sorting Options

Firekeeper

The v1/wallets/{address}/tokens endpoint now exposes additional query parameters for fine-grained control over token retrieval:

New Query Parameters:

• metadata (boolean, default: true) - Include/exclude token metadata
• resolveMetadataLinks (boolean, default: true) - Resolve metadata links for richer data
• includeSpam (boolean, default: false) - Include/exclude spam tokens
• includeNative (boolean, default: true) - Include/exclude native tokens (ETH, MATIC, etc.)
• sortBy (enum, default: "usd_value") - Sort by: balance, token_address, token_price, or usd_value
• sortOrder (enum, default: "desc") - Sort order: asc or desc
• includeWithoutPrice (boolean, default: true) - Include/exclude tokens without price data

Breaking Changes:

• None - all new parameters are optional with backward-compatible defaults

Defaults Updated:

• Default sorting changed from balance to usd_value (descending)
• All inclusion filters default to maximum data coverage

Example Usage:

GET /v1/wallets/{address}/tokens?chainId=1&sortBy=usd_value&includeSpam=false&limit=50

Developer Notes:

• Existing API calls continue to work unchanged
• New defaults provide more useful token ordering (by USD value)
• Filters allow customization for specific use cases (e.g., excluding spam, metadata-only requests)