> For the complete documentation index, see [llms.txt](https://chainge-finance.gitbook.io/chainge-finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chainge-finance.gitbook.io/chainge-finance/get-started/chainge-2.0-api-documentation/get-price-quote-api.md).

# Get Price Quote API

## Cross-chain Quote

GET <https://api2.chainge.finance/v1/getBridgeQuote>

### Query

<table><thead><tr><th width="173">Fields</th><th>Description</th></tr></thead><tbody><tr><td>amount</td><td>Amount paid by the user</td></tr><tr><td>symbol</td><td>From Token symbol</td></tr><tr><td>fromChain</td><td>From Chain nickName</td></tr><tr><td>toChain</td><td>To Chain nickName</td></tr></tbody></table>

example:&#x20;

```javascript
const result = await axios.get(`https://api2.chainge.finance/v1/getBridgeQuote?amount=100000000&symbol=USDT&fromChain=FSN&toChain=BNB`)
console.log(result)
//{
//    "code": 0,
//    "msg": "success",
//    "data": {
//        "price": "1",
//        "outAmount": "100000000000000000000",
//        "outAmountUsd": "100.000000000000000000",
//        "serviceFee": "50000000000000000",
//        "gasFee": "300000000000000000"
//    }
//}
const { outAmount, outAmountUsd, serviceFee, gasFee } = result.data
const outAmountBI = BigInt(outAmount)
const serviceFeeBI = BigInt(serviceFee)
const gasFeeBI = BigInt(gasFee)
const gasBI = serviceFeeBI + gasFeeBI
const receiveAmountBI = outAmountBI - totalGasBI
if(receiveAmountBI <= BigInt(0)) {
    // Unable to cover the transaction fee. The transaction should be terminated.
} else {
    // The actual value displayed to the user.
    console.log(formatUnits(receiveAmountBI, toToken?.decimals)) // 99.65
    console.log(formatUnits(gasBI, toToken?.decimals)) // 0.35 
    // Here, the extra parameter for submitOrder can be preprocessed.
    // submitOrder body params.extra
    const extra = `1_${receiveAmountBI.toString()}`
}
```

{% hint style="info" %}

<pre><code>The <a data-footnote-ref href="#user-content-fn-1">formatUnits</a> method is a function from the <a data-footnote-ref href="#user-content-fn-1">viem</a> library.
You can choose any equivalent library to use. 
Here, it's just a basic demonstration.
</code></pre>

{% endhint %}

{% hint style="info" %}

<pre><code><a data-footnote-ref href="#user-content-fn-1">fromChain, toChain, fromToken, toToken</a>
These are all results returned by the "Supported Chains &#x26; Tokens" interface.
</code></pre>

{% endhint %}

To provide higher flexibility, our return results need to be processed before displaying on the interface:

* price: The current price of the cross-chain currency for calculating its value.
* outAmount: The total amount received across chains, including gasFee and serviceFee. You need to subtract gasFee and serviceFee to get the actual amount received by the user.
* outAmountUsd: Estimated value in USDT.
* serviceFee: Official service fee, five per ten thousand (0.05%).
* gasFee: Gas fee for cross-chain transfers.

## Cross-chain Aggregate Quote API

GET <https://api2.chainge.finance/v1/getAggregateQuote>

<table><thead><tr><th width="218">Fields</th><th>Description</th></tr></thead><tbody><tr><td>fromAmount</td><td>Amount paid by the user</td></tr><tr><td>fromTokenAddress</td><td>From token contract address</td></tr><tr><td>fromDecimal</td><td>From token decimal</td></tr><tr><td>fromChain</td><td>From chain nickName</td></tr><tr><td>toTokenAddress</td><td>To token  contract address</td></tr><tr><td>toDecimal</td><td>To token decimal</td></tr><tr><td>toChain</td><td>To chain nickName</td></tr></tbody></table>

example:&#x20;

<pre class="language-javascript"><code class="lang-javascript"><strong>const result = await axios.get(`https://api2.chainge.finance/v1/getAggregateQuote?fromAmount=100000000&#x26;fromTokenAddress=0x8a20c13b42d7fe418f10f922f2cee06246c24269&#x26;fromDecimal=6&#x26;fromChain=FSN&#x26;toTokenAddress=0x8ac76a51cc950d9822d68b83fe1ad97b32cd580d&#x26;toDecimal=18&#x26;toChain=BNB`)
</strong>console.log(result)
//{
//    "code": 0,
//    "msg": "success",
//    "data": {
//        "chain": "42161",
//        "chainDecimal": 6,
//        "aggregator": "Kyber",
//        "outAmount": "100061783",
//        "outAmountUsd": "99.20181999",
//        "minOutAmount": "",
//        "serviceFee": "50030",
//        "gasFee": "800079",
//        "priceImpact": "0.26",
//        "routeSummary": "H4sIAAAAAAAA/5ySUWvbMBSF/8t99ookW7KstxZWCGxslO0p5EG6vnJMHDlYcpsS8t+HHS/pVhisftP1Eeec++kEqd9RWAUwwI6+Zlo5LLGWWGheI1aoJTkqSm05Mqcqj85VkIHd92NI8z3Olu/N+GesL38g++3w1Q47St+HFun+2baddR2B8baLtGi+jWmOYb3WNVOSyhI1ohB5lYsSJdUut0UuhNIkdc6vfpeLUw7FS52/nV+D3AnFK6akUnCz+2emxkYwIORSrbFxFv7VuLHx4sHumGalZIwLrQolimoKSMc02EciMCfwRPdzrkkNGeDWDg09Ej28ggHIoI2r8HCI1wSe6ImQ2mcaJsE5g6EfE4FZr09w6PtuXhdOyDQnwXyVi5xx4RUVQrjaSym8Z8pZhTW/ofhf2B+l07X7Nj1RGofwR/H4Yg/Xwfvn8x4nHXFrQzPt/qXfO5sgm/t/odCkLZjicvzxerhJPu1tGxbd54kCmDB23YIEzOl83mxuJ8DtGHZxFXwPZr05n38FAAD//y+XPE8bAwAA"
//    }
//}
const { chain, chainDecimal, aggregator, outAmount, outAmountUsd, minOutAmount, serviceFee, gasFee, priceImpact, routeSummary } = result.data
const outAmountBI = BigInt(outAmount)
const serviceFeeBI = BigInt(serviceFee)
const gasFeeBI = BigInt(gasFee)
const gasBI = serviceFeeBI + gasFeeBI
const receiveAmountBI = outAmountBI - totalGasBI
if(receiveAmountBI &#x3C;= BigInt(0)) {
    // Unable to cover the transaction fee. The transaction should be terminated.
} else {
    // The actual value displayed to the user.
    console.log(formatUnits(receiveAmountBI, chainDecimal)) // 99.211674
    console.log(formatUnits(gasBI, chainDecimal)) // 0.850109
    // Here, the extra parameter for submitOrder can be preprocessed.
    // submitOrder body params.extra
    let extraToAmountBI = receiveAmountBI
    if(toChain.network !== chain) {
        const tempExtraToAmountStr = formatUnits(extraToAmountBI, chainDecimal)
        extraToAmountBI = parseUnits(tempExtraToAmountStr, toToken.decimals)
    }
    const extra = `1_${extraToAmountBI.toString()}`
     if(fromChain.network !== chain &#x26;&#x26; toChain.network !== chain) {
        // The subsequent process proceeds with the submitOrder function.
    } else {
       if(fromChain.network === toChain.network) {
            // The subsequent process proceeds with the getAggregateSwap function.
       } else {
           // The subsequent process proceeds with the submitOrder function.
       }
    }
}
</code></pre>

{% hint style="info" %}

<pre><code>The <a data-footnote-ref href="#user-content-fn-1">formatUnits</a> method is a function from the <a data-footnote-ref href="#user-content-fn-1">viem</a> library.
You can choose any equivalent library to use. 
Here, it's just a basic demonstration.
</code></pre>

{% endhint %}

{% hint style="info" %}
[fromChain, toChain, fromToken, toToken](#user-content-fn-1)[^1]

These are all results returned by the "Supported Chains & Tokens" interface.s
{% endhint %}

To provide greater flexibility, our return results need to be processed again before they can be displayed on the interface:

* **chain:** The chain ID on which the transaction is executed.
* **chainDecimal:** The decimal of the current currency on the chain where the transaction is executed.
* **aggregator:** The intermediary responsible for executing the transaction.
* **outAmount:** The total amount received after cross-chain transfer, including gasFee and serviceFee. Therefore, you need to deduct gasFee and serviceFee to get the actual amount received by the user.
* **outAmountUsd:** The estimated value in USDT.
* **minOutAmount:** Reserved field.
* **serviceFee:** More detailed documentation will be provided.
* **gasFee:** The gas fee for cross-chain transfer.
* **priceImpact:** Price impact.
* **routeSummary:** Transaction routing information.

[^1]:


---

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

```
GET https://chainge-finance.gitbook.io/chainge-finance/get-started/chainge-2.0-api-documentation/get-price-quote-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.