> For the complete documentation index, see [llms.txt](https://docs.yifi.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yifi.io/api-reference/typical-flow.md).

# 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)