ExchangeRebel A2A Messaging API

The A2A Messaging API from ExchangeRebel — 16 operation(s) for a2a messaging.

GitHub OpenAPI

Operations 16

POST /toll/a2a/send A2A 1:1 ciphertext DM send: $0.005, payer = sender mailbox #
GET /toll/a2a/health A2A relay health (free) #
GET /toll/a2a/catalog A2A catalog: send $0.005, all other ops free; abuse contact listed #
GET /toll/a2a/schema A2A send schema + error vocabulary (free) #
POST /toll/a2a/mailbox/declare Declare an A2A mailbox (free, self-signed) #
POST /toll/a2a/mailbox/preflight A2A mailbox preflight (free, minimal shape) #
POST /toll/a2a/mailbox/challenge A2A mailbox challenge (free) #
POST /toll/a2a/mailbox/policy Set A2A mailbox policy (free, signed) #
POST /toll/a2a/mailbox/deregister Deregister an A2A mailbox (free, signed) #
POST /toll/a2a/send/preflight Free preflight twin of the A2A send op #
POST /toll/a2a/inbox/list List A2A inbox envelopes (free, owner-signed) #
POST /toll/a2a/inbox/read Read an A2A message (free, owner-signed) #
POST /toll/a2a/inbox/ack Acknowledge an A2A message (free, owner-signed) #
POST /toll/a2a/messages/status A2A message receipt state (free, party-signed) #
POST /toll/a2a/contacts A2A contacts list (free, owner-signed) #
POST /toll/a2a/block A2A block list (free, owner-signed) #

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/exchangerebel-com:exchangerebel-com-a2a-messaging-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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

exchangerebel-com-a2a-messaging-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: ExchangeRebel — pay-per-call APIs for AI agents (x402 on…
  version: 1.0.0
  contact:
    name: 'ExchangeRebel (operator: Rebel Data)'
    url: https://exchangerebel.com
    email: sound.money.investing@gmail.com
  x-guidance: 'All paid operations use x402 on Solana: call without payment to get a 402 challenge (SOL recipient + USDC token account + fresh memo), pay with the memo attached via the Solana Memo program, then retry with header X-Payment-Tx: <signature> and ?toll_memo=<memo>. Challenges are dual-version: the PAYMENT-REQUIRED header carries the x402 v2 PaymentRequired object and the response body carries the same challenge in x402 v1 form for compatibility. Free operations (security: []) include each service''s /health catalog with full response shapes. Prices in x-payment-info are USD per call unless the summary says otherwise (RPC is per 1,000-request block; Telegram provisioning is per bot-month; transcription is per minute of audio).'
  description: '67 data and utility APIs behind x402 tolls, settled in SOL or USDC on Solana. Call a paid endpoint without payment to receive a 402 x402 challenge (recipient + fresh memo), pay with the memo attached via the Solana Memo program, then retry with the X-Payment-Tx header and toll_memo query parameter. Free catalog/health endpoints are marked without x-payment-info. Full catalogs: GET /toll/discovery and each service''s /health.'
servers:
- url: https://exchangerebel.com
tags:
- name: A2A Messaging
paths:
  /toll/a2a/send:
    post:
      tags:
      - A2A Messaging
      summary: 'A2A 1:1 ciphertext DM send: $0.005, payer = sender mailbox'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
          content:
            application/json:
              example:
                message_id: m_eeae2e4c33c00e3dd0e52340ba1af1fe
                inbox_seq: 1
                stored_at: '2026-10-21T21:20:00.365Z'
                expires_at: '2026-11-20T21:20:00.365Z'
                state: stored
              schema:
                type: object
                properties:
                  message_id:
                    type: string
                  inbox_seq:
                    type: integer
                  stored_at:
                    type: string
                  expires_at:
                    type: string
                  state:
                    type: string
                    enum:
                    - stored
                  idempotent_replay:
                    type: boolean
                    description: 'Present (true) only when the call replayed an already-stored message under the same idempotency key: the original receipt is returned; nothing is re-stored or re-charged.'
                  paid_via:
                    type: string
                    enum:
                    - payai
                    - dexter
                    description: Present only when payment settled on a facilitator rail.
                required:
                - message_id
                - inbox_seq
                - stored_at
                - expires_at
                - state
        '402':
          description: 'Payment Required (x402). The PAYMENT-REQUIRED response header carries the x402 v2 PaymentRequired object (base64 JSON: scheme, CAIP-2 network, amount, asset, payTo, plus the bazaar discovery extension); the response body carries the same challenge in x402 v1 form for compatibility, naming the SOL recipient and USDC token account on Solana plus a fresh memo. To pay on this service''s rail: pay with the memo attached (Solana Memo program), then retry with header ''X-Payment-Tx: <transaction signature>'' and query parameter ''toll_memo=<memo>''.'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                from:
                  type: string
                  description: string (required) - sender mailbox pubkey (base58 Ed25519; declared, = payer of record)
                to:
                  type: string
                  description: string - recipient mailbox pubkey (exactly one of to / to_handle)
                to_handle:
                  type: string
                  minLength: 3
                  maxLength: 32
                  description: string - recipient handle, 3-32 chars [a-z0-9_-] after lower-casing (exactly one of to / to_handle)
                ciphertext:
                  type: string
                  description: string (required) - base64 ciphertext, decoded <= 16384 bytes
                idempotency_key:
                  type: string
                  minLength: 16
                  maxLength: 128
                  description: string (required) - 16-128 chars
                client_ts:
                  type: string
                  maxLength: 64
                  description: string (required) - ISO 8601 sender-claimed send time
                signature:
                  type: string
                  description: string (required) - base64 Ed25519 signature over the a2a-msg/v1 payload; decodes to exactly 64 bytes
              required:
              - from
              - ciphertext
              - idempotency_key
              - client_ts
              - signature
              anyOf:
              - required:
                - to
              - required:
                - to_handle
      x-payment-info:
        protocols:
        - x402
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
      security:
      - x402Payment: []
      operationId: postTollA2aSend
      x-operation-id-source: derived
  /toll/a2a/health:
    get:
      tags:
      - A2A Messaging
      summary: A2A relay health (free)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollA2aHealth
      x-operation-id-source: derived
  /toll/a2a/catalog:
    get:
      tags:
      - A2A Messaging
      summary: 'A2A catalog: send $0.005, all other ops free; abuse contact listed'
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollA2aCatalog
      x-operation-id-source: derived
  /toll/a2a/schema:
    get:
      tags:
      - A2A Messaging
      summary: A2A send schema + error vocabulary (free)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: getTollA2aSchema
      x-operation-id-source: derived
  /toll/a2a/mailbox/declare:
    post:
      tags:
      - A2A Messaging
      summary: Declare an A2A mailbox (free, self-signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                pubkey:
                  type: string
                  description: string (required) - base58 Ed25519 public key
                signature:
                  type: string
                  description: string (required) - base64 Ed25519 over the declare payload
              required:
              - pubkey
              - signature
      security: []
      operationId: postTollA2aMailboxDeclare
      x-operation-id-source: derived
  /toll/a2a/mailbox/preflight:
    post:
      tags:
      - A2A Messaging
      summary: A2A mailbox preflight (free, minimal shape)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                pubkey:
                  type: string
                  description: string (required) - base58 Ed25519 public key
              required:
              - pubkey
      security: []
      operationId: postTollA2aMailboxPreflight
      x-operation-id-source: derived
  /toll/a2a/mailbox/challenge:
    post:
      tags:
      - A2A Messaging
      summary: A2A mailbox challenge (free)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                pubkey:
                  type: string
                  description: string (required) - base58 Ed25519 public key
              required:
              - pubkey
      security: []
      operationId: postTollA2aMailboxChallenge
      x-operation-id-source: derived
  /toll/a2a/mailbox/policy:
    post:
      tags:
      - A2A Messaging
      summary: Set A2A mailbox policy (free, signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aMailboxPolicy
      x-operation-id-source: derived
  /toll/a2a/mailbox/deregister:
    post:
      tags:
      - A2A Messaging
      summary: Deregister an A2A mailbox (free, signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aMailboxDeregister
      x-operation-id-source: derived
  /toll/a2a/send/preflight:
    post:
      tags:
      - A2A Messaging
      summary: Free preflight twin of the A2A send op
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      requestBody:
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              properties:
                from:
                  type: string
                  description: string (required) - sender mailbox pubkey (base58 Ed25519; declared, = payer of record)
                to:
                  type: string
                  description: string - recipient mailbox pubkey (exactly one of to / to_handle)
                to_handle:
                  type: string
                  minLength: 3
                  maxLength: 32
                  description: string - recipient handle, 3-32 chars [a-z0-9_-] after lower-casing (exactly one of to / to_handle)
                ciphertext:
                  type: string
                  description: string (required) - base64 ciphertext, decoded <= 16384 bytes
                idempotency_key:
                  type: string
                  minLength: 16
                  maxLength: 128
                  description: string (required) - 16-128 chars
                client_ts:
                  type: string
                  maxLength: 64
                  description: string (required) - ISO 8601 sender-claimed send time
                signature:
                  type: string
                  description: string (required) - base64 Ed25519 signature over the a2a-msg/v1 payload; decodes to exactly 64 bytes
              required:
              - from
              - ciphertext
              - idempotency_key
              - client_ts
              - signature
              anyOf:
              - required:
                - to
              - required:
                - to_handle
      security: []
      operationId: postTollA2aSendPreflight
      x-operation-id-source: derived
  /toll/a2a/inbox/list:
    post:
      tags:
      - A2A Messaging
      summary: List A2A inbox envelopes (free, owner-signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aInboxList
      x-operation-id-source: derived
  /toll/a2a/inbox/read:
    post:
      tags:
      - A2A Messaging
      summary: Read an A2A message (free, owner-signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aInboxRead
      x-operation-id-source: derived
  /toll/a2a/inbox/ack:
    post:
      tags:
      - A2A Messaging
      summary: Acknowledge an A2A message (free, owner-signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aInboxAck
      x-operation-id-source: derived
  /toll/a2a/messages/status:
    post:
      tags:
      - A2A Messaging
      summary: A2A message receipt state (free, party-signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aMessagesStatus
      x-operation-id-source: derived
  /toll/a2a/contacts:
    post:
      tags:
      - A2A Messaging
      summary: A2A contacts list (free, owner-signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aContacts
      x-operation-id-source: derived
  /toll/a2a/block:
    post:
      tags:
      - A2A Messaging
      summary: A2A block list (free, owner-signed)
      responses:
        '200':
          description: Success. Response shape is documented in the service catalog (GET /health on the service).
      security: []
      operationId: postTollA2aBlock
      x-operation-id-source: derived
components:
  securitySchemes:
    x402Payment:
      type: apiKey
      in: header
      name: X-Payment-Tx
      description: 'x402 toll payment proof: the Solana transaction signature of a payment carrying the memo from the 402 challenge; send together with ?toll_memo=<memo>. Payment itself is made on-chain in SOL or USDC to the recipient named in the challenge.'