Compute Unit Cost
The Collectibles endpoint’s CU cost equals the number of chains you include via thechain_ids query parameter. If you omit chain_ids, we use the endpoint’s chains tagged default (currently chains, subject to change). See the Supported Chains page to learn about chain tags.
For example, ?chain_ids=1,8453,137 processes three chains and currently consumes three CUs. Omitting chain_ids uses the default set at request time and consumes CUs (equal to the size of that set).
Spam Filtering
By default, spam filtering for collectibles is enabled. Usefilter_spam=false to disable it. You can omit the parameter or set filter_spam=true to keep spam filtering enabled.
We provide spam scores to explain how a collectible is classified as spam or not.
Spam scores are off by default. Enable them with show_spam_scores=true.
Scores are computed as a weighted average across signals.
These include whether the collection has been flagged by external providers, trade volume since launch, and the number of unique buyers and sellers.
See the table below for the full list.
Spam Scoring Signals
Spam Scoring Signals
| Feature | Description |
|---|---|
trade_volume | This is the total number of trades since collection launch. Very low activity can indicate spam. Collections launched in the last 7 days are excluded from this signal. |
unique_buyers | This is the count of distinct buyers. Low buyer diversity can indicate inorganic activity. |
unique_sellers | This is the count of distinct sellers. Low seller diversity can indicate inorganic activity. |
externally_flagged | Whether the collection has been flagged as spam by third-party providers. true increases the spam likelihood. |
ipfs_uri_present | This indicates whether token metadata URIs use IPFS. Certain patterns can correlate with spam when combined with other signals. |
suspicious_words | Whether names, symbols, or URIs include suspicious terms commonly associated with scams. |
url_shortener_in_uri | This indicates whether metadata URIs use link shorteners. For example, Bitly links can obscure destinations. |
explanations field and may be omitted if signals are unavailable.Headers
Used for authenticating requests. Provide an API key with a purpose of Sim API. See Authentication.
Path Parameters
The wallet address to get collectibles for.
Query Parameters
Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. ?chain_ids=1 or ?chain_ids=mainnet) or a comma-separated list (e.g. ?chain_ids=1,8543,testnet). Chain names are not accepted. If this query parameter is omitted, results include collectibles from chains with the default tag. See the Supported Chains Tags section.
Pagination cursor. Use the next_offset value from the previous response to get the next page. Omit to fetch the first page.
Maximum entries per page for collectibles. Default is 250 when not provided. Values above 2500 are reduced to 2500. If fewer entries exist than the limit, only the available entries are returned.
1 <= x <= 2500When true, hide collectibles identified as spam. Set to false to return all collectibles, including potential spam. See the Spam Filtering section for more details.
When true, include spam scoring details including contributing signals to explain filtering decisions.
Response
A list of collectibles for the specified address.
The wallet address for which collectibles are being reported.
A list of collectible entries.
Timestamp of when the request was received.
Timestamp of when the response was generated.
Use this value as the offset in your next request to continue pagination. Not included when there are no more entries.