# Aeternity Node API

**Canonical:** https://apis.io/apis/aeternity/aeternity-node-api/  
**Provider:** Aeternity — https://apis.io/providers/aeternity/  
**Base URL:** https://mainnet.aeternity.io/v3  
**Documentation:** https://api-docs.aeternity.io/

Aeternity Node 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. Tagged areas include Blockchain, Layer 1, Smart Contracts, State Channels, and Oracles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

The public HTTP API of the æternity node (v7.3.0) — 79 unauthenticated operations covering chain and generation queries, transaction submission and inspection, account state and nonces, contract calls and dry-run, oracles, the æternity Naming System, state channels, node status/peers and node-operator endpoints. Every response carries an X-Ae-Height header naming the chain top the answer reflects.

## Operations (60 of 79)

| Method | Path | Summary |
|---|---|---|
| GET | `/accounts/{pubkey}` | — |
| GET | `/accounts/{pubkey}/hash/{hash}` | — |
| GET | `/accounts/{pubkey}/height/{height}` | — |
| GET | `/accounts/{pubkey}/next-nonce` | — |
| GET | `/accounts/{pubkey}/transactions/pending` | — |
| GET | `/auctions/{name}` | — |
| GET | `/channels/{pubkey}` | — |
| GET | `/contracts/{pubkey}` | — |
| GET | `/contracts/{pubkey}/code` | — |
| GET | `/contracts/{pubkey}/poi` | — |
| GET | `/currency` | — |
| POST | `/dry-run` | — |
| GET | `/generations/current` | — |
| GET | `/generations/hash/{hash}` | — |
| GET | `/generations/height/{height}` | — |
| GET | `/headers/top` | — |
| GET | `/hyperchain/pin-tx` | — |
| GET | `/hyperchain/contracts` | — |
| GET | `/key-blocks/current` | — |
| GET | `/key-blocks/current/hash` | — |
| GET | `/key-blocks/current/height` | — |
| GET | `/key-blocks/hash/{hash}` | — |
| GET | `/key-blocks/height/{height}` | — |
| GET | `/key-blocks/pending` | — |
| GET | `/micro-blocks/hash/{hash}/header` | — |
| GET | `/micro-blocks/hash/{hash}/transactions` | — |
| GET | `/micro-blocks/hash/{hash}/transactions/count` | — |
| GET | `/micro-blocks/hash/{hash}/transactions/index/{index}` | — |
| GET | `/names/{name}` | — |
| GET | `/names/hash/{name_hash}` | — |
| GET | `/oracles/{pubkey}` | — |
| GET | `/oracles/{pubkey}/queries` | — |
| GET | `/oracles/{pubkey}/queries/{query-id}` | — |
| GET | `/peers/pubkey` | — |
| GET | `/recent-gas-prices` | — |
| GET | `/node-settings` | — |
| GET | `/protocol-parameters` | — |
| GET | `/status` | — |
| GET | `/status/chain-ends` | — |
| GET | `/sync-status` | — |
| POST | `/transactions` | — |
| GET | `/transactions/{hash}` | — |
| GET | `/transactions/{hash}/info` | — |
| GET | `/debug/accounts/beneficiary` | — |
| GET | `/debug/accounts/node` | — |
| POST | `/debug/channels/close/mutual` | — |
| POST | `/debug/channels/close/solo` | — |
| POST | `/debug/channels/create` | — |
| POST | `/debug/channels/deposit` | — |
| GET | `/debug/channels/fsm-count` | — |
| POST | `/debug/channels/set-delegates` | — |
| POST | `/debug/channels/settle` | — |
| POST | `/debug/channels/slash` | — |
| POST | `/debug/channels/snapshot/solo` | — |
| POST | `/debug/channels/withdraw` | — |
| GET | `/debug/check-tx/pool/{hash}` | — |
| POST | `/debug/contracts/call` | — |
| POST | `/debug/contracts/create` | — |
| GET | `/debug/crash` | — |
| POST | `/debug/names/claim` | — |

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

## Machine-readable artifacts (10)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/openapi/aeternity-node-openapi.yml
- **Documentation** — https://docs.aeternity.com/aeternity-developer-tools/development-infrastructure/sdks-and-apis/node-api-reference
- **APIReference** — https://api-docs.aeternity.io/
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/authentication/aeternity-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/conventions/aeternity-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/conventions/aeternity-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/errors/aeternity-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/data-model/aeternity-data-model.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/overlays/aeternity-node-overlay.yaml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/apis.yml

## Other Aeternity APIs (2)

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

## Tags

Blockchain, Layer 1, Smart Contracts, State Channels, Oracles, Naming System

---

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