market-data

用途：为智能体提供加密代币行情数据，包括实时价格、热门资产发现和按分类的排行榜。

主要能力：

1. 获取代币价格（指数）：POST /v2/market/tickers，返回一个或多个代币的美元价格，价格由 CoinMarketCap 与 CoinGecko 聚合为指数价。请求体需 currency（如 USD）和 assets（资产 ID 数组，最多 50 个）。响应含 price、change_24h、market_cap、volume_24h、total_supply。
2. 获取热门/分类资产列表：GET /v1/assets/listings，返回带丰富市场数据的代币列表，含多时间框架涨跌幅（1h、24h、7d、30d、60d、90d）、市值、成交量和供应量。查询参数含 version（用 27）、currency、category_id、sort（price24h、mcap、volume）、limit（默认 20，最大 100）、networks、cursor、use_pagination。响应 docs[] 每项含 asset、market、price 三个子对象，并返回 total 与 cursor 用于分页。
3. 列出分类：GET /v1/assets/listing-categories，获取当前可用分类列表，分类是动态的。

分类示例：trending、ai、memes、rwa-assets、x402、layer_1、dex、defi-2、eth-ecosystem、bnb-ecosystem、solana-ecosystem、binance-launchpad、binance-launchpool、binance-megadrop、pump-fun、bonk。

使用方式：基础 URL 为 https://tws.trustwallet.com，认证采用 HMAC-SHA256（详见 setup）。示例请求：GET /v1/assets/listings?version=27&currency=USD&category_id=ai&sort=mcap&limit=20。分页时把响应中的 cursor 传入下一次请求的 cursor 参数。

适用场景：需要代币实时价格、热门币种发现、按赛道或生态筛选资产、构建行情看板或交易辅助的智能体。

限制：价格仅为聚合指数价，非交易所直接报价；assets 数组最多 50 个；limit 最大 100；分类动态变化，需通过分类接口获取最新列表；需 HMAC-SHA256 认证。资料未提供 setup 认证细节、错误码、速率限制和收费信息。