Skip to main content

Changelog

Changes to the Developer API and to these developer docs, newest first.

Versioning​

The API version is part of the path: every endpoint is under /api/v1. Version 1 is the only version.

AchSwap has not published a formal deprecation schedule. What you can rely on today:

  • Additive changes (a new optional request field, a new response field) can ship within v1. Write your client to ignore response fields it doesn't know.
  • Breaking changes (a removed or renamed field, a changed meaning) are recorded here.
  • Error codes are the stable thing to branch on. Error messages may be reworded.
  • On-chain values are live. The AchSwap fee is reported in every response (fees.protocolBps): read it from the response, don't hard-code it.

If you depend on the API in production, email support@achswap.app so you can be told about changes directly.

API​

2026-10-02: v1 released​

  • POST /api/v1/quote and POST /api/v1/swap on Arc Mainnet (chain 5042), exact input, AchSwap routes executed on AchRouteExecutor 0x1B844738455b8060D12839331b35893526E9d314.
  • API keys in x-api-key or Authorization: Bearer.
  • Optional partner fee: feeBps (0 to 100) paid to feeRecipient in the output token, in the same transaction.
  • /swap transactions are simulated from the sender before they are returned.

No changes to the API since release.

Documentation​

2026-10-10​

2026-10-02​

  • First public Developer API page.