Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/agentsapi-top:agentsapi-top-subscription-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: bridge-watch Subscription API
version: 0.1.0
description: 'On-chain risk intelligence API for AI agents on Base: address labels, transaction explain, sybil clustering, CCTP tracking, alerts. Pay per request with USDC via x402 (HTTP 402 auto-negotiated).'
x-guidance: 'All /v1/* endpoints are paid via x402: call without auth, read the 402/401 response body for the PaymentRequired challenge, pay with USDC on Base (eip155:8453) to payTo 0x381cdbb664608bf7b1dd4f9403a572c1c57332c2, then retry with X-Payment header or Authorization: Bearer <payment-address>. /healthz and /statusz are free. See /.well-known/x402 for the full manifest.'
contact:
name: mavisCrypto
url: https://agentsapi.top
email: ops@agentsapi.top
x-version:
restSpec: 0.1.0
product: 0.3.1
mcpServer: 0.3.1
note: restSpec is the version of this OpenAPI document; product/mcpServer are the live bridge-watch release, sourced from GET /mcp and MCP initialize at build time
source:
- GET https://agentsapi.top/mcp
- POST https://agentsapi.top/mcp initialize
- POST https://agentsapi.top/mcp tools/list
x-mcp:
endpoint: https://agentsapi.top/mcp
transport: streamable-http
registry: top.agentsapi/bridge-watch
serverInfo:
name: bridge-watch
version: 0.3.1
protocolVersion: '2025-06-18'
freeTier:
enabled: true
tools:
- get_label
- explain_transaction
- detect_cluster
- query_alerts
- alert_stats
- track_cctp
- list_paid_endpoints
perIp: 7
dailyCap: 500
perTool: 1
tools:
- name: get_label
credits: 1
usdc: '0.01'
description: Look up the identity label of an EVM address (Base, open eth-labels dataset; mostly category tags rather than named entities). Returns which entity the address belongs to; unlabelled addresses return null. Call with no arguments for a free demo result.
readOnly: true
- name: explain_transaction
credits: 2
usdc: '0.02'
description: 'Explain what a transaction did: status, sender/receiver (with identity labels), transfer details, and whether it looks like a cross-chain bridge operation.'
readOnly: true
- name: detect_cluster
credits: 5
usdc: '0.05'
description: Detect the set of addresses funded by a single funder (shared funding-source cluster). Useful for sybil / entity detection.
readOnly: true
- name: query_alerts
credits: 1
usdc: '0.01'
description: Query historical alert records; filterable by address, rule kind, severity, and time range.
readOnly: true
- name: alert_stats
credits: 1
usdc: '0.01'
description: 'Alert statistics overview: totals, breakdown by kind / severity / address, and the latest alert time.'
readOnly: true
- name: track_cctp
credits: 3
usdc: '0.03'
description: 'CCTP cross-chain transfer tracking: given a source-chain tx hash, find which transfer it belongs to, how much moved, the destination chain, and whether it arrived. Supports Base → Ethereum and other CCTP chains.'
readOnly: true
- name: list_paid_endpoints
credits: 1
usdc: '0.01'
description: List every paid HTTP endpoint of this service with its live per-call price in USDC on Base. Takes no arguments. Call this first to discover what you can buy and what it costs.
readOnly: true
payment:
protocol: x402 v2 (v1 X-PAYMENT compatible)
network: base
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
asset: USDC
creditPerUsdc: 100
howToCall:
- 'POST https://agentsapi.top/mcp with Content-Type: application/json and Accept: application/json, text/event-stream'
- 'Body is JSON-RPC 2.0: initialize (free) → tools/list (free) → tools/call (paid)'
- A paid tool/call returns a PaymentRequired object inside the JSON-RPC result; the /mcp protocol plane itself never returns HTTP 402
- 'Pay USDC on Base to payTo, then retry tools/call with the payer address as Authorization: Bearer <address> (or x402 payment-signature header)'
- 'Anonymous free tier: 7 tool calls per IP per day, 1 per tool across all 7 tools (get_label, explain_transaction, detect_cluster, query_alerts, alert_stats, track_cctp, list_paid_endpoints; no wallet, no signup)'
machineReadable:
mcpDescriptor: https://agentsapi.top/.well-known/mcp.json
serverCard: https://agentsapi.top/.well-known/mcp/server-card.json
x402Manifest: https://agentsapi.top/.well-known/x402
skill: https://agentsapi.top/skill.md
llmsTxt: https://agentsapi.top/llms.txt
servers:
- url: https://agentsapi.top
tags:
- name: Subscription
description: Alert subscriptions
paths:
/v1/alerts/subscribe:
post:
summary: Subscribe to future alerts
description: Subscribe an agent to future on-chain alerts on Base, delivered via webhook or Telegram.
tags:
- Subscription
security: []
x-payment-info:
price:
mode: fixed
currency: USD
amount: '0.010000'
protocols:
- x402: {}
responses:
'200':
description: Success
content:
application/json:
example:
ok: true
subscription:
id: sub_1789561036359_502mic
type: webhook
until: 1794745036359
payer: '0x0f47420e4df64c2aef923ea2355ee57090713077'
schema:
type: object
properties:
ok:
type: boolean
subscription:
type: object
required:
- ok
- subscription
additionalProperties: true
'402':
description: Payment required - x402 negotiation (see 402 response body for payment requirements)
content:
application/json:
example:
x402Version: 2
error: Payment Required
hint: 向 payTo 转入 USDC，并以同一地址作为 Bearer 身份继续调用
freeTierReason: null
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
docs: https://agentsapi.top/
resource:
url: https://agentsapi.top/v1/alerts/subscribe
description: Subscribe an agent to future on-chain alerts on Base, delivered via webhook or Telegram.
tags:
- base
- alerts
- webhook
- telegram
mimeType: application/json
accepts:
- x402Version: 2
scheme: exact
network: eip155:8453
maxAmountRequired: '10000'
resource: https://agentsapi.top/v1/alerts/subscribe
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
maxTimeoutSeconds: 300
facilitator:
url: https://api.cdp.coinbase.com/platform/v2/x402
amount: '10000'
extra:
name: USD Coin
version: '2'
extensions:
bazaar:
info:
input:
type: http
method: POST
bodyType: json
discoverable: true
body:
type: webhook
url: https://example.com/hook
output:
type: json
example:
ok: true
subscription:
id: sub_1789561036359_502mic
type: webhook
until: 1794745036359
payer: '0x0f47420e4df64c2aef923ea2355ee57090713077'
schema:
$schema: https://json-schema.org/draft/2020-12/schema
type: object
properties:
input:
type: object
properties:
type:
type: string
url:
type: string
output:
type: object
properties:
type:
type: string
example:
type: object
required:
- type
required:
- input
x402:
x402Version: 2
scheme: exact
network: eip155:8453
maxAmountRequired: '10000'
resource: https://agentsapi.top/v1/alerts/subscribe
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
maxTimeoutSeconds: 300
facilitator:
url: https://api.cdp.coinbase.com/platform/v2/x402
headers:
payment-required:
description: Base64-encoded PaymentRequired challenge (identical object to the JSON body). Present on every 402 response (captured 15/15 on 2026-10-10).
schema:
type: string
x-payment-requirements:
description: 'Single x402 v2 payment requirement: network eip155:8453, asset (USDC), payTo, maxAmountRequired (atomic units, 6 decimals), facilitator URL.'
schema:
type: string
operationId: postV1AlertsSubscribe
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: API key or funded payment address
x-mcp:
endpoint: https://agentsapi.top/mcp
transport: streamable-http
registry: top.agentsapi/bridge-watch
serverInfo:
name: bridge-watch
version: 0.3.1
protocolVersion: '2025-06-18'
freeTier:
enabled: true
tools:
- get_label
- explain_transaction
- detect_cluster
- query_alerts
- alert_stats
- track_cctp
- list_paid_endpoints
perIp: 7
dailyCap: 500
perTool: 1
tools:
- name: get_label
credits: 1
usdc: '0.01'
description: Look up the identity label of an EVM address (Base, open eth-labels dataset; mostly category tags rather than named entities). Returns which entity the address belongs to; unlabelled addresses return null. Call with no arguments for a free demo result.
readOnly: true
- name: explain_transaction
credits: 2
usdc: '0.02'
description: 'Explain what a transaction did: status, sender/receiver (with identity labels), transfer details, and whether it looks like a cross-chain bridge operation.'
readOnly: true
- name: detect_cluster
credits: 5
usdc: '0.05'
description: Detect the set of addresses funded by a single funder (shared funding-source cluster). Useful for sybil / entity detection.
readOnly: true
- name: query_alerts
credits: 1
usdc: '0.01'
description: Query historical alert records; filterable by address, rule kind, severity, and time range.
readOnly: true
- name: alert_stats
credits: 1
usdc: '0.01'
description: 'Alert statistics overview: totals, breakdown by kind / severity / address, and the latest alert time.'
readOnly: true
- name: track_cctp
credits: 3
usdc: '0.03'
description: 'CCTP cross-chain transfer tracking: given a source-chain tx hash, find which transfer it belongs to, how much moved, the destination chain, and whether it arrived. Supports Base → Ethereum and other CCTP chains.'
readOnly: true
- name: list_paid_endpoints
credits: 1
usdc: '0.01'
description: List every paid HTTP endpoint of this service with its live per-call price in USDC on Base. Takes no arguments. Call this first to discover what you can buy and what it costs.
readOnly: true
payment:
protocol: x402 v2 (v1 X-PAYMENT compatible)
network: base
payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
asset: USDC
creditPerUsdc: 100
howToCall:
- 'POST https://agentsapi.top/mcp with Content-Type: application/json and Accept: application/json, text/event-stream'
- 'Body is JSON-RPC 2.0: initialize (free) → tools/list (free) → tools/call (paid)'
- A paid tool/call returns a PaymentRequired object inside the JSON-RPC result; the /mcp protocol plane itself never returns HTTP 402
- 'Pay USDC on Base to payTo, then retry tools/call with the payer address as Authorization: Bearer <address> (or x402 payment-signature header)'
- 'Anonymous free tier: 7 tool calls per IP per day, 1 per tool across all 7 tools (get_label, explain_transaction, detect_cluster, query_alerts, alert_stats, track_cctp, list_paid_endpoints; no wallet, no signup)'
machineReadable:
mcpDescriptor: https://agentsapi.top/.well-known/mcp.json
serverCard: https://agentsapi.top/.well-known/mcp/server-card.json
x402Manifest: https://agentsapi.top/.well-known/x402
skill: https://agentsapi.top/skill.md
llmsTxt: https://agentsapi.top/llms.txt