# satohub-ai Swap API

**Canonical:** https://apis.io/apis/satohub-ai/satohub-ai-swap-api/  
**Provider:** satohub-ai — https://apis.io/providers/satohub-ai/  
**Base URL:** https://satohub.ai  
**Documentation:** https://satohub.ai/docs/api

satohub-ai Swap API is one of 21 APIs that [satohub-ai](https://apis.io/providers/satohub-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include swap. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Sato Swap. One call chooses the venue, discloses that venue's own fee sentence verbatim, checks four targets — both tokens, the venue endpoint and the recipient — against the caller's policy, simulates the transaction, and then returns either a recommendation or an UNSIGNED transaction. NON-CUSTODIAL: nothing in this tag holds a key, signs, or broadcasts. UNKNOWN REFUSES BY DEFAULT and every refusal names the rule and the reading that produced it, so "we did not check" and "we checked and it is fine" never look alike. A refusal arrives as HTTP 200 carrying `withheld.reason`: it is an answer, not a failure, and retrying it unchanged will refuse again. A recipient with no Agent Passport is `no_record` — the ordinary case, never a finding against the address — and there is no list of trusted counterparties here. Receipts record what was checked; they are never a claim a trade filled, and they are never summed into volume.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/token/resolve` | What an address, a mint or a link is |
| POST | `/api/swap/quote` | Quote a swap, check it against a policy, and return an unsigned transaction |
| GET | `/api/swap/receipts/{id}` | The public record of one swap decision |
| GET | `/api/swap/policies` | The swap policies bound to the calling subject |
| POST | `/api/swap/policies` | Store a swap policy (a new version; the previous one is revoked) |
| DELETE | `/api/swap/policies` | Revoke one policy |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/satohub-ai/openapi/satohub-ai-swap-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-version-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-interpretation-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-needs-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-scan-recipient-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-token-resolve-schema.json
- **JSONSchema** — https://artifacts.apis.io/satohub-ai/json-schema/satohub-ai-swap-receipt-schema.json

## Other satohub-ai APIs (12)

- [satohub-ai Agent Economy API](https://apis.io/apis/satohub-ai/satohub-ai-agent-economy-api/)
- [satohub-ai Badges API](https://apis.io/apis/satohub-ai/satohub-ai-badges-api/)
- [satohub-ai Check API](https://apis.io/apis/satohub-ai/satohub-ai-check-api/)
- [satohub-ai Claims API](https://apis.io/apis/satohub-ai/satohub-ai-claims-api/)
- [satohub-ai Create API](https://apis.io/apis/satohub-ai/satohub-ai-create-api/)
- [satohub-ai Directory API](https://apis.io/apis/satohub-ai/satohub-ai-directory-api/)
- [satohub-ai Erc8004 API](https://apis.io/apis/satohub-ai/satohub-ai-erc8004-api/)
- [satohub-ai Listings API](https://apis.io/apis/satohub-ai/satohub-ai-listings-api/)
- [satohub-ai Preflight API](https://apis.io/apis/satohub-ai/satohub-ai-preflight-api/)
- [satohub-ai Projects API](https://apis.io/apis/satohub-ai/satohub-ai-projects-api/)
- [satohub-ai Registry API](https://apis.io/apis/satohub-ai/satohub-ai-registry-api/)
- [satohub-ai Resolve API](https://apis.io/apis/satohub-ai/satohub-ai-resolve-api/)

## Tags

swap

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/satohub-ai/satohub-ai-swap-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/satohub-ai/.