# Introduction

Welcome to the **Aurea API** — a backend platform for authentication, cross-chain wallet management, and multi-chain transaction processing. Aurea supports both **custodial wallets** (for regulated entities) and **non-custodial wallets** (for everyone), and is compatible with any blockchain network and token in the market upon request. Build powerful Web3 applications with a simple, REST-based interface.

- [Quick Start](https://docs.aureahub.com/docs/quickstart.md) — Register, get a token, and make your first API call in minutes.
- [Authentication](https://docs.aureahub.com/docs/authentication.md) — Learn how JWT bearer tokens and API keys work together.
- [Wallet Management](https://docs.aureahub.com/docs/wallets-create.md) — Create, import, and manage wallets across multiple blockchains.
- [Transactions](https://docs.aureahub.com/docs/tx-create.md) — Send native coins and tokens from custodial and non-custodial wallets, and track their status.

## Overview

The Aurea API (version `v0.1.0`) provides a comprehensive suite of endpoints organised into the following resource groups:

- **Auth** — Registration, login, token refresh, and Google OAuth
- **Users** — User profile management, search, and QR code generation
- **Wallets** — Custodial and non-custodial wallets across any blockchain, with cross-chain balance aggregation
- **Transactions** — Initiate and track cross-chain transactions across any supported network

## Base URL

Base URL https://api.aureahub.com/v1

All API endpoints are relative to this base URL and are fully documented in this reference — see the **API Reference** and **Agentic Payments** sections in the sidebar.

## Machine-Readable

Everything here exists in a form a program — or an agent writing your integration — can read directly:

- **The OpenAPI document**, served by the API itself and always exactly what the running version does: [`https://api.aureahub.com/v1/docs/json`](https://api.aureahub.com/v1/docs/json) ([YAML](https://api.aureahub.com/v1/docs/yaml), and a browsable UI at [/v1/docs](https://api.aureahub.com/v1/docs)). It is the reference for request and response shapes; these pages are the reference for what to do with them and why.
- **These pages as Markdown**, one file each, with an index in [`llms.txt`](https://docs.aureahub.com/llms.txt) and all of them in [`llms-full.txt`](https://docs.aureahub.com/llms-full.txt) ([llmstxt.org](https://llmstxt.org)). Any page's address with `.md` appended returns that page: `/docs/authentication.md`.

If you are pointing an assistant at Aurea, give it `llms.txt` and the OpenAPI URL together: the first says what exists and why, the second says exactly what to send.

## Supported Blockchains

The API is natively cross-chain. The networks listed below are available out of the box — any other blockchain or token in the market can be enabled upon request.

⟠ Ethereum ⬡ Polygon 🦉 Gnosis 🟡 BNB Chain 🔵 Arbitrum 🔴 Optimism 🔷 Base 🔺 Avalanche 🟢 Celo 🌊 Flow EVM ◎ Solana

> 💡 Need a chain or token not listed here? Aurea supports **any blockchain network and any token** existing in the market. Contact us to enable additional networks for your tenant.

## Rate Limiting

API requests are rate-limited. When you exceed the limit, the API returns a `429 Too Many Requests` response. Implement exponential back-off in your client for robust error handling.

---

Web version: https://docs.aureahub.com/#introduction