Skip to main content
The Moneda REST API publishes a machine-readable OpenAPI 3.1 specification. You can use it to explore the API interactively, generate client libraries, or import endpoints into your favorite API tool.

Live specification

The OpenAPI spec is always up to date and available at:
The same document is also served at the unversioned root, which is where most agent tooling and API scanners look:

What the specification describes

The spec is written to be consumed by agents and function-calling tools as well as by people:
  • Stable operation names. Every operation has a unique snake_case operationId such as get_balance or initiate_payment. Where an MCP tool does the same thing, the operationId is the tool name, so the same function name works on both surfaces.
  • Summaries and descriptions. Every operation has a one-line summary and a description of what it does and what to expect.
  • Server URL. The servers array points at https://rest.moneda.com.
  • Scopes. The OAuth2 security scheme lists every scope the API uses, and each operation lists the scopes it requires. Operations that an API key can also call list ApiKey with the same scopes. Public operations have an empty security list.

OAuth discovery

The API publishes OAuth 2.0 Protected Resource Metadata (RFC 9728), so a client can find the authorization server and the supported scopes without reading documentation:
A 401 response points to the same document in its WWW-Authenticate header.

Swagger UI

For interactive exploration, open the Swagger UI in your browser:
From there you can browse every endpoint, see request and response schemas, and make test requests with your token.
Click the “Authorize” button in Swagger UI and paste your OAuth Bearer token to make authenticated requests directly from the browser.

Using with API tools

Postman

  1. Open Postman and click Import
  2. Enter the URL: https://rest.moneda.com/v1/openapi.json
  3. Postman will create a collection with all 179 endpoints
  4. Set the Authorization header to Bearer <your-token> at the collection level

Insomnia

  1. Go to Application > Preferences > Data > Import Data
  2. Choose From URL and enter: https://rest.moneda.com/v1/openapi.json
  3. All endpoints will be imported into a new workspace

Bruno

  1. Open Bruno and go to Collection > Import
  2. Select OpenAPI V3 and paste the spec URL
  3. Configure your Bearer token in the collection’s auth settings

Generating client SDKs

Use OpenAPI Generator to create a typed client in your language of choice:
Generated clients handle request serialization, response parsing, and type checking automatically. You still need to provide your OAuth token for authentication.

What’s next?

API Overview

Learn the basics of the Moneda REST API.

API Endpoints

Browse all 179 endpoints with descriptions and scopes.

Authentication

Set up your OAuth token for API access.

CLI Tool

Use the Moneda CLI for quick command-line access.