suwappu

Suwappu — Cross-Chain DEX API

Suwappu is a cross-chain DeFi API for AI agents: routed swaps, Hyperliquid market research, Polymarket prediction markets, and Morpho lending-market data — all over plain REST (curl/fetch), with optional TypeScript/Python SDKs and an MCP server for deeper tool integration.

This skill is API-first: every example is a curl call. Use it directly, or reach for the SDKs when you're already writing TS/Python and want typed methods instead of raw HTTP. Check the published registry version before relying on a source-only method; the repository can be ahead of npm/PyPI. REST + the live OpenAPI spec remain the compatibility baseline.

Non-custodial by design: Suwappu never holds signing authority over a self-custodied wallet end-to-end. Swap endpoints return an unsigned transaction; you sign and broadcast it with your own wallet. A separate managed wallet flow exists for agents that want the API to hold a Turnkey-secured key and execute server-side — see "Self-signed vs managed swaps" below.

1. Get an API key (self-register)

No signup UI needed — register directly:

curl -X POST https://api.suwappu.bot/v1/agent/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-agent"}'

Response (trimmed):

{
  "success": true,
  "agent": { "id": "...", "name": "my-agent", "api_key": "suwappu_sk_...", "created_at": "..." },
  "important": "SAVE YOUR API KEY! It cannot be retrieved later."
}

name must be 3-50 chars, alphanumeric plus _/-. Save api_key immediately — it is shown exactly once and cannot be recovered; if lost, register a new agent (or use POST /v1/agent/keys/rotate once authenticated).

Rate limit on registration itself: 5 requests per IP. If you're building on top of the TypeScript SDK, suwappu register --name my-agent --save does this and writes the key to ~/.config/suwappu/config.json for you.

2. Auth

Send the key on every authenticated request:

Authorization: Bearer suwappu_sk_...