ARGUS 情报技能

免费链上情报与风险扫描器。

快速开始

bash
export ARGUS_ENDPOINT=https://argus.getfailsafe.com

使用免费套餐进行测试（每天35次查询，查询间隔1分钟）

curl -X POST $ARGUS_ENDPOINT/api/v1/free/query \ -H Content-Type: application/json \ -d {query: 这个地址是否安全：0x742d35Cc..., agentId: my-agent}

免费配额按每个 agentId 进行追踪。检查剩余配额：
bash
curl $ARGUS_ENDPOINT/api/v1/free/status?agentId=my-agent

服务

免费套餐（无需付费）

端点	描述
POST /api/v1/free/query	每个 agentId 每天35次情报查询（间隔1分钟）
GET /api/v1/free/status?agentId=X

检查剩余免费查询次数 | | GET /api/v1/threats | 公共威胁信息流 | | GET /api/v1/security/patterns | 攻击模式文档 |

情报服务（0.03 USDC）

端点	描述
POST /api/v1/token/analyze	代币风险评分与市场数据
POST /api/v1/address/risk

AML/KYT 合规筛查 | | POST /api/v1/compliance/check | OFAC 制裁与黑名单检查 | | POST /api/v1/smart-money/track | 鲸鱼与机构追踪 | | POST /api/v1/entity/investigate | 实体取证分析 | | GET /api/v1/market/scan | 市场概览 |

提示安全（0.03 USDC）

端点	描述
POST /api/v1/security/prompt-check	检测提示注入攻击
POST /api/v1/security/prompt-check/batch

批量检查（10条以上享9折优惠） |

社交验证（0.03 USDC）

端点	描述
POST /api/v1/social/verify	用户名/项目合法性 + 威胁行为者检查

注意：验证使用模式分析和已知威胁行为者数据库。
响应中包含 datasource: patternanalysis_only 以确保透明度。

Webhooks（每月0.03美元）

端点	描述
POST /api/v1/webhooks/register	订阅实时事件告警
GET /api/v1/webhooks

列出活跃的 webhooks | | DELETE /api/v1/webhooks/:id | 删除 webhook |

有效的 webhook 事件：
addressactivity、tokenriskchange、threatdetected、compliance_flag、
whalemovement、liquiditychange、watchlist_alert

Webhook 密钥仅在注册时返回一次——请立即保存。
连续5次投递失败后，webhook 将被禁用。

使用示例

代币分析

bash
curl -X POST $ARGUS_ENDPOINT/api/v1/token/analyze \
-H Content-Type: application/json \
-d {token: ETH, chain: ethereum}

地址风险

bash
curl -X POST $ARGUS_ENDPOINT/api/v1/address/risk \
-H Content-Type: application/json \
-d {address: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e}

提示安全

bash
curl -X POST $ARGUS_ENDPOINT/api/v1/security/prompt-check \
-H Content-Type: application/json \
-d {prompt: 需要验证的用户输入, context: defi}

响应：

json
{
is_safe: false,
risk_score: 75,
risk_level: suspicious,
recommendation: REVIEW,
attacktypes: [promptinjection],
details: 检测到社会工程模式
}

当 attacktypes 不为空时，无论 riskscore 如何，is_safe 均为 false。
检测到任何攻击时，recommendation 至少为 REVIEW。

社交验证

bash
curl -X POST $ARGUS_ENDPOINT/api/v1/social/verify \
-H Content-Type: application/json \
-d {username: suspicious_user, platform: twitter}

响应：

json
{
verified: false,
risk_level: high,
flags: [knownthreatactor],
datasource: patternanalysis_only,
analysis_note: 用户名与已知威胁行为者数据库匹配
}

注册 Webhook

bash
curl -X POST $ARGUS_ENDPOINT/api/v1/webhooks/register \
-H Content-Type: application/json \
-d {
url: https://your-agent.com/argus-events,
agentId: my-agent,
events: [threatdetected, addressactivity]
}

A2A（代理间通信）

ARGUS 支持 A2A 协议。可直接使用自然语言进行查询：

bash

发现能力

curl https://argus.getfailsafe.com/.well-known/agent.json

发送 A2A 消息（区块链查询将自动路由）

curl -X POST $ARGUS_ENDPOINT/message \ -H Content-Type: application/json \ -d { type: inquiry, content: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e 是否安全？, agentId: my-agent }

免费套餐配额适用于 A2A 区块链查询。响应中包含带有升级选项的水印。

支付方式

方式一 — Stripe（最简单，无需加密货币）

1. 1. 在 https://buy.stripe.com/4gM28r6zseQlbJp72d4F202 以9美元购买20个积分
2. 每次请求时传递 X-Stripe-Token: 标头

bash
curl -X POST $ARGUS_ENDPOINT/api/v1/token/analyze \
-H Content-Type: application/json \
-H X-Stripe-Token: skargusxxxx \
-d {token: 0xabc..., chain: ethereum}

方式二 — x402（Base 链上的 USDC）

对于付费端点，ARGUS 返回 402 Payment Required 并附带支付说明。

1. 1. 在 Base 网络上向金库发送 USDC
2. 创建支付证明：base64({txHash:0x...,paymentId:...,from:0x...})
3. 使用 X-Payment-Proof 标头重试

金库地址（Base）： 0x8518E91eBcb6bE76f478879720bD9759e01B7954
金库地址（Solana）： Ntx61j81wkQFLT5MGEKvMtazxH4wh6iXUNMtidgxXYH

配置

bash
export ARGUS_ENDPOINT=https://argus.getfailsafe.com

响应格式

所有情报端点均返回 JSON，包含：

• - recommendation：ALLOW、REVIEW、BLOCK 或 REJECT
• riskscore：0–100（数值越低越安全）
• confidence：0–100%
• issafe：布尔值——当 attack_types 不为空时为 false
• 详细分析字段

速率限制

• - 每个 IP 每分钟30次请求
• 免费套餐：每个 agentId 每天3次查询，查询间隔1分钟

支持

• - 网站：https://getfailsafe.com
• 能力列表：https://argus.getfailsafe.com/api/v1/capabilities