开发者 · 免费 API

给你的 agent / 系统装上付款前风险检查

同一套我们自己在用的地址风险判断,开放成免费 API:免注册、支持跨域(CORS)、返回可核验证据。直接嵌进你的系统或 AI agent 的结算前流程——付款前先问一句「这个对手方安不安全」。

免注册 · 免费

直接调用,无需 API key(合理使用)。

支持跨域 CORS

浏览器 / agent / 服务端都能直接请求。

给证据,不只给分

命中哪个名单、链上路径,都能点开核验。

GET/api/risk

单地址查询

付款前查一个收款地址:是否命中制裁 / 混币器 / 我方风险名单,或链上高危信号?返回判定 + 可核验证据。

参数

addr 必填 — 要查的地址:0x 以太坊系 / T 波场 TRON / Solana base58
network 可选 — 0x 地址所在 EVM 链:ethereum(默认)/ base / bsc / polygon / arbitrum / optimism / avalanche

示例

curl "https://oceanalt.com/api/risk?addr=0x8589427373D6D84E98730D7795D8f6f8731FDA16&network=ethereum"

{
  "address": "0x8589...FDA16",
  "verdict": "risky",           // risky | caution | clear
  "risk": 100,                   // 0-100
  "blocked": true,              // 网关是否会拦下 / gateway blocks?
  "signals": ["混币器合约"],
  "evidence": [                  // 可点开核验的证据 / verifiable
    { "label": "命中 mixer 名单", "detail": "Tornado Cash",
      "url": "https://etherscan.io/address/0x8589..." }
  ],
  "advice": "Decline. ...",
  "standard": "https://oceanalt.com/en/rap"
}

POST/api/risk/batch

批量查询

一次查一串地址(自动去重,最多 25 个)。适合 OTC 收款台 / 系统批处理。结果按高危 → 谨慎 → 清白排序。

参数

addresses 必填 — 地址数组(JSON body),最多 25 个

示例

curl -X POST "https://oceanalt.com/api/risk/batch" \
  -H "content-type: application/json" \
  -d '{"addresses":["0x8589...","TWd4...","T..."]}'

{
  "summary": { "total": 3, "risky": 1, "caution": 0, "invalid": 1 },
  "results": [
    { "address": "0x8589...", "verdict": "risky", "risk": 100,
      "blocked": true,  "top": "混币器合约" },
    { "address": "TWd4...",    "verdict": "clear", "risk": 3,
      "blocked": false, "top": "有历史活动" }
  ]
}

GET/api/risk/flow

资金流分析(波场 + EVM)

波场 USDT 地址:上下游对手方(按金额 top 8)、第一笔 U 来源、被 Tether 冻结的对手方标记、跨链桥识别。EVM(ethereum/base/polygon/arbitrum/optimism,传 network)给 USDT/USDC 上下游 + 桥识别。

参数

addr 必填 — 波场 TRON 地址(T 开头)或 0x EVM 地址
network 可选 — 0x 地址所在 EVM 链(ethereum 默认 / base / polygon / arbitrum / optimism);波场无需填

示例

curl "https://oceanalt.com/api/risk/flow?addr=TWd4WrZ9wn84f5x1hZhL4DHvk738ns5jwb"

{
  "chain": "tron",
  "total": 10000,
  "inbound":  [ { "address": "T...", "tag": "Binance-Hot",
                  "count": 17, "usdt": 2890000, "risky": false } ],
  "outbound": [ { "address": "T...", "tag": "OKX Hot",
                  "count": 25, "usdt": 3370000, "risky": false } ],
  "firstInflow": { "from": "T...", "usdt": 500, "date": "2024-06-01" },
  "riskyParties": 0
}

判定含义

risky — 命中制裁 / 混币器 / 我方风险名单,或链上高危 → 建议拒付。
caution — 存在风险信号 → 只在授权额度内谨慎处理。
clear — 未见风险信号。注意:查不到 ≠ 一定安全。

支持的网络

7 条 EVM 链 + 波场 TRON + Solana。制裁 / 混币器 / 诈骗名单判定与链无关(全网通用);链上信号与稳定币(USDT/USDC)发行方冻结按对应链实时查、可点开核验。

ethereum · base · bsc · polygon · arbitrum · optimism · avalanche
tron (USDT-TRC20 冻结 / 深度追踪 / 资金流) · solana (制裁名单)

x402 付费高阶(按次付费 · 免注册免 key)

更重的分析走 x402:HTTP 402 → 签一次 USDC 授权 → 200。facilitator 代验签、代付 gas、不托管你的资金。用 oceanalt-aml SDK 一行搞定,或任意 x402 客户端。

POST /api/x402/decision — 完整网关合规判决(allow/review/decline)+ 证据 · $0.30
GET /api/x402/trace?addr=T… — 波场多跳沾染追踪(≤3 跳) · $0.20
POST /api/x402/batch — 批量筛查(≤25) · $0.10

机器可读清单(免费 vs 付费 / 网络 / facilitator / 定价):/api/x402

SDK 与 MCP(装进你的 agent)

① 编程 SDK(Node / 浏览器 / Deno / Bun,免费路径零依赖):

npm i oceanalt-aml

import { OceanAltAML } from "oceanalt-aml";
const aml = new OceanAltAML();
const r = await aml.screen("0x…", { network: "optimism" });        // free
const d = await aml.decision({ to: "0x…", amountUsdc: 25 },        // paid (x402)
  { privateKey: process.env.PAYER_KEY });

② MCP server(让 Claude / 任意 MCP 客户端原生调用):

{
  "mcpServers": {
    "oceanalt-aml": {
      "command": "npx", "args": ["-y", "oceanalt-aml-mcp"],
      "env": { "OCEANALT_PAYER_KEY": "0x…" }
    }
  }
}

免费工具:screen_address、recent_flagged;付费工具:compliance_decision、deep_trace、batch_screen(需 OCEANALT_PAYER_KEY)。

合理使用:免费供个人与集成测试。大流量 / 商用请联系我们。本接口给风险信号,不构成投资 / 交易建议。

🤖 x402 生态可调用(免费):我们把 AML 声明为 x402 资源、price=0 —— agent 无需付费、无需 key 直接调用(对标慢雾等付费按次接口)。机器可读清单:/api/x402。每次查询都在积累我们自建的地址情报库,越用越厚。

→ 先在网页里试试查地址 · 完整合规网关(11 道闸) · RAP 标准