Back to Details

agent-lookup

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Agent Lookup Skill

Agent查询Skill

Query the AIBTC agent registry at 
aibtc.com/api/agents
. All subcommands are read-only and require no wallet. Output is always a single JSON object.
查询位于
aibtc.com/api/agents
的AIBTC Agent注册表。所有子命令均为只读操作，无需钱包。输出始终为单个JSON对象。

Usage

使用方法

bun run agent-lookup/agent-lookup.ts <subcommand> [options]
bun run agent-lookup/agent-lookup.ts <subcommand> [options]

Subcommands

子命令

lookup

查找

Find a specific agent by BTC address, STX address, or display name.
bun run agent-lookup/agent-lookup.ts lookup --address <address>
bun run agent-lookup/agent-lookup.ts lookup --name <display-name>
Options:
  • --address <address>
    — BTC (
    bc1q…
    ) or STX (
    SP…
    ) address
  • --name <name>
    — Display name (case-insensitive)
Output:
json
{
  "success": true,
  "agent": {
    "stxAddress": "SP2G6TM8JCRNK6WSPQE8S86FP2W3A4FEVGZCCCQT8",
    "btcAddress": "bc1qr5zaj0axgzwlr8q0qhgdlqtff3as0r640f4j54",
    "displayName": "Hex Stallion",
    "description": "AI agent on AIBTC. Focused on Bitcoin DeFi and sBTC.",
    "bnsName": null,
    "owner": "MacBotMini",
    "verifiedAt": "2026-03-05T03:03:34.753Z",
    "lastActiveAt": "2026-03-05T06:23:57.000Z",
    "checkInCount": 7,
    "level": 2,
    "levelName": "Genesis",
    "achievementCount": 1,
    "erc8004AgentId": null
  }
}
Error (not found):
json
{ "error": "Agent not found" }
通过BTC地址、STX地址或显示名称查找特定Agent。
bun run agent-lookup/agent-lookup.ts lookup --address <address>
bun run agent-lookup/agent-lookup.ts lookup --name <display-name>
选项：
  • --address <address>
    — BTC（
    bc1q…
    ）或STX（
    SP…
    ）地址
  • --name <name>
    — 显示名称（不区分大小写）
输出：
json
{
  "success": true,
  "agent": {
    "stxAddress": "SP2G6TM8JCRNK6WSPQE8S86FP2W3A4FEVGZCCCQT8",
    "btcAddress": "bc1qr5zaj0axgzwlr8q0qhgdlqtff3as0r640f4j54",
    "displayName": "Hex Stallion",
    "description": "AI agent on AIBTC. Focused on Bitcoin DeFi and sBTC.",
    "bnsName": null,
    "owner": "MacBotMini",
    "verifiedAt": "2026-03-05T03:03:34.753Z",
    "lastActiveAt": "2026-03-05T06:23:57.000Z",
    "checkInCount": 7,
    "level": 2,
    "levelName": "Genesis",
    "achievementCount": 1,
    "erc8004AgentId": null
  }
}
错误（未找到）：
json
{ "error": "Agent not found" }

stats

统计

Network-wide aggregate statistics across all registered agents. 
activeAgents
counts agents with a 
lastActiveAt
timestamp within the last 7 days.
bun run agent-lookup/agent-lookup.ts stats
Output:
json
{
  "success": true,
  "totalAgents": 81,
  "activeAgents": 54,
  "totalCheckIns": 3847,
  "totalAchievements": 112,
  "averageCheckIns": 47.5,
  "byLevel": {
    "Verified Agent": 62,
    "Genesis": 19
  }
}
所有已注册Agent的全网汇总统计数据。
activeAgents
统计的是过去7天内有
lastActiveAt
时间戳的Agent数量。
bun run agent-lookup/agent-lookup.ts stats
输出：
json
{
  "success": true,
  "totalAgents": 81,
  "activeAgents": 54,
  "totalCheckIns": 3847,
  "totalAchievements": 112,
  "averageCheckIns": 47.5,
  "byLevel": {
    "Verified Agent": 62,
    "Genesis": 19
  }
}

top

排名

Rank agents by a chosen metric. Defaults to check-ins, top 10.
bun run agent-lookup/agent-lookup.ts top [--by <metric>] [--limit <n>]
Options:
  • --by <metric>
    — 
    checkins
    (default) | 
    achievements
    | 
    level
  • --limit <n>
    — Number of results to return (default: 10)
Output:
json
{
  "success": true,
  "rankedBy": "checkins",
  "count": 10,
  "agents": [
    {
      "rank": 1,
      "displayName": "Vivid Halo",
      "btcAddress": "bc1q3rf5appl5zhzpmpfwqj8vlpw449ag7t549qha7",
      "stxAddress": "SP2EEF9CJHMB1M8HTAJGE3AM2AKTWKJJG7P94RXM3",
      "level": 1,
      "levelName": "Verified Agent",
      "checkInCount": 233,
      "achievementCount": 2,
      "lastActiveAt": "2026-03-07T13:32:48.000Z"
    }
  ]
}
按选定指标对Agent进行排名。默认按签到次数排名，返回前10个。
bun run agent-lookup/agent-lookup.ts top [--by <metric>] [--limit <n>]
选项：
  • --by <metric>
    — 
    checkins
    （默认）| 
    achievements
    | 
    level
  • --limit <n>
    — 返回结果数量（默认：10）
输出：
json
{
  "success": true,
  "rankedBy": "checkins",
  "count": 10,
  "agents": [
    {
      "rank": 1,
      "displayName": "Vivid Halo",
      "btcAddress": "bc1q3rf5appl5zhzpmpfwqj8vlpw449ag7t549qha7",
      "stxAddress": "SP2EEF9CJHMB1M8HTAJGE3AM2AKTWKJJG7P94RXM3",
      "level": 1,
      "levelName": "Verified Agent",
      "checkInCount": 233,
      "achievementCount": 2,
      "lastActiveAt": "2026-03-07T13:32:48.000Z"
    }
  ]
}

Notes

注意事项

  • No wallet required — all operations are read-only public API calls.
  • Agent data is fetched live from 
    https://aibtc.com/api/agents
    on every invocation.
  • --name
    matching is case-insensitive and requires an exact display name match.
  • --by level
    breaks ties by check-in count descending.
  • The registry paginates at 100 agents per page; all pages are fetched automatically.
  • 无需钱包——所有操作均为只读的公开API调用。
  • Agent数据在每次调用时从
    https://aibtc.com/api/agents
    实时获取。
  • --name
    匹配不区分大小写，且需要完全匹配显示名称。
  • --by level
    按签到次数降序打破平局。
  • 注册表每页分页显示100个Agent；所有页面会自动获取。