Solrouter
API ReferenceSwaps

Submit fundingTxSig and start the swap orchestrator

After signing + broadcasting the funding tx from the one-shot session, submit its signature here to start the swap.

POST
/agents/v1/swaps/oneshot/{id}/execute

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/agents/v1/swaps/oneshot/b3d9a1e2-5c4f-4a8b-9e7d-1f2a3b4c5d6e/execute" \  -H "Content-Type: application/json" \  -d '{    "fundingTxSig": "5h7Qw2KQz9oA3nP1cVxYtRb8sLmJ4dE6fGh9kU2wXcZ1aBpQ7rT3vN5mY8sD0fL2gH4jK6lM9nP1qR3sT5uV7w"  }'
{
  "sessionId": "b3d9a1e2-5c4f-4a8b-9e7d-1f2a3b4c5d6e",
  "status": "running",
  "estimatedSeconds": 75
}
{
  "error": "missing_required_fields"
}
{
  "error": "missing_required_fields"
}

Begin a one-shot ephemeral-wallet private swap (Mode B)

Start a private swap that runs through a throwaway ephemeral wallet — no managed custody. Solrouter returns an unsigned `fundingTx`; the agent signs and broadcasts it, then calls `POST /swaps/oneshot/{id}/execute` to kick off the swap orchestrator.

Provision a managed Umbra wallet (Mode A)

Create a Solrouter-custodied Umbra wallet. The keypair is generated server-side and envelope-encrypted (AES-256-GCM) — the agent never holds private keys. Fund the returned `umbraAddress`, then run swaps and encrypted-balance operations against the wallet id.