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

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

tokenInstringRequired

Input token address

Default: 0x0000000000000000000000000000000000000000Example: 0x6969696969696969696969696969696969696969Pattern: ^0x(.*)$

tokenOutstringRequired

Output token address

Default: 0x6969696969696969696969696969696969696969Example: 0x6969696969696969696969696969696969696969Pattern: ^0x(.*)$

amountany ofRequired

Amount of input token

Default: 1000000000000000000

string · numericOptional

or

numberOptional

Amount of input token

Default: 1000000000000000000

tostringOptional

Recipient address, if not set, calldata cannot be generated

Example: 0x6969696969696969696969696969696969696969Pattern: ^0x(.*)$

slippagenumber · max: 1Optional

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

Default: 0.02Example: 0.01

poolBlackliststring[]Optional

Specify which pool addresses to not use on path finding. Otherwise all will be used by default. Becareful as some pools share the same poolAddress and the blacklist will ignore multiple pools

Example: 0x6969696969696969696969696969696969696969

referralCodenumberOptional

Partner referral code

Responses

200Success

application/jsonmultipart/form-datatext/plain

or

or

422Error

application/jsonmultipart/form-datatext/plain

get

/v1/swap

HTTPcURLJavaScriptPython

GET /v1/swap?tokenIn=0x6969696969696969696969696969696969696969&tokenOut=0x6969696969696969696969696969696969696969&amount=1000000000000000000 HTTP/1.1
Host: mainnet.api.oogabooga.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "Success",
  "blockNumber": 1068258,
  "tokenFrom": 1,
  "tokenTo": 2,
  "price": 280,
  "priceImpact": -0.025,
  "gasPrice": 100000,
  "gas": 100000,
  "tokens": [
    {
      "address": "0x6969696969696969696969696969696969696969",
      "name": "HONEY",
      "symbol": "HONEY",
      "decimals": 18
    }
  ],
  "amountIn": "1000000000000000",
  "amountOutFee": "1000000000000000",
  "assumedAmountOut": "1000000000000000",
  "route": [
    {
      "poolAddress": "0x6969696969696969696969696969696969696969",
      "poolType": "Classic",
      "poolName": "KodiakV2 0.3%",
      "liquiditySource": "KodiakV2",
      "poolFee": 0.003,
      "tokenFrom": 1,
      "tokenTo": 2,
      "share": 1,
      "assumedAmountIn": "1000000000000000",
      "assumedAmountOut": "1000000000000000"
    }
  ],
  "hasExecutionParams": true
}

Token List

get

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

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200Success

application/jsonmultipart/form-datatext/plain

addressstringRequired

EVM Address

Example: 0x6969696969696969696969696969696969696969Pattern: ^0x(.*)$

namestringRequiredExample: Honey

symbolstringRequiredExample: HONEY

decimalsnumberRequiredExample: 18

tokenURIstringOptionalExample: https://artio-static-asset-public.s3.ap-southeast-1.amazonaws.com/assets/honey.png

tagsstring[]Required

500Error

application/jsonmultipart/form-datatext/plain

get

/v1/tokens

HTTPcURLJavaScriptPython

GET /v1/tokens HTTP/1.1
Host: mainnet.api.oogabooga.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

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

Liquidity Sources

get

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

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200Success

application/jsonmultipart/form-datatext/plain

const: KodiakV2Optional

or

const: KodiakV3Optional

or

const: HoneypotOptional

or

const: NativeWrapOptional

or

const: HoneySwapOptional

or

const: GrizzlyOptional

or

const: WasabeeOptional

or

const: BullaOptional

or

const: IzumiOptional

or

const: BeradromeOptional

or

const: BexOptional

or

const: BerpsOptional

or

const: BendOptional

or

const: MarginalOptional

or

const: MemeswapOptional

or

const: TwinOptional

or

const: BurrBearMultiStableOptional

or

const: BurrBearFXOptional

or

const: BurrBearGeneralizedOptional

or

const: WeberaOptional

or

const: BeraswapWeightedOptional

or

const: BeraswapComposableStableOptional

or

const: KodiakPandaOptional

or

const: HoldStationOptional

or

const: OrigamiIBGTVaultOptional

or

const: PendleSyOptional

or

const: PendlePtMarketOptional

or

const: OpenStateIBGTVaultOptional

or

const: IBeraOptional

or

const: ObricOptional

or

const: BrownFiOptional

or

const: BrownFiV2Optional

or

const: YBeraOptional

or

const: NablaOptional

or

const: WooFiOptional

or

const: CurveOptional

or

const: sWBeraOptional

or

const: EulerOptional

or

const: WinnieswapOptional

or

const: WBYUSDOptional

or

const: BurveOptional

or

const: pBERAOptional

or

const: stpBERAOptional

or

const: stLBGTOptional

or

const: wiBGTOptional

get

/v1/liquidity-sources

HTTPcURLJavaScriptPython

GET /v1/liquidity-sources HTTP/1.1
Host: mainnet.api.oogabooga.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

[
  "text"
]