POST AI agent ready /v1/exchange/search

加密搜索 API - 按名称或符号查找硬币

在加密货币注册表中搜索与您的查询匹配的硬币。返回代币 ID（在其他端点中使用）、全名、股票代码和市值排名。非常适合构建自动完成输入、硬币选择器和搜索驱动的加密用户界面。

Endpoint

curl -X POST https://api.botoi.com/v1/exchange/search \
  -H "Content-Type: application/json" \
  -d '{"query":"ethereum"}'

When to use this API

当用户在硬币搜索字段中键入时，使用去抖输入（150-300 毫秒）查询此端点。显示匹配的硬币及其名称、符号和等级。当用户选择一种货币时，将其 ID 传递到加密货币价格端点以获取实时数据。

建立一个可搜索的加密货币目录。让用户按名称浏览代币，按市值排名进行过滤，然后点击进入显示实时价格、图表和市场数据的详细页面。

当用户从电子表格粘贴硬币名称或符号列表时，使用此端点将每个条目解析为规范的硬币 ID。通过向用户显示消歧选择器来处理不明确的条目（例如，“ETH”同时匹配以太坊和以太坊经典）。

我可以通过股票代码进行搜索吗？

是的。该查询与硬币名称和股票代码相匹配。搜索“btc”将返回比特币，搜索“ethereum”将返回以太坊。

如何使用结果中的硬币 ID？

id 字段（例如“ethereum”）用作加密货币价格端点中的货币参数。在此搜索代币，然后传递其 ID 以获取实时价格数据。

新币会自动添加吗？

硬币注册表定期更新。主要交易所上市的新代币在上市后几天内就会出现。非常新的或微型硬币可能需要更长的时间才会出现。

market_cap_rank 代表什么？

market_cap_rank 是代币按市值排列的全球排名。排名 1 是比特币，排名 2 是以太坊，依此类推。这有助于用户快速评估硬币的相对大小和重要性。

搜索是否区分大小写？

不。搜索不区分大小写。 “Bitcoin”、“bitcoin”和“BITCOIN”都返回相同的结果。

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.