# Aeternity External API

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

Aeternity External API is one of 18 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 External. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, an AsyncAPI specification, and a changelog.

## Operations (43)

| Method | Path | Summary |
|---|---|---|
| GET | `/accounts/{pubkey}` | Get account by pubkey |
| GET | `/accounts/{pubkey}/hash/{hash}` | Get account by pubkey and hash |
| GET | `/accounts/{pubkey}/height/{height}` | Get account by pubkey and height |
| GET | `/accounts/{pubkey}/next-nonce` | Get account next nonce |
| GET | `/accounts/{pubkey}/transactions/pending` | Get pending account transactions by pubkey |
| GET | `/auctions/{name}` | Get auction entry by name |
| GET | `/channels/{pubkey}` | Get channel by pubkey |
| GET | `/contracts/{pubkey}` | Get contract |
| GET | `/contracts/{pubkey}/code` | Get contract code |
| GET | `/contracts/{pubkey}/poi` | Get contract po I |
| GET | `/currency` | Get currency |
| POST | `/dry-run` | Protected dry run txs |
| GET | `/generations/current` | Get current generation |
| GET | `/generations/hash/{hash}` | Get generation by hash |
| GET | `/generations/height/{height}` | Get generation by height |
| GET | `/headers/top` | Get top header |
| GET | `/hyperchain/pin-tx` | Get pinning tx |
| GET | `/hyperchain/contracts` | Get hyperchain contract pubkeys |
| GET | `/key-blocks/current` | Get current key block |
| GET | `/key-blocks/current/hash` | Get current key block hash |
| GET | `/key-blocks/current/height` | Get current key block height |
| GET | `/key-blocks/hash/{hash}` | Get key block by hash |
| GET | `/key-blocks/height/{height}` | Get key block by height |
| GET | `/key-blocks/pending` | Get pending key block |
| GET | `/micro-blocks/hash/{hash}/header` | Get micro block header by hash |
| GET | `/micro-blocks/hash/{hash}/transactions` | Get micro block transactions by hash |
| GET | `/micro-blocks/hash/{hash}/transactions/count` | Get micro block transactions count by hash |
| GET | `/micro-blocks/hash/{hash}/transactions/index/{index}` | Get micro block transaction by hash and index |
| GET | `/names/{name}` | Get name entry by name |
| GET | `/names/hash/{name_hash}` | Get name entry by name hash |
| GET | `/oracles/{pubkey}` | Get oracle by pubkey |
| GET | `/oracles/{pubkey}/queries` | Get oracle queries by pubkey |
| GET | `/oracles/{pubkey}/queries/{query-id}` | Get oracle query by pubkey and query id |
| GET | `/peers/pubkey` | Get peer pubkey |
| GET | `/recent-gas-prices` | Get recent gas prices |
| GET | `/node-settings` | Get node settings |
| GET | `/protocol-parameters` | Get protocol parameters |
| GET | `/status` | Get status |
| GET | `/status/chain-ends` | Get chain ends |
| GET | `/sync-status` | Get sync status |
| POST | `/transactions` | Post transaction |
| GET | `/transactions/{hash}` | Get transaction by hash |
| GET | `/transactions/{hash}/info` | Get transaction info by hash |

## Machine-readable artifacts (13)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/aeternity/refs/heads/main/openapi/aeternity-external-api-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
- **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

## Other Aeternity APIs (12)

- [Aeternity MCP Server](https://apis.io/apis/aeternity/aeternity-mcp-server/)
- [Aeternity Accounts API](https://apis.io/apis/aeternity/aeternity-accounts-api/)
- [Aeternity Aex141 API](https://apis.io/apis/aeternity/aeternity-aex141-api/)
- [Aeternity Aex9 API](https://apis.io/apis/aeternity/aeternity-aex9-api/)
- [Aeternity Channels API](https://apis.io/apis/aeternity/aeternity-channels-api/)
- [Aeternity Contracts API](https://apis.io/apis/aeternity/aeternity-contracts-api/)
- [Aeternity Dex API](https://apis.io/apis/aeternity/aeternity-dex-api/)
- [Aeternity Hyperchain API](https://apis.io/apis/aeternity/aeternity-hyperchain-api/)
- [Aeternity Internal API](https://apis.io/apis/aeternity/aeternity-internal-api/)
- [Aeternity Key Blocks API](https://apis.io/apis/aeternity/aeternity-key-blocks-api/)
- [Aeternity Micro Blocks API](https://apis.io/apis/aeternity/aeternity-micro-blocks-api/)
- [Aeternity Names API](https://apis.io/apis/aeternity/aeternity-names-api/)

## Tags

External

---

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