Reference

get

Query parameters

tokenInstringRequired

The tokenIn address

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

tokenOutstringRequired

The tokenOut address

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

amountany ofRequired

The amount of tokenIn used in the swap

Example: 100000

string · numericOptional

or

numberOptional

The amount of tokenIn used in the swap

Example: 100000

tostringOptional

The address to send the output to

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

maxSlippageany of · max: 1Required

The maximum slippage allowed in the swap as a decimal fraction, for example 0.005 for 0.5% slippage. 0 < maxSlippage < 1

Default: 0.01Example: 0.01

string · numericOptionalDefault: 0

or

number · max: 1Optional

The maximum slippage allowed in the swap as a decimal fraction, for example 0.005 for 0.5% slippage. 0 < maxSlippage < 1

Default: 0.01Example: 0.01

simulatebooleanOptional

Whether to simulate the quotes

Example: true

referralCodeany ofOptional

The referral code to use in the swap

Example: 1234567890

string · numericOptionalDefault: 0

or

numberOptional

The referral code to use in the swap

Example: 1234567890

Responses

200Success

application/jsonmultipart/form-datatext/plain

400Error

application/jsonmultipart/form-datatext/plain

get

/meta/swap

HTTPcURLJavaScriptPython

GET /meta/swap?tokenIn=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb&tokenOut=0x0000000000000000000000000000000000000000&amount=100000&maxSlippage=0.01 HTTP/1.1
Host: 
Accept: */*

[
  {
    "amountIn": "100000",
    "aggregator": "oogaBooga",
    "amountOut": "2450337340878051",
    "minAmountOut": "2450337340878051",
    "simulationAmountOut": "2450337340878051",
    "priceImpact": -0.0004537756539829,
    "fee": "100000",
    "gas": "358339",
    "value": "0",
    "routerAddr": "0x5fbD1B5AA82d09359C05428647871fe9aDd3F411",
    "calldata": "0x1234567890123456789012345678901234567890",
    "status": "Success"
  }
]

get

Responses

200

List of available aggregators

application/jsonmultipart/form-datatext/plain

get

/meta/aggregators

HTTPcURLJavaScriptPython

GET /meta/aggregators HTTP/1.1
Host: 
Accept: */*

200

List of available aggregators

[
  {
    "id": "oogaBooga",
    "displayName": "OOGA BOOGA",
    "logoUrl": "https://assets-agg.oogabooga.io/oogaBooga.svg"
  }
]

Stream real-time swap quotes

get

Establishes a Server-Sent Events (SSE) stream that provides real-time swap quotes from multiple aggregators. The stream emits various event types including connection status, quotes, errors, heartbeats, and completion notifications.

Query parameters

tokenInstringRequired

The tokenIn address

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

tokenOutstringRequired

The tokenOut address

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

amountany ofRequired

The amount of tokenIn used in the swap

Example: 100000

string · numericOptional

or

numberOptional

The amount of tokenIn used in the swap

Example: 100000

tostringOptional

The address to send the output to

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

maxSlippageany of · max: 1Required

The maximum slippage allowed in the swap as a decimal fraction, for example 0.005 for 0.5% slippage. 0 < maxSlippage < 1

Default: 0.01Example: 0.01

string · numericOptionalDefault: 0

or

number · max: 1Optional

The maximum slippage allowed in the swap as a decimal fraction, for example 0.005 for 0.5% slippage. 0 < maxSlippage < 1

Default: 0.01Example: 0.01

simulatebooleanOptional

Whether to simulate the quotes

Example: true

referralCodeany ofOptional

The referral code to use in the swap

Example: 1234567890

string · numericOptionalDefault: 0

or

numberOptional

The referral code to use in the swap

Example: 1234567890

Responses

200

SSE stream of quote events

text/event-stream

Responsestring

Server-Sent Events formatted string containing quote data

Example: event: connected data: {"message":"Connected to quote stream","aggregators":["hyperBloom","oogaBooga"]}

get

/meta/stream/swap

HTTPcURLJavaScriptPython

GET /meta/stream/swap?tokenIn=0xb8ce59fc3717ada4c02eadf9682a9e934f625ebb&tokenOut=0x0000000000000000000000000000000000000000&amount=100000&maxSlippage=0.01 HTTP/1.1
Host: 
Accept: */*

200

SSE stream of quote events

event: connected
data: {"message":"Connected to quote stream","aggregators":["hyperBloom","oogaBooga"]}