agentsapi-top

agentsapi-top Statusz API

The Statusz API from agentsapi-top — 1 operation(s) for statusz.

GitHub OpenAPI

Operations 1

GET /statusz Status / metrics #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/agentsapi-top/openapi/agentsapi-top-statusz-api-openapi.yml

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.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/agentsapi-top:agentsapi-top-statusz-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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

agentsapi-top-statusz-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: bridge-watch Statusz 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: Statusz
paths:
  /statusz:
    get:
      summary: Status / metrics
      security: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              example:
                ok: true
                ts: 1791555132659
                uptimeSec: 3146
                access:
                  logFile: /opt/bridge-watch/data/access.jsonl
                  sampled: 20000
                  last24h: 3723
                  last: '2026-10-09T14:12:11.126Z'
                  topPaths:
                  - value: /mcp
                    count: 1165
                  - value: /v1/label/:address
                    count: 642
                  - value: /
                    count: 234
      tags:
      - Statusz
      operationId: getStatusz
      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