Typical flow

1. GET /v1/chains and GET /v1/tokens — catalog

2. GET /v1/pairs — confirm a concrete direction (all four sides required)

3. GET /v1/pairs/search — list counterpart tokens for one side

4. GET /v1/quote — rates; each item has rateId (Redis snapshot, 5 minutes) and optional provider quoteId

5. POST /v1/swap — create the order; pass rateId to lock the shown quote; store transactionId + accessToken

6. GET /v1/transactions/{id} — poll status (id is the YiFi UUID from step 5)

7. POST /v1/transactions/{provider}/dex/set-deposit-hash?access_token= — after the user broadcasts a DEX deposit (once)