# Aeternity Middleware API

**Canonical:** https://apis.io/apis/aeternity/aeternity-middleware-api/  
**Provider:** Aeternity — https://apis.io/providers/aeternity/  
**Base URL:** https://mainnet.aeternity.io/mdw/v3  
**Documentation:** https://docs.aeternity.com/aeternity-developer-tools/development-infrastructure/middleware

Aeternity Middleware API is one of 3 APIs that [Aeternity](https://apis.io/providers/aeternity/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification. Tagged areas include Blockchain, Layer 1, GraphQL, Developer Tools, and Distributed Ledger. The published artifact set on APIs.io includes an OpenAPI specification, an AsyncAPI specification, API documentation, an API reference, and a changelog.

ae_mdw, the æternity middleware (v1.108.2) — an indexing layer over the node exposing 76 unauthenticated REST operations for transactions, blocks, accounts, activities, AEX-9/AEX-141 tokens, DEX swaps, names and auctions, oracles, channels, transfers, wealth ranking and statistics, plus an open GraphQL endpoint (85 query fields, introspection enabled) and a WebSocket subscription stream for KeyBlocks, MicroBlocks, Transactions and per-object events.

## Operations (60 of 76)

| Method | Path | Summary |
|---|---|---|
| GET | `/accounts/{accountId}/activities` | — |
| GET | `/accounts/{accountId}/aex141/tokens` | — |
| GET | `/accounts/{accountId}/aex9/balances` | — |
| GET | `/accounts/{accountId}/dex/swaps` | — |
| GET | `/accounts/{accountId}/names/claims` | — |
| GET | `/accounts/{accountId}/names/pointees` | — |
| GET | `/accounts/{accountId}/transactions/count` | — |
| GET | `/aex141` | — |
| GET | `/aex141/{contractId}/templates` | — |
| GET | `/aex141/{contractId}/templates/{templateId}/tokens` | — |
| GET | `/aex141/{contractId}/tokens` | — |
| GET | `/aex141/{contractId}/tokens/{tokenId}` | — |
| GET | `/aex141/{contractId}/transfers` | — |
| GET | `/aex141/{id}` | — |
| GET | `/aex9` | — |
| GET | `/aex9/count` | — |
| GET | `/aex9/{contractId}/balances` | — |
| GET | `/aex9/{contractId}/balances/{accountId}` | — |
| GET | `/aex9/{contractId}/balances/{accountId}/history` | — |
| GET | `/aex9/{id}` | — |
| GET | `/channels` | — |
| GET | `/channels/{id}` | — |
| GET | `/contracts/calls` | — |
| GET | `/contracts/logs` | — |
| GET | `/contracts/{id}` | — |
| GET | `/dex/swaps` | — |
| GET | `/dex/{contract_id}/swaps` | — |
| GET | `/hyperchain/epochs` | — |
| GET | `/hyperchain/epochs/top` | — |
| GET | `/hyperchain/schedule` | — |
| GET | `/hyperchain/schedule/height/{height}` | — |
| GET | `/hyperchain/validators` | — |
| GET | `/hyperchain/validators/{validator}` | — |
| GET | `/hyperchain/validators/{validator}/delegates` | — |
| GET | `/hyperchain/validators/{validator}/delegates/top` | — |
| GET | `/key-blocks` | — |
| GET | `/key-blocks/{hash_or_kbi}` | — |
| GET | `/key-blocks/{hash_or_kbi}/micro-blocks` | — |
| GET | `/micro-blocks/{hash}` | — |
| GET | `/micro-blocks/{hash}/transactions` | — |
| GET | `/names` | — |
| GET | `/names/auctions` | — |
| GET | `/names/auctions/{id}` | — |
| GET | `/names/auctions/{id}/claims` | — |
| GET | `/names/count` | — |
| GET | `/names/{id}` | — |
| GET | `/names/{id}/claims` | — |
| GET | `/names/{id}/transfers` | — |
| GET | `/names/{id}/updates` | — |
| GET | `/oracles` | — |
| GET | `/oracles/{id}` | — |
| GET | `/oracles/{id}/extends` | — |
| GET | `/oracles/{id}/queries` | — |
| GET | `/oracles/{id}/responses` | — |
| GET | `/stats` | — |
| GET | `/stats/active-accounts` | — |
| GET | `/stats/aex9-transfers` | — |
| GET | `/stats/blocks` | — |
| GET | `/stats/contracts` | — |
| GET | `/stats/delta` | — |

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

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/openapi/aeternity-middleware-openapi.yml
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/graphql/aeternity-middleware.graphql
- **AsyncAPI** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/asyncapi/aeternity-middleware-websocket-asyncapi.yml
- **Documentation** — https://docs.aeternity.com/aeternity-developer-tools/development-infrastructure/middleware
- **APIReference** — https://mainnet.aeternity.io/mdw/swagger
- **ChangeLog** — https://github.com/aeternity/ae_mdw/blob/master/CHANGELOG.md
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/overlays/aeternity-middleware-overlay.yaml

## Other Aeternity APIs (2)

- [Aeternity Node API](https://apis.io/apis/aeternity/aeternity-node-api/)
- [Aeternity MCP Server](https://apis.io/apis/aeternity/aeternity-mcp-server/)

## Tags

Blockchain, Layer 1, GraphQL, Developer Tools, Distributed Ledger

---

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