# GhostSwap Partners API

> Server-to-server crypto-to-crypto exchange API by GhostSwap. Bearer auth, idempotent swap creation, polled status lifecycle. GhostSwap manages liquidity routing so partners never handle signing keys.

## About GhostSwap

GhostSwap (https://ghostswap.io) is a no-KYC, non-custodial crypto exchange. Users send funds to a deposit address; the destination wallet receives the swapped funds in a different cryptocurrency. GhostSwap routes liquidity, handles signing, and manages clearing — partners never custody user funds and never hold signing keys.

The Partners API lets wallets, exchanges, fintech apps, and affiliate sites add this swap functionality to their products and earn revenue:

- **1,600+ coins** supported across major chains (Bitcoin, Ethereum, Solana, Tron, BSC, Polygon, Arbitrum, Optimism, Base, Avalanche, Litecoin, XRP, Cardano, Cosmos, and many more)
- **Partner fee 0–4%** set by each partner at application time, paid on every completed swap
- **USDT payouts** with a $100 minimum threshold, on TRC-20 by default (ERC-20 available)
- **No KYC** for end-users on standard volume — the partner integrates with a simple Bearer token and end-users transact directly
- **Float and fixed-rate** swaps (float settles at market, fixed locks the rate for ~60 seconds)
- **Open-source agent pack** at https://github.com/ghostswap1/ghostswap-agents — MCP server, OpenAPI 3.1 spec, Anthropic Agent Skill, AGENTS.md, and Cursor/Copilot/Windsurf project rules

## AI agent / LLM surfaces

- [skill.md](https://partners.ghostswap.io/skill.md): Anthropic Agent Skill (YAML frontmatter + markdown) — installable into Claude Code, Claude Desktop, claude.ai, or any Agent SDK
- [openapi.json](https://partners-api.ghostswap.io/openapi.json) / [openapi.yaml](https://partners-api.ghostswap.io/openapi.yaml): OpenAPI 3.1 spec — drop the URL into ChatGPT GPT Actions, LangChain OpenAPIToolkit, LlamaIndex RestAPIToolkit, or any function-calling agent
- [@ghostswap/mcp](https://www.npmjs.com/package/@ghostswap/mcp): Model Context Protocol server — `npx -y @ghostswap/mcp` from Claude Desktop, Cursor, Windsurf, Continue.dev, OpenAI Agents SDK, Vercel AI SDK, or any MCP client
- [ghostswap-agents](https://github.com/ghostswap1/ghostswap-agents): full agent pack repo with AGENTS.md, .cursor/rules, .github/copilot-instructions, .windsurfrules, GPT Action setup guide, and the source for all of the above

## Get started

- [Introduction](https://partners.ghostswap.io/docs): overview of the API and integration model
- [Quickstart](https://partners.ghostswap.io/docs/quickstart): five-step walkthrough from credential to live swap

## Authentication

- [Bearer auth & keys](https://partners.ghostswap.io/docs/auth): credential format, issuance, rotation, security

## API Reference

- [GET /v1/currencies](https://partners.ghostswap.io/docs/api/currencies): list enabled currencies (full or lite)
- [GET /v1/pairs](https://partners.ghostswap.io/docs/api/pairs): min/max for a single pair
- [POST /v1/addresses/validate](https://partners.ghostswap.io/docs/api/addresses): validate a wallet address
- [POST /v1/quotes](https://partners.ghostswap.io/docs/api/quotes): get a swap quote with user-receive amount
- [Swaps endpoints](https://partners.ghostswap.io/docs/api/swaps): create, get, list swaps

## Concepts

- [Commissions](https://partners.ghostswap.io/docs/concepts/commissions): partner fee model, splits, settlement
- [Idempotency](https://partners.ghostswap.io/docs/concepts/idempotency): safe-retry semantics for swap creation
- [Rate limits](https://partners.ghostswap.io/docs/concepts/rate-limits): 30 RPS per credential, backoff strategy
- [Status lifecycle](https://partners.ghostswap.io/docs/concepts/status-lifecycle): all 10 statuses and transitions
- [Errors](https://partners.ghostswap.io/docs/concepts/errors): envelope, types, recovery

## Guides

- [End-to-end swap](https://partners.ghostswap.io/docs/guides/end-to-end-swap): full reference implementation
- [Troubleshooting](https://partners.ghostswap.io/docs/guides/troubleshooting): real failure modes integrators have hit and how to debug
- [Security](https://partners.ghostswap.io/docs/guides/security): credential handling and monitoring

## Optional

- [Roadmap](https://partners.ghostswap.io/docs/roadmap): what's coming next
- [skill.md](https://partners.ghostswap.io/skill.md): Anthropic Agent Skill (YAML-frontmatter markdown) — installable into Claude or any Agent SDK
- [openapi.json](https://partners-api.ghostswap.io/openapi.json): OpenAPI 3.1 spec — paste into ChatGPT GPT Actions, LangChain OpenAPIToolkit, LlamaIndex, openapi-generator SDKs, etc.
- [openapi.yaml](https://partners-api.ghostswap.io/openapi.yaml): same spec, YAML format
- [llms-full.txt](https://partners.ghostswap.io/llms-full.txt): every doc page concatenated for direct context-stuffing

_Total: 17 doc pages. Generated from https://partners.ghostswap.io_