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

# Get Quote

[Swagger UI](https://swagger.blockz.fi/swagger/index.html)

Retrieve the best available RFQ quote for a given source token, destination token, and amount.

This endpoint returns pricing details, execution constraints, and metadata required to create an intent.

Quotes are time-bound and must be executed before expiry.

```http
POST /affiliate/v1/quotes/best
```

#### Request

**Request example:**

```json
{
  "source_chain": 1,
  "source_token": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "dest_chain": 4,
  "dest_token": "So11111111111111111111111111111111111111112",
  "amount": 100,
  "slippage_bps": "50",
  "swap_type": "standard",
  "retail_user_id": "fe5601fb-60f2-4cb0-8a67-c55bd3640411"
}
```

#### Notes

* `amount` must be specified in decimal-adjusted format.
* `slippage_bps` is expressed in basis points and must be sent as a string.
* `retail_user_id` is optional and can be used for analytics and user-level tracking.

***

#### Response

Response example:

```json
{
    "id": "bea66e69-64c3-4b88-96ac-29f1ce7d454d",
    "source_chain": 1,
    "source_token": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "dest_chain": 4,
    "dest_token": "So11111111111111111111111111111111111111112",
    "intermediate_token": null,
    "intermediate_token_amount_min": null,
    "intermediate_token_amount_max": null,
    "intermediate_token_decimals": null,
    "source_amount_lots": "100000000",
    "source_amount_decimals": 6,
    "min_dest_amount_lots": "857382336",
    "max_dest_amount_lots": "861690790",
    "dest_amount_decimals": 9,
    "slippage_bps": "50",
    "expiry": 1769777954084,
    "swap_type": "standard"
}
```

#### Quote Expiry

* The `expiry` field is a Unix timestamp in milliseconds (ms since epoch).
* After this timestamp, the quote is no longer valid and must be refreshed.
* Execution must occur before expiry to preserve quoted pricing.

#### Intermediate Token Routing

If the user attempts to swap a volatile token, the system may automatically route the swap through a highly liquid intermediate token, typically USDC, to improve execution reliability and manage price volatility.

All fields prefixed with `intermediate_` describe this routing behavior and the token used internally.