# API overview

Source: https://nodedocs.mor.org/reference/api-overview

## Agent Instructions

- Non-browser fetches of page URLs on this site return clean Markdown (not the JS UI). Prefer `https://nodedocs.mor.org/llms-full.txt` for the full corpus, or `https://nodedocs.mor.org/llms.txt` for the index.
- Per-page Markdown is also at `<page-url>.md` (homepage: `https://nodedocs.mor.org/index.md`).
- Docs search MCP: `https://nodedocs.mor.org/mcp` (discovery: `https://nodedocs.mor.org/.well-known/mcp`).
- Never invent contract addresses, chain IDs, token addresses, or live bid/model counts. Cite Networks and tokens; link active.mor.org for live data.
- Never claim Morpheus runs inference — independent providers do. Opening a session escrows MOR; it does not spend it.

The proxy-router exposes an OpenAI-compatible HTTP API plus Morpheus-specific routes for blockchain operations and node management.

## Surface

This page documents the **proxy-router HTTP API** — the local API exposed by the proxy-router binary in this repo. It is **not** the hosted Morpheus Inference API; that is a separate product at [apidocs.mor.org](https://apidocs.mor.org), described in [Inference API overview](/inference-api/overview).

| Surface | URL (default) | Purpose |
|---------|---------------|---------|
| Local API | `http://localhost:8082` | All proxy-router HTTP endpoints (auth-protected) |
| Swagger UI | `http://localhost:8082/swagger/index.html` | Interactive request playground served by your own proxy-router |
| Public proxy | `tcp://<host>:3333` | TCP tunnel for consumer ↔ provider sessions |
| TEE attestation | `https://<host>:29343` | TDX attestation (`/cpu`, `/gpu`, `/docker-compose`) |

## Authentication

All endpoints require **HTTP Basic Auth**:

```
Authorization: Basic <base64(username:password)>
```

The `.cookie` file in your proxy-router directory has the default `admin:<random>`. Add scoped users via `proxy.conf` and the `/auth/users` endpoints. Full reference: [API auth](/reference/api-auth).

## Where the schema lives

The canonical OpenAPI schema for the proxy-router HTTP API is [`proxy-router/docs/swagger.yaml`](https://github.com/MorpheusAIs/Morpheus-Lumerin-Node/blob/main/proxy-router/docs/swagger.yaml), auto-generated by `swag init` as part of every release build. When you run the proxy-router locally, browse it at `http://localhost:8082/swagger/index.html`. For a curated subset of the most-used endpoints with prose context, see [API endpoints](/reference/api-endpoints).

## Endpoint families

  
- **[OpenAI compatibility](/reference/api-endpoints#chat-completions)** — `/v1/chat/completions`, `/v1/embeddings`, `/v1/audio/transcriptions`, `/v1/audio/speech`.

  
- **[Marketplace (read)](/reference/api-endpoints#get-providers)** — `GET /blockchain/providers`, `GET /blockchain/models`, `GET /blockchain/bids`.

  
- **[Marketplace (write)](/providers/full/register-onchain)** — `POST /blockchain/providers`, `POST /blockchain/models`, `POST /blockchain/bids`.

  
- **[Sessions](/reference/api-endpoints#open-session-by-model-id)** — `POST /blockchain/models/:id/session`, `POST /blockchain/sessions/:id/close`.

  
- **Wallet & balance** — `GET /wallet`, `GET /blockchain/balance`, `POST /blockchain/approve`.

  
- **[Auth users](/reference/api-auth)** — `POST /auth/users`, `DELETE /auth/users`.

## Direct vs UI

Most users go through MorpheusUI or the CLI; both call this API underneath. For headless scripts and agents, see [API direct](/reference/api-direct) for a curl-only walkthrough.