> For the complete documentation index, see [llms.txt](https://developer.esw.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/overview.md).

# Overview

The Pricing Advisor API provides pricing data for ESW delivery countries. Apply the pricing formula to calculate product prices in the shopper’s currency. The response includes FX rates, estimated duties, taxes, retailer adjustments, and other data needed for accurate checkout pricing.

FX rates update daily from trusted sources. Configurable rounding models let you control displayed prices.

Use the API to tailor pricing by market, account for local duties and taxes, and protect competitive margins.

## Pricing Advisor 4.0 <a href="#learn-more-about-the-pricing-advisor-api" id="learn-more-about-the-pricing-advisor-api"></a>

{% tabs %}
{% tab title="Pricing Advisor v4.0" %}
Use to get FX rates, estimated duties, estimated taxes, estimated fees, retailer adjustments, rounding models, and pricing models.
{% endtab %}
{% endtabs %}

<table data-card-size="large" data-card-wrap="false" data-view="cards"><thead><tr><th align="center"></th><th align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-cover-dark data-type="image">Cover image (dark)</th></tr></thead><tbody><tr><td align="center"><strong>Fully Landed Cost</strong></td><td align="center">Prices include duties and taxes, calculated<br>accurately for the shopper's region.​</td><td><a href="/files/JC96NQwa14qNlzKb63RL">/files/JC96NQwa14qNlzKb63RL</a></td><td><a href="/files/vFilVT6LrYUGQjdfER79">/files/vFilVT6LrYUGQjdfER79</a></td></tr><tr><td align="center"><strong>Local Currency Pricing</strong></td><td align="center">Shopper’s preferred<br>currency, rounding in line with retailer preferences.​</td><td><a href="/files/yA8gFdwNaFi6YzqOVfQ1">/files/yA8gFdwNaFi6YzqOVfQ1</a></td><td><a href="/files/o8F85STFjaWyMk1VSRVq">/files/o8F85STFjaWyMk1VSRVq</a></td></tr></tbody></table>

### `currencyDisplays`

{% tabs %}
{% tab title="v4.0" %}
The `currencyDisplays` object in the response contains the following:

{% code expandable="true" %}

```json
"currencyDisplays": [
  {
    "currencyIso": "AUD",
    "currencySymbol": "$",
    "currencyExponent": 2,
    "decimalSeparator": ".",
    "thousandSeparator": ",",
    "showTrailingZeros": true,
    "configurationString": "[Number][ExponentSeparator][Exponent] [CurrencyISO]"
  },
  {
    "currencyIso": "EUR",
    "currencySymbol": "€",
    "currencyExponent": 2,
    "decimalSeparator": ".",
    "thousandSeparator": ",",
    "showTrailingZeros": true,
    "configurationString": "[Number][ExponentSeparator][Exponent] [CurrencyISO]"
  }
]
```

{% endcode %}
{% endtab %}
{% endtabs %}

### `roundingModels`

{% tabs %}
{% tab title="v4.0" %}
The `roundingModels` object contains the rounding configuration that applies to each delivery country.

Pricing Advisor API v4.0 supports the following rounding models:

* Fixed
* None
* Multiple

The `model` value is split into two rules:

* The rule before the period applies to the whole number.
* The rule after the period applies to the decimal part.

For example, in `multiple50.fixed00`, `multiple50` rounds the whole number and `fixed00` sets the decimal part to `00`.

The decimal rule is applied first. The whole-number rule is applied second.

For example:

{% code expandable="true" %}

```json
"roundingConfigurations": [
  {
    "currencyIso": "AUD",
    "currencyExponent": 2,
    "direction": "Up",
    "model": "none.none"
  },
  {
    "currencyIso": "EUR",
    "currencyExponent": 2,
    "direction": "Up",
```

{% endcode %}
{% endtab %}
{% endtabs %}

### Rounding Rules

The following examples show how each rounding rule works in v4.0:

| Rule       | What it does                                    | Example model           | Starting price | Direction | Result   |
| ---------- | ----------------------------------------------- | ----------------------- | -------------- | --------- | -------- |
| `fixed`    | Forces the value to end with a specific target. | `fixed100.fixed00`      | `98.50`        | `Up`      | `100.00` |
| `none`     | Leaves that part of the price unchanged.        | `none.none`             | `98.50`        | `Up`      | `98.50`  |
| `multiple` | Rounds to the nearest configured multiple.      | `multiple50.multiple50` | `98.26`        | `Up`      | `100.50` |

### Common v4.0 combinations

| Model                   | Meaning                                                                      | Example       | Result   |
| ----------------------- | ---------------------------------------------------------------------------- | ------------- | -------- |
| `fixed100.fixed00`      | Round whole number to `100` and decimals to `00`.                            | `98.50`, `Up` | `100.00` |
| `fixed100.none`         | Round whole number to `100` and keep decimals unchanged.                     | `98.23`, `Up` | `100.23` |
| `none.fixed00`          | Keep the whole number and set decimals to `00`.                              | `98.50`, `Up` | `99.00`  |
| `none.multiple50`       | Keep the whole number and round decimals to the nearest multiple of `50`.    | `98.30`, `Up` | `98.50`  |
| `multiple50.fixed00`    | Round whole number to the nearest multiple of `50` and set decimals to `00`. | `98.50`, `Up` | `100.00` |
| `multiple50.multiple50` | Round both whole number and decimals to multiples of `50`.                   | `98.26`, `Up` | `100.50` |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.esw.com/pricing-advisor-api/pricing-advisor-api/overview.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.