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

# SDKs & Tools

Every official way to connect to the Nexus Exchange, the Rust, TypeScript, Python and Go SDKs, the CLI, the MCP server and agent skills, with the repository and install line for each.

Every interface below calls the same [OpenAPI contract](https://github.com/nexus-xyz/nexus-exchange-api), is open source under [`nexus-xyz`](https://github.com/nexus-xyz) on GitHub, and targets testnet when you name no network. Authentication, [rate limits](/api-reference/guides/rate-limits.md) and [networks](/api-reference/guides/networks.md) work the same way whichever you pick.

|          | Interface     | Repository                                                                        | Install                                                           |
| -------- | ------------- | --------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| SDK      | Rust          | [`nexus-exchange-rs`](https://github.com/nexus-xyz/nexus-exchange-rs)             | `cargo add nexus-exchange`                                        |
| SDK      | TypeScript    | [`nexus-exchange-ts`](https://github.com/nexus-xyz/nexus-exchange-ts)             | `npm install @nexus-xyz/exchange-ts`                              |
| SDK      | Python        | [`nexus-exchange-py`](https://github.com/nexus-xyz/nexus-exchange-py)             | `pip install nexus-exchange`                                      |
| SDK      | Go            | [`nexus-exchange-go`](https://github.com/nexus-xyz/nexus-exchange-go)             | `go get github.com/nexus-xyz/nexus-exchange-go@latest`            |
| CLI      | `nexus`       | [`nexus-exchange-cli`](https://github.com/nexus-xyz/nexus-exchange-cli)           | `curl https://cli.nexus.xyz \| sh`                                |
| Agents   | MCP server    | [`nexus-exchange-mcp`](https://github.com/nexus-xyz/nexus-exchange-mcp)           | `claude mcp add nexus-exchange -- npx -y @nexus-xyz/exchange-mcp` |
| Agents   | Agent skills  | [`nexus-exchange-skills`](https://github.com/nexus-xyz/nexus-exchange-skills)     | `/plugin marketplace add nexus-xyz/nexus-exchange-skills`         |
| Examples | Runnable apps | [`nexus-exchange-examples`](https://github.com/nexus-xyz/nexus-exchange-examples) | Clone, then follow each app's README                              |

Each repository's README is the reference for its interface: version support, breaking-change policy and the full surface it wraps.

## SDKs

| Language   | Use it for                                       | Status                                                                 |
| ---------- | ------------------------------------------------ | ---------------------------------------------------------------------- |
| Rust       | Latency-sensitive clients and market-making bots | In production use. Nexus's own market makers trade through it          |
| TypeScript | Web, Node, and edge applications                 | Experimental. Wraps every public operation of its pinned spec          |
| Python     | Research, backtesting, and scripting             | Experimental. A subset of the surface, listed in its README            |
| Go         | Services and trading infrastructure in Go        | Experimental. No release tagged yet, so `@latest` is the tip of `main` |

Each SDK handles request signing (HMAC or agent key), pagination, and the WebSocket subscription lifecycle so you don't reimplement them. For what signing costs in each SDK, and whether it keeps up with your tier, see [signing cost by SDK](/api-reference/guides/rate-limits.md#can-your-signer-keep-up).

## Command line

The [`nexus-exchange-cli`](https://github.com/nexus-xyz/nexus-exchange-cli) wraps the same API for interactive use and shell scripting. It manages keys, places and cancels orders, streams the WebSocket, and queries account state without you writing code. It is a thin layer over the Rust SDK, and `nexus --version` reports the API spec and SDK versions it is built against.

```sh
# macOS + Linux
curl https://cli.nexus.xyz | sh
```

```powershell
# Windows
irm https://cli.nexus.xyz | iex
```

## For agents

The [`nexus-exchange-mcp`](https://github.com/nexus-xyz/nexus-exchange-mcp) server exposes the Exchange as [Model Context Protocol](https://modelcontextprotocol.io) tools, so an AI assistant or agent can trade and read account state through the same authenticated API a human client uses. It is published as [`@nexus-xyz/exchange-mcp`](https://www.npmjs.com/package/@nexus-xyz/exchange-mcp):

```bash
claude mcp add nexus-exchange -- npx -y @nexus-xyz/exchange-mcp
```

It runs over stdio, so credentials stay on the machine that adds it, and its public market-data tools work with no key at all.

The [`nexus-exchange-skills`](https://github.com/nexus-xyz/nexus-exchange-skills) repository teaches an agent *how* to use the Exchange safely, in the [Agent Skills](https://agentskills.io) format: getting started, trading, reading portfolio risk, and troubleshooting. In Claude Code, one plugin installs the skills and the MCP server together:

```
/plugin marketplace add nexus-xyz/nexus-exchange-skills
/plugin install nexus-exchange@nexus-exchange
```

An agent that reads [`llms.txt`](https://nexus.xyz/llms.txt) finds every interface on this page from there.

## Next

[Get Started](/api-reference/guides/get-started.md) walks through a first authenticated request, and [Authentication](/api-reference/guides/authentication.md) covers the credential every interface above signs with.

> **Status:** development preview on testnet. The interfaces track the OpenAPI spec release-by-release; pin to a spec version in production and consult each repository's release notes before upgrading. Testnet credentials and balances have no real-world value.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.nexus.xyz/api-reference/guides/sdks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.