# LEGIT Trust API

**Canonical:** https://apis.io/apis/gonna-bond/legit-trust-api/  
**Provider:** GONNA — https://apis.io/providers/gonna-bond/  
**Base URL:** https://legit.gonna.bond  
**Documentation:** https://legit.gonna.bond/docs

LEGIT Trust API is one of 3 APIs that [GONNA](https://apis.io/providers/gonna-bond/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Trust, Merchant Trust, x402, Agentic Commerce, and Payments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

REST API for the LEGIT trust oracle: trust-check one x402 merchant address (score, grade, uptime, latency, explanation), pull a deep report with 30-day history and percentile, batch-check up to 20 addresses, get a best-merchant routing recommendation for a stated need, resolve on-chain merchant identity, read the ranked leaderboard, trending merchants, per-chain network health, receipts and the live network pulse. Five verdict endpoints (compare, arena, history, watch, deep-check) answer HTTP 402 with an x402 v2 PaymentRequired document and are paid per call in USDC (algorand-mainnet $0.004, base-mainnet $0.005); everything else is free with no authentication. 24 operations across 24 paths, published as OpenAPI 3.1.0 at https://legit.gonna.bond/openapi.json; the spec declares no servers[] and the base URL is the host the provider's own llms.txt examples call.

## Operations (24)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | Liveness probe |
| GET | `/v1/leaderboard` | Query the ranked merchant leaderboard to shortlist counterparties |
| GET | `/v1/stats` | Read headline service stats and storage facts |
| GET | `/v1/compare` | Compare 2-5 addresses side-by-side before picking one to pay |
| GET | `/v1/check/{address}` | Trust-check a merchant address before paying it |
| GET | `/v1/receipts` | Receipts |
| GET | `/v1/route` | Get a routing recommendation between two counterparties |
| GET | `/v1/report/{address}` | Pull the full trust report of one merchant before integrating |
| POST | `/v1/batch-check` | Batch-check multiple addresses in one call |
| GET | `/v1/trending` | See trending active merchants |
| GET | `/v1/pulse` | Read the live x402 network pulse |
| GET | `/v1/chain-logos` | Resolve official chain brand tiles |
| GET | `/v1/networks` | Check per-chain payment health before routing |
| GET | `/v1/merchant/{address}/identity` | Resolve a merchant's on-chain identity across chains |
| GET | `/v1/arena` | Get arena verdicts: the 24h cross-chain settlement benchmark |
| GET | `/v1/arena/preview` | Preview the settlement arena for free |
| GET | `/.well-known/legit` | Discover LEGIT's endpoints, pricing and rails |
| GET | `/v1/history` | Pull 30-day score history of one merchant for trend analysis |
| POST | `/v1/watch` | Set a webhook-armed 7- or 30-day watch sentinel that fires on grade transitions |
| GET | `/v1/watches/{watch_id}` | Read watch status free with the bearer watch id |
| GET | `/v1/watches/{watch_id}/events` | Read the watch event feed, the source of truth |
| POST | `/v1/deep-check` | Run deep-check due diligence on up to 10 addresses |
| GET | `/v1/referee/reproduce.py` | Referee Reproduce Script |
| GET | `/v1/referee` | Referee Report |

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gonna-bond/refs/heads/main/openapi/gonna-bond-legit-openapi.yml
- **OpenAPI** — https://legit.gonna.bond/openapi.json
- **Documentation** — https://legit.gonna.bond/docs
- **APIReference** — https://legit.gonna.bond/openapi.json
- **LLMsTxt** — https://raw.githubusercontent.com/api-evangelist/gonna-bond/refs/heads/main/llms/gonna-bond-llms.txt
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/gonna-bond/refs/heads/main/asyncapi/gonna-bond-watch-webhooks.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/gonna-bond/refs/heads/main/overlays/gonna-bond-legit-overlay.yaml
- **X-X402Discovery** — https://legit.gonna.bond/.well-known/x402
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/gonna-bond/refs/heads/main/apis.yml

## Other GONNA APIs (2)

- [LEGIT MCP Server](https://apis.io/apis/gonna-bond/legit-mcp-server/)
- [LEGIT A2A Agent Card](https://apis.io/apis/gonna-bond/legit-a2a-agent/)

## Tags

Trust, Merchant Trust, x402, Agentic Commerce, Payments, Webhook

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gonna-bond/legit-trust-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gonna-bond/.