Get asset
get_assetUse when investigating what people said about a particular asset over a chosen period. For many selected coins prefer get_assets when advertised. Through OpenAI programmatic tools await at most two independent calls together; retain complete results and emit requested summaries/decisive evidence rather than printing all raw payloads. Returns its identity, posts, whole-window activity counts and engagement_summary together. The first-page summary measures all matching posts and returns exact totals, leading author rankings by summed counters and highest single-post views; use it instead of scanning every post for a numeric ranking. Choose projection=market for claims: it returns full retained text plus publication-time estimates and separate ingestion captures in this same request. Reuse the returned series_id with get_market_history for subsequent prices. This result is not a current quote or candle curve.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Explore retains up to 500 matches. Exhaustive retains every match for an accepted scope up to 5000; larger scopes fail explicitly so you can partition dates. Continuations last 30 minutes. | explore |
| text | No | ||
| limit | No | Page size: an integer from 1 to 50, default 20. Read additional pages with the returned cursor and unchanged query/page size. | |
| order | No | time_balanced interleaves seven equal parts of the requested period before the retention limit; useful for broad discussion research, not statistical sampling. | newest |
| cursor | No | Pass the returned next_cursor unchanged to the same tool and connection with the original query arguments. For post searches preserve exact UTC dates, filters, order, limit, projection and mode. Omit cursor to start a new or changed query. | |
| detail | No | Compact reading evidence by default. Choose market to include full stored capture and publication-price provenance for every post. | compact |
| date_to | Yes | Exclusive UTC end; required. | |
| asset_id | Yes | ||
| asset_ids | No | Canonical asset IDs from resolve_assets, not tickers or provider IDs. | |
| chain_ids | No | Coin chain IDs, e.g. solana, ethereum, base, robinhood. Includes confirmed stored V1, native and multichain associations; candidates, expired and unknown associations are excluded. Posts qualify through their attached coins. | |
| date_from | Yes | Inclusive UTC start; required. Maximum window 366 days. | |
| has_media | No | ||
| asset_type | No | Known asset relationship. With chain_ids, type must match on one of those chains; native and token relationships may coexist across chains. Unknown has no classified relationship. | |
| author_ids | No | Canonical author IDs from search_authors, not X handles or user IDs. | |
| multichain | No | True selects assets with at least two known chains. False means fewer than two KNOWN chains, not proven single-chain. | |
| post_types | No | ||
| projection | No | index omits text; preview returns short text; reading returns full retained text and relations without prices; market includes price evidence. | |
| evidence_class | No | Filter standalone collected evidence versus retained embedded quote evidence; omitted includes both. | |
| exclude_post_types | No | Exclude selected types; excluding original also excludes historical unknown labels, while excluding repost keeps ordinary unknown labels. |