# DisputeTracker agent API quickstart

DisputeTracker provides paid, machine-readable Polymarket and UMA resolution intelligence.

- OpenAPI: https://disputetracker.xyz/openapi.json
- Service manifest: https://disputetracker.xyz/.well-known/agent-payments.json
- MCP: https://disputetracker.xyz/mcp
- Agent Card: https://disputetracker.xyz/.well-known/agent-card.json

## 1. Discover

```bash
curl -sS https://disputetracker.xyz/.well-known/agent-payments.json
curl -sS https://disputetracker.xyz/openapi.json
```

## 2. Request a challenge

x402 v2 on Base mainnet:

```bash
curl -i -X POST 'https://x402.disputetracker.xyz/api/agent/dispute-brief/x402' \
  -H 'content-type: application/json' \
  --data '{"slugOrUrl":"example-polymarket-event"}'
```

MPP on Tempo mainnet:

```bash
curl -i -X POST 'https://mpp.disputetracker.xyz/api/agent/dispute-brief/mpp' \
  -H 'content-type: application/json' \
  --data '{"slugOrUrl":"example-polymarket-event"}'
```

The first valid request returns HTTP 402. Read `PAYMENT-REQUIRED` for x402 or `WWW-Authenticate` for MPP.

## 3. Validate, sign, retry

Validate the runtime network, token, amount, recipient, and expiry against your local spending policy. Sign only in your own wallet. Retry with `PAYMENT-SIGNATURE` or `Authorization: Payment ...`, and require the corresponding receipt header on success.

Never paste a wallet private key into a request, URL, prompt, or this service.