Cross Chain Liquidity Aggregator Service

Cross Chain Liquidity Aggregator service is powered by Chainge's cutting edge cross-chain technology and aggregated 28 chains and tens of dexes on the supported chains.

In our liquidity aggregator, we are able to provide billions of liquidity and offers our users the best price available and most of the tokens in those aggregated dexes.

In version 1.0, Chainge is going to provide all supported EVM chains in our cross-chain infrastructure to public. However, we are busy working on including our supported non-EVM chains now.

To be noticed, we do not have a testnet environment. All the transactions should be on mainnet. To test a transaction, one could send a small amount like $1 on a low gas network such as fusion.

There are four steps for a cross-chain liquidity aggregator swap transaction.

  1. get a cross chain quote

Get a quote for a cross chain liquidity aggregator transaction

POST /open/v1/order/getAggregateQuote

Headers

NameTypeDescription

appKey*

String

developer account appKey

expireTime*

Int

timeout time in ms for a request

signature*

String

signature generated to verify developer account. Please refer to Signature verification to generate a signature

timestamp*

Int

current timestamp used in signature verification

Request Body

NameTypeDescription

fromAmount*

float

token amount to be swapped without token decimal

fromChain*

String

from chain name

from supported Chains API request result

toChain*

String

to chain name

from supported Chains API request result

toToken*

String

token swapped to

from supported tokens API request result

feeLevel*

Int

Please refer to fee structureFee Structure

fromToken*

String

token to be swapped

from supported tokens API request result

{
  "code": 0,
  "data": {},
  "msg": "string",
  "status": 0
}

2. get a transaction raw

Get a raw for users to sign and then broadcast

POST /open/v1/order/getTransferToMinterRaw

Headers

NameTypeDescription

appKey*

String

developer account appKey

expireTime*

Int

timeout time in ms for a request

signature*

String

signature generated to verify developer account. Please refer to Signature verification to generate a signature

timestamp*

Int

current timestamp used in signature verification

Request Body

NameTypeDescription

amount*

float

token amount to be crossed without token decimal

chain*

String

original chain name from supported Chains API request result

evmAddress*

String

user evm Address

token*

String

token symbol to be crossed from supported tokens API request result

fromAddress*

Int

user from address (If it is from a EVM chain, the address is same as evmAddress)

{
  "code": 0,
  "data": {},
  "msg": "s

3. Submit transaction to hash

Submit transaction hash and start cross chain liquidity swap

POST /open/v1/order/submitAggregate

Headers

NameTypeDescription

appKey*

String

developer account appKey

expireTime*

Int

timeout time in ms for a request

signature*

String

signature generated to verify developer account. Please refer to Signature verification to generate a signature

timestamp*

Int

current timestamp used in signature verification

Request Body

NameTypeDescription

fromAmount*

float

token amount to be swapped without token decimal in step 2

fromChain*

String

original chain name from step 2

evmAddres*

String

user EVM Address

fromToken*

String

token to be swapped in step 2

fromAddress*

Int

user from address (If it is from a EVM chain, the address is same as evmAddress)

certHash*

String

the transaction hash from step 2

toChain*

String

To chain name

feeLevel*

Int

Please refer to Fee Structure

toToken*

String

token swapped to in step 2

{
  "code": 0,
  "data": {},
  "msg": "string",
  "status": 0
}

4. Check cross chain status

Get Order Detail

GET /open/v1/order/getOrderDetailByHashAndEvmAddress

Query Parameters

NameTypeDescription

chain*

String

source chain

hash*

String

the transaction hash

evmAddress*

String

user evm Address

Headers

NameTypeDescription

appKey*

String

developer account appKey

timestamp*

Int

current timestamp used in signature verification

signature*

String

signature generated to verify developer account. Please refer to Signature verification to generate a signature

expireTime*

Int

timeout time in ms for a request

Last updated