# AAAA Nexus API

**Canonical:** https://apis.io/apis/atomadic-tech/aaaa-nexus-api/  
**Provider:** Atomadic Tech — https://apis.io/providers/atomadic-tech/  
**Base URL:** https://atomadic.tech  
**Documentation:** https://atomadic.tech/quickstart

AAAA Nexus API is one of 2 APIs that [Atomadic Tech](https://apis.io/providers/atomadic-tech/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include AI Agents, Security, Trust, Escrow, and Compliance. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Pay-per-call REST API for autonomous agents: threat scoring, trust and reputation oracles, escrow, SLA bonds, agent registry and discovery, swarm messaging, RatchetGate sessions, identity/UCAN/delegation, EU AI Act compliance certificates, drift certification, verified randomness, text and LLM inference. 149 operations under /v1, metered in micro-USDC via x402 (Base L2) or an X-API-Key credit pack; 3 free trial calls per paid endpoint per day.

## Operations (60 of 149)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | Service health and version |
| GET | `/openapi.json` | OpenAPI specification |
| GET | `/.well-known/agent.json` | A2A agent card |
| GET | `/.well-known/mcp.json` | MCP server manifest |
| GET | `/.well-known/ai-plugin.json` | OpenAI plugin manifest |
| GET | `/.well-known/pricing.json` | Machine-readable pricing |
| GET | `/.well-known/agent-card.json` | Alternative A2A agent card path |
| POST | `/v1/rag/augment` | Trusted RAG augmentation |
| POST | `/v1/lora/buffer/capture` | Capture scrubbed LoRA fix metadata |
| POST | `/v1/lora/buffer/inspect` | Inspect public-safe LoRA buffer metadata |
| GET | `/v1/oracle/entropy` | Entropy epoch oracle |
| GET | `/v1/rng/quantum` | Quantum random number with proof |
| GET | `/v1/rng/verify` | Verify current epoch random value |
| POST | `/v1/rng/seeded` | Seeded deterministic RNG |
| POST | `/v1/rng/batch` | Batch random generation |
| POST | `/v1/rng/stream` | Streaming random values |
| POST | `/v1/verirand/bytes` | Premium verifiable random bytes |
| POST | `/v1/agents/register` | Register an agent |
| GET | `/v1/agents/topology` | Live swarm topology |
| GET | `/v1/agents/status` | Agent status lookup |
| GET | `/v1/agents/capabilities` | List agent capabilities |
| GET | `/v1/agents/search` | Search agents by capability |
| GET | `/v1/agents/health` | Agent health check |
| GET | `/v1/agents/discover` | Discover agents (A2A compatible) |
| POST | `/v1/agents/update` | Update agent capabilities |
| POST | `/v1/agents/deregister` | Deregister an agent |
| POST | `/v1/agents/message` | Send direct message to agent |
| POST | `/v1/agents/negotiate` | Negotiate terms between agents |
| POST | `/v1/agents/delegate` | Delegate task to another agent |
| POST | `/v1/agents/semantic-diff` | Semantic diff between agent outputs |
| POST | `/v1/agents/contradiction` | Detect contradictions in agent outputs |
| GET | `/v1/swarm/inbox` | Poll swarm inbox |
| POST | `/v1/swarm/relay` | Relay message through swarm |
| POST | `/v1/swarm/broadcast` | Broadcast to all swarm members |
| POST | `/v1/swarm/join` | Join swarm group |
| POST | `/v1/swarm/leave` | Leave swarm group |
| GET | `/v1/swarm/topology` | Swarm-scoped topology |
| GET | `/v1/swarm/peers` | List swarm peers |
| POST | `/v1/oracle/hallucination` | Hallucination oracle |
| POST | `/v1/ratchet/register` | RatchetGate — register session |
| POST | `/v1/ratchet/advance` | RatchetGate — advance session |
| GET | `/v1/ratchet/probe` | RatchetGate — health probe |
| GET | `/v1/ratchet/status` | RatchetGate — session status |
| POST | `/v1/ratchet/revoke` | RatchetGate — revoke session |
| POST | `/v1/ratchet/verify` | RatchetGate — verify session integrity |
| GET | `/v1/ratchet/list` | RatchetGate — list active sessions |
| POST | `/v1/identity/verify` | Topological identity verification |
| POST | `/v1/identity/register` | Register agent identity |
| GET | `/v1/identity/lookup` | Lookup registered identity |
| POST | `/v1/identity/revoke` | Revoke agent identity |
| POST | `/v1/identity/challenge` | Issue identity challenge |
| GET | `/v1/identity/sybil-check` | Sybil-resistance check |
| POST | `/v1/threat/score` | Multi-vector threat score |
| POST | `/v1/threat/analyze` | Deep threat analysis |
| POST | `/v1/threat/report` | Report a threat incident |
| POST | `/v1/threat/block` | Block a threatening agent |
| GET | `/v1/threat/history` | Threat history for an agent |
| GET | `/v1/trust/decay` | Current trust ceiling value |
| POST | `/v1/trust/score` | Bounded trust score |
| GET | `/v1/trust/history` | Trust score history |

…and 89 more operations. They are listed in full on the page.

## Machine-readable artifacts (9)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/atomadic-tech/refs/heads/main/openapi/atomadic-tech-openapi.yml
- **OpenAPI** — https://atomadic.tech/openapi.json
- **Documentation** — https://atomadic.tech/quickstart
- **APIReference** — https://atomadic.tech/openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/atomadic-tech/refs/heads/main/overlays/atomadic-tech-openapi-overlay.yaml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/atomadic-tech/refs/heads/main/errors/atomadic-tech-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/atomadic-tech/refs/heads/main/data-model/atomadic-tech-data-model.yml
- **AgentCard** — https://raw.githubusercontent.com/api-evangelist/atomadic-tech/refs/heads/main/a2a/atomadic-tech-a2a.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/atomadic-tech/refs/heads/main/apis.yml

## Other Atomadic Tech APIs (1)

- [Atomadic MCP Server](https://apis.io/apis/atomadic-tech/atomadic-mcp-server/)

## Tags

AI Agents, Security, Trust, Escrow, Compliance, x402, Inference

---

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