Reference | Ooga Booga

Ooga Booga

Approve Router

Get the calldata for approving the router to spend your tokens on OBRouter

get

/v1/approve

Authorizations

Query parameters

tokenstring · default: 0x0E4aaF1351de4c0264C5c7056Ef3777b41BD8e03required

Token to approve address

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

amountany of

Amount to approve, defaults to max uint256 if not provided

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/v1/approve?token=0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

application/json

multipart/form-data

text/plain

{
  "tx": {
    "to": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B",
    "data": "0x095ea7b300000000000000000000000089fe079d1daea2db9cde973e5adaa8e2228938ea0000000000000000000000000000000000000000000000000000000000000001"
  }
}

Token Allowance

Get the allowance for the OBRouter to spend your tokens

get

/v1/approve/allowance

Authorizations

Query parameters

fromstringrequired

EVM Address

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

tokenstring · default: 0x0E4aaF1351de4c0264C5c7056Ef3777b41BD8e03required

EVM Address

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/v1/approve/allowance?from=0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B&token=0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

422

application/json

multipart/form-data

text/plain

{
  "allowance": "1000000000000000"
}

Router Address

Get the address of the router to approve spending of your tokens

get

/v1/approve/spender

Authorizations

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/v1/approve/spender' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

application/json

multipart/form-data

text/plain

{
  "address": "0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B"
}

Swap tokens

Gets a quote for a swap between two tokens given an amount.<br> <ul> <li> 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.</li> <li> Make sure to not tamper with the arguments provided in the response as it can lead to loss of funds.</li> <li> Only possible to trade whitelisted tokens specified on the /tokens endpoint. Permissionless trading is coming soon.</li> <li> Native token (BERA) is specified as zero address (0x0000000000000000000000000000000000000000)</li>

get

/v1/swap

Authorizations

Query parameters

tokenInstring · default: 0x0000000000000000000000000000000000000000required

Input token address

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

tokenOutstring · default: 0x0E4aaF1351de4c0264C5c7056Ef3777b41BD8e03required

Output token address

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

amountany of · default: 1000000000000000000required

Amount of input token

tostring

Recipient address, if not set, calldata cannot be generated

Example: 0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B

Pattern: ^0x(.*)$

slippageany of · max: 1 · default: 0.02

Slippage tolerance in percentage between 0 and 1, default 0.02 (2%)

Example: 0.01

Slippage tolerance in percentage between 0 and 1, default 0.02 (2%)

liquiditySourcesany of[]

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/v1/swap?tokenIn=0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B&tokenOut=0x7EeCA4205fF31f947EdBd49195a7A88E6A91161B&amount=1000000000000000000' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

422

application/json

multipart/form-data

text/plain

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

Token List

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

get

/v1/tokens

Authorizations

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/v1/tokens' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

500

application/json

multipart/form-data

text/plain

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

Liquidity Sources

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

get

/v1/liquidity-sources

Authorizations

Responses

cURL

JavaScript

Python

HTTP

curl -L \
  --url '/v1/liquidity-sources' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

application/json

multipart/form-data

text/plain

[
  "text"
]