> ## Documentation Index
> Fetch the complete documentation index at: https://docs.moneda.com/llms.txt
> Use this file to discover all available pages before exploring further.

# REST API

> Overview of the Moneda REST API for agents and developers

The Moneda REST API provides standard HTTP endpoints that mirror the functionality of the MCP tools. If you prefer working with REST over MCP, or need to integrate Moneda into a backend service, the REST API is for you.

## What is the REST API?

The REST API covers everything available through MCP plus a few REST-only operations (sessions, sub-account reads). Anything you can do with an AI assistant you can also do with a simple HTTP request.

<Info>
  The REST API uses the same OAuth 2.0 tokens as MCP, so you don't need separate credentials.
</Info>

## Base URL

All API requests are made to:

```
https://api.moneda.com/v1
```

## Key features

* **Standard HTTP** — Use any language or HTTP client. No MCP SDK required.
* **Same authentication** — OAuth 2.0 Bearer tokens from the MCP auth flow work directly.
* **OpenAPI spec** — Machine-readable spec at `/v1/openapi.json` for code generation.
* **Interactive docs** — Swagger UI at `/v1/docs` for exploring and testing endpoints.
* **JSON responses** — All responses are returned in JSON format.

## Quick example

```bash theme={null}
curl -X GET https://api.moneda.com/v1/balances \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```json theme={null}
{
  "balances": [
    { "currency": "USD", "balance": "1250.00" },
    { "currency": "EUR", "balance": "830.50" }
  ]
}
```

## What's next?

<CardGroup cols={2}>
  <Card title="Authentication" icon="lock" href="/api/authentication">
    Learn how to authenticate your API requests.
  </Card>

  <Card title="API Endpoints" icon="list" href="/api/endpoints">
    Browse the complete list of REST endpoints by domain.
  </Card>

  <Card title="OpenAPI Spec" icon="file-code" href="/api/openapi">
    Use the OpenAPI spec to generate client SDKs.
  </Card>

  <Card title="CLI Tool" icon="terminal" href="/cli/overview">
    Prefer the command line? Try the Moneda CLI.
  </Card>
</CardGroup>