Meta-Aggregator Swap API

A single, streamlined endpoint that aggregates several leading DEX Aggregators.

Navigating the complexities of integrating multiple trading Aggregators can be a daunting task for dApp developers. Each Aggregator has its unique methods for querying and quoting trades, requiring constant updates and maintenance to ensure optimal trade rates. Our swap API offers a streamlined solution, allowing developers to focus on their core product while effortlessly accessing the best trading rates through a single, consolidated endpoint.

Access optimized swap routes from several Aggregators including 1inch, Paraswap, 0x, Odos, and Kyber, and others with simplified and standardized request parameters. This allows developers to offer the best trade rates effortlessly, without the need to integrate and update multiple Aggregators individually.

Features:

- Consolidate requests and responses from several Aggregators.
- Standardized parameters for seamless integration.
- Customizable filters such as excludeSource and includeSource.
- Simplified pricing model for access to all supported Aggregators.

Benefits:

- Simplifies the integration process for developers, saving time and effort.
- Reduces the need for frequent updates and maintenance.
- Offers the best trade rates by aggregating multiple sources.
- Cost-effective solution with a single pricing model.
- Enhances trade execution and maximizes trading margins.

Why Developers Love It:

Our swap API is designed to simplify and enhance the integration experience for dApp developers. By consolidating multiple trading Aggregators into one endpoint with standardized parameters, it streamlines the integration process and reduces maintenance efforts. Customizable filters allow for tailored integrations, while a scalable pricing model makes it a cost-effective solution.

Whether you're a dApp developer looking to offer the best trades or a quant fund aiming to optimize trade execution, our API provides the tools you need to succeed.

REST Paths

POST /quote

Fetch a quote from the list of aggregators

Sample code

Axios

Axios
Python
Curl

Copy

00
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amountIn": "1000000000000000000",
    "slippage": 1,
    "chainId": 1,
    "recipient": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "odosReferralCode": "12345678",
    "partnerReferralWallet": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "partnerReferralFeeBps": 50
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/quote",
      data, config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/quote", json=request("{
    "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amountIn": "1000000000000000000",
    "slippage": 1,
    "chainId": 1,
    "recipient": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "odosReferralCode": "12345678",
    "partnerReferralWallet": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "partnerReferralFeeBps": 50
  }")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/quote \
-X POST \
-H 'Content-Type: application/json' \
--data '{
    "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amountIn": "1000000000000000000",
    "slippage": 1,
    "chainId": 1,
    "recipient": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "odosReferralCode": "12345678",
    "partnerReferralWallet": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "partnerReferralFeeBps": 50
  }'

POST /swap

Generate calldata for a specific aggregator

Sample code

Axios

Axios
Python
Curl

Copy

00
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  const data = {
    "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amountIn": "1000000000000000000",
    "slippage": 1,
    "chainId": 1,
    "recipient": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "odosReferralCode": "12345678",
    "partnerReferralWallet": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "partnerReferralFeeBps": 50
  };
  axios
    .post(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/swap",
      data, config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.post("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/swap", json=request("{
    "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amountIn": "1000000000000000000",
    "slippage": 1,
    "chainId": 1,
    "recipient": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "odosReferralCode": "12345678",
    "partnerReferralWallet": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "partnerReferralFeeBps": 50
  }")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/swap \
-X POST \
-H 'Content-Type: application/json' \
--data '{
    "tokenIn": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
    "tokenOut": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "amountIn": "1000000000000000000",
    "slippage": 1,
    "chainId": 1,
    "recipient": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "odosReferralCode": "12345678",
    "partnerReferralWallet": "0x92977D2552f455Bb9A3457AEbfCb78f1256Dd2e5",
    "partnerReferralFeeBps": 50
  }'

GET /sources

Fetch a per-chain list of sources to be used with `includeProtocols` or `excludeProtocols`

Sample code

Axios

Axios
Python
Curl

Copy

00
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/sources",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/sources")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/sources \
-X GET

GET /aggregators

Fetch a per-chain list of supported aggregators to be used for 'includeAggregators` or `excludeAggregators`

Sample code

Axios

Axios
Python
Curl

Copy

00
01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
17
18
19
20
21
22

const axios = require("axios");
(() : {
  const config = {
    headers: {
      "Content-Type": "application/json",
    },
  };
  
  axios
    .get(
      "https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/aggregators",
      config
    )
    .then(function (response) {
      // handle success
      console.log(response.data);
    })
    .catch((err) : {
      // handle error
      console.log(err);
    });
})();

import requests
response = requests.get("https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/aggregators")
parsed = parse(response.json())
if isinstance(parsed, Ok):
    print(parsed.result)
else:
    logging.error(parsed.message)

curl https://YOUR_QUICKNODE_ENDPOINT_HERE.com/addon/688/aggregators \
-X GET

This add-on is currently in Beta

Supported Chains

REST Paths

Supported Chains

Plans & features

Meta-Aggregator Swap API

This add-on is currently in Beta

Supported Chains

REST Paths

Supported Chains

Plans & features

Contact our sales team

Contact our sales team