📔Pusher API Reference

API Specification

POST https://api.crosscurve.fi/api-docs/#/

Routing API

Get possible cross-chain routes for token exchange

POST https://api.crosscurve.fi/routing/scan

Request Body

Name
Type
Description

params.chainIdIn*

Number

chainId of the sending network

params.chainIdOut*

Number

chainId of the receiving network

params*

Object

slippage*

Number

params.tokenIn*

String

address of the token that the user is selling on the chainIdIn network

params.tokemOut*

String

address of the token that the user is buying on the chainIdOut network

params.amountIn*

String

[
  {
    "query": {
      "params": {
        "tokenIn": "0xdac17f958d2ee523a2206206994597c13d831ec7",
        "chainIdIn": 1,
        "tokenOut": "0xe71286fC887189C562410af12eD521C8e58e5fA3",
        "chainIdOut": 250,
        "amountIn": "100000000"
      },
      "slippage": 0.5
    },
    "route": [
      {
        "type": "addLiquidity",
        "chainId": 1,
        "params": {
          "tokenIn": {
            "logos": {
              "16": "https://s2.coinmarketcap.com/static/img/coins/16x16/825.png",
              "32": "https://s2.coinmarketcap.com/static/img/coins/32x32/825.png",
              "64": "https://s2.coinmarketcap.com/static/img/coins/64x64/825.png",
              "128": "https://s2.coinmarketcap.com/static/img/coins/128x128/825.png",
              "200": "https://s2.coinmarketcap.com/static/img/coins/200x200/825.png"
            },
            "chainId": 1,
            "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
            "name": "Tether USD",
            "symbol": "USDT",
            "decimals": 6,
            "originalName": "Tether USD",
            "originalSymbol": "USDT",
            "tags": ["erc20", "stable"],
            "permittable": false,
            "permit": false
          },
          "chainIdIn": 1,
          "tokenOut": {
            "chainId": 1,
            "address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
            "name": "Curve.fi USD-BTC-ETH",
            "symbol": "crv3crypto",
            "decimals": 18,
            "originalName": "Curve.fi USD-BTC-ETH",
            "originalSymbol": "crv3crypto",
            "tags": ["erc20", "curve_lp"],
            "permittable": false,
            "permit": false,
            "coins": [
              "0xdAC17F958D2ee523a2206206994597C13D831ec7",
              "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
              "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
            ]
          },
          "chainIdOut": 1,
          "amountIn": "100000000",
          "amountInWithoutSlippage": "100000000",
          "amountOut": "54972421143512185",
          "amountOutWithoutSlippage": "55248664465841392",
          "slippage": 0.5
        },
        "pool": {
          "address": "0xd51a44d3fae010294c616388b506acda1bfaae46",
          "coins": [
            "0xdAC17F958D2ee523a2206206994597C13D831ec7",
            "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
            "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
          ],
          "decimals": [6, 8, 18],
          "logos": {
            "16": "https://s2.coinmarketcap.com/static/img/exchanges/16x16/1063.png",
            "32": "https://s2.coinmarketcap.com/static/img/exchanges/32x32/1063.png",
            "64": "https://s2.coinmarketcap.com/static/img/exchanges/64x64/1063.png",
            "128": "https://s2.coinmarketcap.com/static/img/exchanges/128x128/1063.png",
            "200": "https://s2.coinmarketcap.com/static/img/exchanges/200x200/1063.png"
          },
          "lp": {
            "chainId": 1,
            "address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
            "name": "Curve.fi USD-BTC-ETH",
            "symbol": "crv3crypto",
            "decimals": 18,
            "originalName": "Curve.fi USD-BTC-ETH",
            "originalSymbol": "crv3crypto",
            "tags": ["erc20", "curve_lp"],
            "permittable": false,
            "permit": false,
            "coins": [
              "0xdAC17F958D2ee523a2206206994597C13D831ec7",
              "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
              "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
            ]
          }
        },
        "fees": [
          {
            "type": "eywaStableSwapFee",
            "token": {
              "logos": {
                "16": "https://s2.coinmarketcap.com/static/img/coins/16x16/825.png",
                "32": "https://s2.coinmarketcap.com/static/img/coins/32x32/825.png",
                "64": "https://s2.coinmarketcap.com/static/img/coins/64x64/825.png",
                "128": "https://s2.coinmarketcap.com/static/img/coins/128x128/825.png",
                "200": "https://s2.coinmarketcap.com/static/img/coins/200x200/825.png"
              },
              "chainId": 1,
              "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
              "name": "Tether USD",
              "symbol": "USDT",
              "decimals": 6,
              "originalName": "Tether USD",
              "originalSymbol": "USDT",
              "tags": ["erc20", "stable"],
              "permittable": false,
              "permit": false
            },
            "percent": "0.0654473",
            "amount": "65447"
          }
        ]
      },
      {
        "type": "bridgeIn",
        "chainId": 1,
        "params": {
          "tokenIn": {
            "chainId": 1,
            "address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
            "name": "Curve.fi USD-BTC-ETH",
            "symbol": "crv3crypto",
            "decimals": 18,
            "originalName": "Curve.fi USD-BTC-ETH",
            "originalSymbol": "crv3crypto",
            "tags": ["erc20", "curve_lp"],
            "permittable": false,
            "permit": false,
            "coins": [
              "0xdAC17F958D2ee523a2206206994597C13D831ec7",
              "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
              "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
            ]
          },
          "chainIdIn": 1,
          "tokenOut": {
            "chainId": 250,
            "address": "0xe71286fC887189C562410af12eD521C8e58e5fA3",
            "name": "s3crypto_e",
            "symbol": "s3crypto_e",
            "decimals": 18,
            "originalName": "s3crypto_e",
            "originalSymbol": "s3crypto_e",
            "tags": ["erc20", "synth"],
            "permittable": false,
            "permit": false,
            "real": {
              "chainId": 1,
              "address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
              "name": "Curve.fi USD-BTC-ETH",
              "symbol": "crv3crypto",
              "decimals": 18,
              "originalName": "Curve.fi USD-BTC-ETH",
              "originalSymbol": "crv3crypto",
              "tags": ["erc20", "curve_lp"],
              "permittable": false,
              "permit": false,
              "coins": [
                "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
                "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
              ]
            },
            "realToken": {
              "chainId": 1,
              "address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
              "name": "Curve.fi USD-BTC-ETH",
              "symbol": "crv3crypto",
              "decimals": 18,
              "originalName": "Curve.fi USD-BTC-ETH",
              "originalSymbol": "crv3crypto",
              "tags": ["erc20", "curve_lp"],
              "permittable": false,
              "permit": false,
              "coins": [
                "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
                "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
              ]
            }
          },
          "chainIdOut": 250,
          "amountIn": "54972421143512185",
          "amountInWithoutSlippage": "55248664465841392",
          "amountOut": "54972421143512185",
          "amountOutWithoutSlippage": "55248664465841392",
          "slippage": 0.5
        },
        "fees": [
          {
            "type": "bridgeFee",
            "amount": "0",
            "percent": "0",
            "token": {
              "chainId": 250,
              "address": "0xe71286fC887189C562410af12eD521C8e58e5fA3",
              "name": "s3crypto_e",
              "symbol": "s3crypto_e",
              "decimals": 18,
              "originalName": "s3crypto_e",
              "originalSymbol": "s3crypto_e",
              "tags": ["erc20", "synth"],
              "permittable": false,
              "permit": false,
              "real": {
                "chainId": 1,
                "address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
                "name": "Curve.fi USD-BTC-ETH",
                "symbol": "crv3crypto",
                "decimals": 18,
                "originalName": "Curve.fi USD-BTC-ETH",
                "originalSymbol": "crv3crypto",
                "tags": ["erc20", "curve_lp"],
                "permittable": false,
                "permit": false,
                "coins": [
                  "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                  "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
                  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                ]
              },
              "realToken": {
                "chainId": 1,
                "address": "0xc4ad29ba4b3c580e6d59105fff484999997675ff",
                "name": "Curve.fi USD-BTC-ETH",
                "symbol": "crv3crypto",
                "decimals": 18,
                "originalName": "Curve.fi USD-BTC-ETH",
                "originalSymbol": "crv3crypto",
                "tags": ["erc20", "curve_lp"],
                "permittable": false,
                "permit": false,
                "coins": [
                  "0xdAC17F958D2ee523a2206206994597C13D831ec7",
                  "0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599",
                  "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2"
                ]
              }
            }
          }
        ]
      }
    ],
    "amountIn": "100000000",
    "amountOut": "54972421143512185",
    "amountOutWithoutSlippage": "55248664465841392",
    "tokenInPrice": 1,
    "tokenOutPrice": 1811.0144629377985,
    "priceImpact": 0,
    "totalFee": {
      "type": "total",
      "percent": "0.07",
      "amount": 0.06545
    }
  }
]

Get an estimate for cross-chain exchange

POST https://api.crosscurve.fi/estimate

Request Body

Name
Type
Description

query*

Object

query.params*

Object

query.params.chainIdIn*

Number

query.params.chainIdOut*

Number

query.params.tokenIn*

String

query.params.tokenOut*

String

query.params.amountIn*

String

query.slippage*

Number

amountIn*

String

amountInWithoutSlippage*

String

amountOut*

String

amountOutWithoutSlippage*

String

route*

Route

Formulate data for the transaction

POST https://api.crosscurve.fi/tx/create

Request Body

Name
Type
Description

from*

String

recipient*

String

routing*

Routing

estimate*

Estimate

Explorer API

API link: https://api.crosscurve.fi

Explorer: https://explorer.eywa.fi/

Get information about the transaction by its hash or requestId

GET https://api.crosscurve.fi/search?search={hashOrReqId}&limit={limit}

Query Parameters

Name
Type
Description

search*

String

hash or requestId of the transaction

limit*

String

Get details of the cross-chain transfer by requestId

GET https://api.crosscurve.fi/transaction/{reqId}

Path Parameters

Name
Type
Description

reqId*

String

Last updated