> For the complete documentation index, see [llms.txt](https://docs.viperexecution.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.viperexecution.com/api/overview.md).

# v1 API

The Viper Execution v1 API: what it covers, how requests are authenticated, the Python SDK, and where account holders find the full reference.

Everything the interface can do, your code can do. The v1 API runs the same execution algorithms, trade monitors, execution baskets and account tools as the terminal, against the same engine, under a versioned `/v1/` path — REST for requests, WebSocket for live data and control.

## Base URL

```
https://api.viperexecution.com
```

## Authentication

Every request is signed with HMAC-SHA256 using an API key you create yourself in the app under **Settings → API Keys**. Keys are scoped — `read`, `trade` or `algo` — and carry an optional IP allowlist. Errors return machine-readable codes in a structured envelope; writes are idempotent.

## Python SDK

```bash
pip install viper-execution
```

A typed async REST client and a resilient WebSocket client over the v1 surface — signing, idempotency keys, typed errors and reconnect handling taken care of, with every response returned as a plain `dict`. Four quickstart examples ship in the package; run `viper-examples` to list them. Source on [GitHub](https://github.com/viperexecution/viper-sdk-python) · package on [PyPI](https://pypi.org/project/viper-execution/).

## Full reference for account holders

The complete developer material lives in the app under **API**, for account holders:

* **REST reference** — every endpoint and model across account, positions and leverage, orders and fills, execute and executions, monitors, webhooks, baskets and market data, with request and response examples.
* **Streams** — the two-way WebSocket protocol: subscribe to account, execution, monitor, basket and TP/SL channels, and place orders, launch and control algorithms and baskets over the same connection — not a read-only feed.
* **Authentication guide** — key creation, signing, scopes, idempotency and rate limits, with reference implementations.
* **Runnable examples** — the full set covering every algorithm, TP/SL and trailing exits, monitors, baskets, streaming and trading over the socket, each a standalone file you copy and run.

→ [app.viperexecution.com/developers](https://app.viperexecution.com/developers)

Create an account, sign in, and the reference is one click from the main navigation.