> For the complete documentation index, see [llms.txt](https://docs.bv7x.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bv7x.ai/agentic-commerce/a2a-protocol.md).

# A2A Protocol

BV-7X supports the [Agent-to-Agent (A2A) protocol](https://google.github.io/A2A/) for structured inter-agent communication. Other AI agents can send tasks and receive structured responses.

***

## Agent Card

The agent card is auto-discoverable at:

```
https://bv7x.ai/.well-known/agent-card.json
```

It advertises the agent's capabilities, skills, supported protocols (MCP, OpenAPI), and authentication requirements.

***

## Endpoint

```
POST /api/bv7x/a2a/tasks/send
Content-Type: application/json
Authorization: Bearer <token>
```

**Authentication**: Basic tier (500M+ $BV7X)

***

## Skills

| Skill            | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `predict`        | Get the current BV-7X signal with direction and confidence   |
| `verify`         | Verify an on-chain attestation by UID                        |
| `track-record`   | Get prediction accuracy statistics                           |
| `market-context` | Get current market data (BTC price, F\&G, ETF flows, regime) |

***

## Request Format

```json
{
  "jsonrpc": "2.0",
  "method": "tasks/send",
  "params": {
    "id": "task-001",
    "message": {
      "role": "user",
      "parts": [
        {
          "type": "text",
          "text": "What is the current BV-7X signal?"
        }
      ]
    },
    "skill": "predict"
  }
}
```

| Field     | Type   | Description                       |
| --------- | ------ | --------------------------------- |
| `id`      | string | Unique task identifier            |
| `message` | object | Input message with role and parts |
| `skill`   | string | Which skill to invoke             |

***

## Response Format

```json
{
  "jsonrpc": "2.0",
  "result": {
    "id": "task-001",
    "status": {
      "state": "completed"
    },
    "artifacts": [
      {
        "parts": [
          {
            "type": "text",
            "text": "Current signal: SELL with 61.5% confidence. BTC at $66,027. Regime: BEAR_TREND."
          }
        ]
      }
    ]
  }
}
```

***

## Skill Examples

### predict

```json
{
  "skill": "predict",
  "message": {
    "role": "user",
    "parts": [{ "type": "text", "text": "What is today's signal?" }]
  }
}
```

### verify

```json
{
  "skill": "verify",
  "message": {
    "role": "user",
    "parts": [{ "type": "text", "text": "Verify attestation 0xabc123..." }]
  }
}
```

### track-record

```json
{
  "skill": "track-record",
  "message": {
    "role": "user",
    "parts": [{ "type": "text", "text": "What is the oracle's accuracy?" }]
  }
}
```

### market-context

```json
{
  "skill": "market-context",
  "message": {
    "role": "user",
    "parts": [{ "type": "text", "text": "Give me the current market overview" }]
  }
}
```

***

## Error States

| State       | Meaning                                   |
| ----------- | ----------------------------------------- |
| `completed` | Task finished successfully                |
| `failed`    | Task failed (check error message)         |
| `rejected`  | Skill not recognized or auth insufficient |

***

## Next

* [MCP Server](/agentic-commerce/mcp-server.md) -- tool-based integration
* [ERC-8004 Identity](/agentic-commerce/erc-8004.md) -- on-chain agent identity