agentsapi-top Cctp API

CCTP cross-chain USDC tracking

Operations 2

GET /v1/track/cctp/{txHash} CCTP cross-chain USDC tracking #
POST /v1/track/cctp/{txHash} CCTP cross-chain USDC tracking #

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-cctp-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

agentsapi-top-cctp-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: bridge-watch Cctp 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: cctp
  description: CCTP cross-chain USDC tracking
paths:
  /v1/track/cctp/{txHash}:
    get:
      summary: CCTP cross-chain USDC tracking
      description: 'CCTP cross-chain USDC tracking: given the source-chain tx hash, returns burn/mint status and whether funds arrived on Base.'
      tags:
      - cctp
      security: []
      parameters:
      - name: txHash
        in: path
        required: true
        schema:
          type: string
          pattern: ^0x[0-9a-fA-F]{64}$
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.030000'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                isCctp: false
                message: 不是 CCTP 跨链转账(未发现 DepositForBurn 事件)
              schema:
                type: object
                properties:
                  isCctp:
                    type: boolean
                  message:
                    type: string
                required:
                - isCctp
                - message
                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/track/cctp/0x648c0d9b7743e63e8ef542f3e285e8e2eaf964c92fc8df5122cb7e7bcf084279
                  description: 'CCTP cross-chain USDC tracking: given the source-chain tx hash, returns burn/mint status and whether funds arrived on Base.'
                  tags:
                  - base
                  - cctp
                  - cross-chain
                  - usdc
                  mimeType: application/json
                accepts:
                - x402Version: 2
                  scheme: exact
                  network: eip155:8453
                  maxAmountRequired: '30000'
                  resource: https://agentsapi.top/v1/track/cctp/0x648c0d9b7743e63e8ef542f3e285e8e2eaf964c92fc8df5122cb7e7bcf084279
                  payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
                  asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  maxTimeoutSeconds: 300
                  facilitator:
                    url: https://api.cdp.coinbase.com/platform/v2/x402
                  amount: '30000'
                  extra:
                    name: USD Coin
                    version: '2'
                extensions:
                  bazaar:
                    info:
                      input:
                        type: http
                        method: GET
                        discoverable: true
                      output:
                        type: json
                        example:
                          isCctp: false
                          message: 不是 CCTP 跨链转账(未发现 DepositForBurn 事件)
                    schema:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      type: object
                      properties:
                        input:
                          type: object
                          required:
                          - txHash
                          properties:
                            txHash:
                              type: string
                              format: tx-hash
                        output:
                          type: object
                          properties:
                            type:
                              type: string
                            example:
                              type: object
                          required:
                          - type
                      required:
                      - input
                x402:
                  x402Version: 2
                  scheme: exact
                  network: eip155:8453
                  maxAmountRequired: '30000'
                  resource: https://agentsapi.top/v1/track/cctp/0x648c0d9b7743e63e8ef542f3e285e8e2eaf964c92fc8df5122cb7e7bcf084279
                  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: getV1TrackCctpByTxHash
      x-operation-id-source: derived
    post:
      summary: CCTP cross-chain USDC tracking
      description: 'CCTP cross-chain USDC tracking: given the source-chain tx hash, returns burn/mint status and whether funds arrived on Base.'
      tags:
      - cctp
      security: []
      parameters:
      - name: txHash
        in: path
        required: true
        schema:
          type: string
          pattern: ^0x[0-9a-fA-F]{64}$
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.030000'
        protocols:
        - x402: {}
      responses:
        '200':
          description: Success
          content:
            application/json:
              example:
                isCctp: false
                message: 不是 CCTP 跨链转账(未发现 DepositForBurn 事件)
              schema:
                type: object
                properties:
                  isCctp:
                    type: boolean
                  message:
                    type: string
                required:
                - isCctp
                - message
                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/track/cctp/0x648c0d9b7743e63e8ef542f3e285e8e2eaf964c92fc8df5122cb7e7bcf084279
                  description: 'CCTP cross-chain USDC tracking: given the source-chain tx hash, returns burn/mint status and whether funds arrived on Base.'
                  tags:
                  - base
                  - cctp
                  - cross-chain
                  - usdc
                  mimeType: application/json
                accepts:
                - x402Version: 2
                  scheme: exact
                  network: eip155:8453
                  maxAmountRequired: '30000'
                  resource: https://agentsapi.top/v1/track/cctp/0x648c0d9b7743e63e8ef542f3e285e8e2eaf964c92fc8df5122cb7e7bcf084279
                  payTo: '0x381cdbb664608bf7b1dd4f9403a572c1c57332c2'
                  asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
                  maxTimeoutSeconds: 300
                  facilitator:
                    url: https://api.cdp.coinbase.com/platform/v2/x402
                  amount: '30000'
                  extra:
                    name: USD Coin
                    version: '2'
                extensions:
                  bazaar:
                    info:
                      input:
                        type: http
                        method: POST
                        bodyType: json
                        discoverable: true
                      output:
                        type: json
                        example:
                          isCctp: false
                          message: 不是 CCTP 跨链转账(未发现 DepositForBurn 事件)
                    schema:
                      $schema: https://json-schema.org/draft/2020-12/schema
                      type: object
                      properties:
                        input:
                          type: object
                          required:
                          - txHash
                          properties:
                            txHash:
                              type: string
                              format: tx-hash
                        output:
                          type: object
                          properties:
                            type:
                              type: string
                            example:
                              type: object
                          required:
                          - type
                      required:
                      - input
                x402:
                  x402Version: 2
                  scheme: exact
                  network: eip155:8453
                  maxAmountRequired: '30000'
                  resource: https://agentsapi.top/v1/track/cctp/0x648c0d9b7743e63e8ef542f3e285e8e2eaf964c92fc8df5122cb7e7bcf084279
                  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: op_post
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