Reference

Swap tokens

get

Gets a quote for a swap between two tokens given an amount. If a to address is provided, the swap execution data will be included in the response to be used to build the calldata to be executed on-chain. Make sure to not tamper with the arguments provided in the response as it can lead to loss of funds. Only possible to trade whitelisted tokens specified on the /tokens endpoint. Permissionless trading is coming soon. Native token (BERA) is specified as zero address (0x0000000000000000000000000000000000000000)

Authorizations

Query parameters

tokenInstring · default: "0x0000000000000000000000000000000000000000"required

Input token address

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

tokenOutstring · default: "0xFCBD14DC51f0A4d49d5E53C2E0950e0bC26d0Dce"required

Output token address

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

amountany of · default: 1000000000000000000required

Amount of input token

Amount of input token

Amount of input token

tostringoptional

Recipient address, if not set, calldata cannot be generated

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

slippageany of · max: 1 · default: 0.02optional

Slippage tolerance in decimal between 0 (0%) and 1 (100%), default 0.02 (=2%)

Example: 0.01

Slippage tolerance in decimal between 0 (0%) and 1 (100%), default 0.02 (=2%)

Slippage tolerance in decimal between 0 (0%) and 1 (100%), default 0.02 (=2%)

liquiditySourcesany of[]optional

Specify which liquidity sources to use on path finding. Otherwise all will be used by default

liquiditySourcesBlacklistany of[]optional

Specify which liquidity sources to not use on path finding. Otherwise all will be used by default

referralCodeany ofoptional

Partner referral code

Partner referral code

Partner referral code

Responses

application/jsonmultipart/form-datatext/plain

application/jsonmultipart/form-datatext/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mainnet.api.oogabooga.io/v1/swap?tokenIn=0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B&tokenOut=0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B&amount=text' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

422

200

application/json

multipart/form-data

text/plain

application/json

{
  "status": "Success",
  "blockNumber": 1,
  "tokenFrom": 1,
  "tokenTo": 2,
  "price": 280,
  "priceImpact": -0.025,
  "tokens": [
    {
      "address": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
      "name": "HONEY",
      "symbol": "HONEY",
      "decimals": 18
    }
  ],
  "amountIn": "1000000000000000",
  "amountOutFee": "1000000000000000",
  "assumedAmountOut": "1000000000000000",
  "route": [
    {
      "poolAddress": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
      "poolType": "Classic",
      "poolName": "KodiakV2 0.3%",
      "liquiditySource": "KodiakV2",
      "poolFee": 0.003,
      "tokenFrom": 1,
      "tokenTo": 2,
      "share": 1,
      "assumedAmountIn": "1000000000000000",
      "assumedAmountOut": "1000000000000000"
    }
  ],
  "tx": {
    "to": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
    "data": "0x095ea7b300000000000000000000000089fe079d1daea2db9cde973e5adaa8e2228938ea0000000000000000000000000000000000000000000000000000000000000001",
    "value": "1000000000000000"
  },
  "routerAddr": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
  "routerParams": {
    "swapTokenInfo": {
      "inputToken": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
      "inputAmount": "1000000000000000",
      "outputToken": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
      "outputQuote": "1000000000000000",
      "outputMin": "900000000000000",
      "outputReceiver": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B"
    },
    "pathDefinition": "0x7f746573743200",
    "executor": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
    "referralCode": 1,
    "value": "1000000000000000"
  }
}

Token List

get

Get the list of tokens for trading on the Ooga Booga's Smart Order Routing

Authorizations

Responses

application/jsonmultipart/form-datatext/plain

application/jsonmultipart/form-datatext/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mainnet.api.oogabooga.io/v1/tokens' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

500

200

application/json

multipart/form-data

text/plain

application/json

[
  {
    "address": "0xFCBD14DC51f0A4d49d5E53C2E0950e0bC26d0Dce",
    "name": "Honey",
    "symbol": "HONEY",
    "decimals": 18,
    "tokenURI": "https://artio-static-asset-public.s3.ap-southeast-1.amazonaws.com/assets/honey.png"
  }
]

Liquidity Sources

get

Get all the liquidity sources available on the router to be used on swap

Authorizations

Responses

application/jsonmultipart/form-datatext/plain

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://mainnet.api.oogabooga.io/v1/liquidity-sources' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

application/json

multipart/form-data

text/plain

application/json

[
  "text"
]