LFJ Router API

Get routes for a token swap

get

One of amountIn or amountOut is required. Exact out calculation is not supported by some aggregators.

Path parameters

chainstring · enumRequired

Chain identifier

Possible values:

aggstring · enumRequired

Aggregator identifier

Possible values:

Query parameters

tokenInstringRequired

Input token address

tokenOutstringRequired

Output token address

amountInstringOptional

Input token amount

amountOutstringOptional

Output token amount

Responses

200

Successful response

application/json

amountInstringOptional

Input token amount

amountOutstringOptional

Output token amount

aggregatorstringOptional

Aggregator identifier

400

Bad request

application/json

get/v2/aggregator/routes/{chain}/{agg}/quote

GET /v2/aggregator/routes/{chain}/{agg}/quote?tokenIn=text&tokenOut=text HTTP/1.1
Host: router-api.lfj.dev
Accept: */*

{
  "tokenIn": {
    "address": "text",
    "symbol": "text",
    "swaps": [
      {
        "pair": "text",
        "tokenIn": {
          "address": "text",
          "symbol": "text"
        },
        "tokenOut": {
          "address": "text",
          "symbol": "text",
          "swaps": [
            {}
          ]
        },
        "amountBp": 1
      }
    ]
  },
  "tokenOut": {
    "address": "text",
    "symbol": "text"
  },
  "amountIn": "text",
  "amountOut": "text",
  "aggregator": "text"
}

Get transaction data for a token swap

get

Path parameters

chainstring · enumRequired

Chain identifier

Possible values:

aggstring · enumRequired

Aggregator identifier

Possible values:

Query parameters

tokenInstringRequired

Input token address

tokenOutstringRequired

Output token address

amountInstringRequired

Input token amount

userAddressstringRequired

User's wallet address

slippageBpsinteger · max: 10000Required

Maximum slippage tolerance in basis points (1 bps = 0.01%)

feeBpsinteger · max: 10000Required

Fee in basis points (1 bps = 0.01%)

feeRecipientAddressstringOptional

Fee recipient's wallet address. Required if feeBps is not zero.

Responses

200

Successful response

application/json

fromstringOptional

Transaction from address

tostringOptional

Transaction to address

datastringOptional

Transaction data

valuestringOptional

Transaction value

gasstringOptional

Gas limit

gasPricestringOptional

Gas price

400

Bad request

application/json

get/v2/aggregator/routes/{chain}/{agg}/swap

GET /v2/aggregator/routes/{chain}/{agg}/swap?tokenIn=text&tokenOut=text&amountIn=text&userAddress=text&slippageBps=1&feeBps=1 HTTP/1.1
Host: router-api.lfj.dev
Accept: */*

{
  "from": "text",
  "to": "text",
  "data": "text",
  "value": "text",
  "gas": "text",
  "gasPrice": "text"
}

Health check

get

Responses

200

Service is healthy

No content

503

Service is unhealthy

get/health-check

GET /health-check HTTP/1.1
Host: router-api.lfj.dev
Accept: */*

No content