DeFi | Baltex Docs

Currency info

get

Returns a currency info for the specified network and address if it exists.

Authorizations

x-api-keystringRequired

Query parameters

networkstringRequired

Network ticker (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)

addressstringRequired

Token contract address

Responses

200

Currency information

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/currency/info

GET /v1/defi/currency/info?network=text&address=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "name": "USD Coin",
  "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "decimals": 6,
  "symbol": "usdc",
  "network": "eth",
  "enabled": true,
  "image": "https://baltex.io/uploads/usdc.svg"
}

Available currencies

get

Returns a list of available currencies for the specified network.

Authorizations

x-api-keystringRequired

Query parameters

networkstringRequired

Network ticker (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)

pagestringOptional

Page number for pagination

limitstringOptional

Number of items per page

Responses

200

List of available currencies for DeFi

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/available-currencies

GET /v1/defi/available-currencies?network=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

[
  {
    "name": "Tether USD",
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "decimals": 6,
    "symbol": "usdt",
    "network": "eth",
    "enabled": true,
    "image": "https://baltex.io/uploads/usdt.png"
  },
  {
    "name": "Pepe",
    "address": "0x6982508145454ce325ddbe47a25d4ec3d2311933",
    "decimals": 18,
    "symbol": "pepe",
    "network": "eth",
    "enabled": true,
    "image": "https://baltex.io/uploads/pepe.png"
  }
]

Swap quote

get

Returns a quote for swapping tokens on a specified network.

Authorizations

x-api-keystringRequired

Query parameters

networkstringRequired

Network name (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)

fromTokenAddressstringRequired

Source token contract address

toTokenAddressstringRequired

Target token contract address

amountstringRequired

Amount to swap

slippagestringRequired

Allowed slippage in percent

referrerFeestringRequired

Referrer fee in percent

Responses

200

Swap quote

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/quote

GET /v1/defi/quote?network=text&fromTokenAddress=text&toTokenAddress=text&amount=text&slippage=text&referrerFee=text HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "fromAmount": "10000",
  "usdFromAmount": "9999",
  "toAmount": "9993.72081500",
  "usdToAmount": "10003.714535815",
  "receivedAmount": "9983.72709418",
  "fee": "0.000072885703202620308",
  "routes": [
    {
      "percentage": 100,
      "subRoutes": [
        {
          "from": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
          "to": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
          "dexes": [
            {
              "name": "Swaap",
              "address": "0xd315a9C38eC871068FEC378E4Ce78AF528C76293",
              "fee": 0,
              "percentage": 100
            }
          ]
        },
        {
          "from": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
          "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "dexes": [
            {
              "name": "UniswapV3",
              "address": "0xc7bBeC68d12a0d1830360F8Ec58fA599bA1b0e9b",
              "fee": 0.0001,
              "percentage": 100
            }
          ]
        }
      ]
    }
  ],
  "priceImpact": "0.04"
}

List of exchanges

get

Returns all DEX exchanges for partner from the last 24 hours with optional filters.

Authorizations

x-api-keystringRequired

Query parameters

statusstringOptional

Filter by exchange status

fromTokenAddressstringOptional

Filter by source token address

toTokenAddressstringOptional

Filter by target token address

networkstringOptional

Filter by network

Responses

200

List of DEX exchanges

application/json

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/exchange/list

GET /v1/defi/exchange/list HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Accept: */*

{
  "total": 2,
  "exchanges": [
    {
      "id": "e09962b422ac8a6e",
      "created": "2025-10-13T13:08:21.178Z",
      "updated": "2025-10-13T13:12:45.068Z",
      "network": "arbitrum",
      "fromTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "toTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amountFrom": "0.00231265",
      "amountTo": "9.50974600",
      "addressFrom": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
      "addressTo": null,
      "commissionPercentage": "0.1",
      "status": "finished",
      "hash": "0x858f26783c21bf403bb3b8a05e6cedf54ae62a5c5266241b241d303852b71a3f"
    },
    {
      "id": "299cbd93913cef03",
      "created": "2025-10-13T13:07:04.736Z",
      "updated": "2025-10-13T13:07:16.207Z",
      "network": "arbitrum",
      "fromTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
      "toTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "amountFrom": "0.00231265",
      "amountTo": "9.50532700",
      "addressFrom": "0x9e1Cc391E739649A7Cc3815685aaDcBFDD438612",
      "addressTo": null,
      "commissionPercentage": "0.1",
      "status": "failed",
      "hash": "0x040789dc85af3c80eb91c6de232d0926e2d8d0f0676663c6fc7e8d36e26a172b"
    }
  ]
}

Swap tokens

post

Build a transaction hash from the provided data and returns it to sign.

Authorizations

x-api-keystringRequired

Body

accountstringRequired

Sender address

fromTokenAddressstringRequired

Source token contract address

toTokenAddressstringRequired

Target token contract address

amountstringRequired

Amount to swap

slippagestringRequired

Allowed slippage

referrerFeestringRequired

Referrer fee

networkstringRequired

Network name (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)

Responses

201

Transaction hash created

application/json

401

Unauthorized — missing or invalid API key

application/json

post

/v1/defi/transaction/swap

POST /v1/defi/transaction/swap HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 140

{
  "account": "text",
  "fromTokenAddress": "text",
  "toTokenAddress": "text",
  "amount": "text",
  "slippage": "text",
  "referrerFee": "text",
  "network": "text"
}

[
  "f9106a818b83989680830bd5ee946352a56caadc4f1e25cd6c75970...00000000000000000000000000000000000000000000000000000000000808080"
]

Send transaction

post

Broadcasts the client-signed transaction hash to the network to execute the swap.

Authorizations

x-api-keystringRequired

Body

accountstringRequired

Receiver address

amountFromstringRequired

Amount sent from sender

amountTostringRequired

Amount to be received

fromTokenAddressstringRequired

Source token contract address

toTokenAddressstringRequired

Target token contract address

networkstringRequired

Network name (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)

commissionPercentagestringRequired

Commission percentage

rawTxstringOptional

Raw transaction data

hashstringOptional

Transaction hash

tostringOptional

Recipient address (again, for compatibility)

isExchangebooleanOptional

If it is an approve transaction or any other transaction other than a swap, the flag must be false.

Responses

201

Transaction sent successfully

application/json

401

Unauthorized — missing or invalid API key

application/json

post

/v1/defi/transaction/send

POST /v1/defi/transaction/send HTTP/1.1
Host: api.baltex.io
x-api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 212

{
  "account": "text",
  "amountFrom": "text",
  "amountTo": "text",
  "fromTokenAddress": "text",
  "toTokenAddress": "text",
  "network": "text",
  "commissionPercentage": "text",
  "rawTx": "text",
  "hash": "text",
  "to": "text",
  "isExchange": true
}

0xc0fdaae6f89534be97b324acd22b41bb1d14ffd518346fd87947a7d88de07e2a