DeFi

Currency info

get

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

Authorizations

Partner access key

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

namestringOptional

Full name of the token

addressstringOptional

Token contract address

decimalsintegerOptional

Number of decimal places for the token

symbolstringOptional

Token symbol

networkstringOptional

Network ticker

enabledbooleanOptional

Indicates if token is currently available for swaps

imagestringOptional

URL to the token icon

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/currency/info

HTTPcURLJavaScriptPython

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

Partner access key

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

namestringOptional

Full name of the token

addressstringOptional

Token contract address

decimalsintegerOptional

Number of decimal places for the token

symbolstringOptional

Token symbol

networkstringOptional

Network ticker

enabledbooleanOptional

Indicates if token is currently available for swaps

imagestringOptional

URL to the token icon

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/available-currencies

HTTPcURLJavaScriptPython

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

Partner access key

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

fromAmountstringOptional

Amount to swap from

usdFromAmountstringOptional

USD value of from amount

toAmountstringOptional

Estimated amount to receive

usdToAmountstringOptional

USD value of to amount

receivedAmountstringOptional

Actual amount user will receive after fees

feestringOptional

Fee amount

priceImpactstringOptional

Price impact percentage

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/quote

HTTPcURLJavaScriptPython

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

Partner access key

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

totalintegerOptional

Total number of exchanges

401

Unauthorized — missing or invalid API key

application/json

get

/v1/defi/exchange/list

HTTPcURLJavaScriptPython

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

Partner access key

x-api-keystringRequired

Body

application/json

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(es) created

application/json

401

Unauthorized — missing or invalid API key

application/json

post

/v1/defi/transaction/swap

HTTPcURLJavaScriptPython

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..."
]

Send approve transaction

post

Broadcasts the client-signed transaction hash to the network to approve token spending.

Authorizations

Partner access key

x-api-keystringRequired

Body

application/json

networkstringRequired

Network name

rawApproveTxstringRequired

Raw approve transaction

Responses

201

Approve transaction sent successfully

application/json

401

Unauthorized — missing or invalid API key

application/json

post

/v1/defi/send/approve

HTTPcURLJavaScriptPython

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

{
  "network": "text",
  "rawApproveTx": "text"
}

0xcbd9cb094a9b2f5d1511a5c9266e8ea8f76f079fdf685d557c2ee6166c30fa86

Send transaction

post

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

Authorizations

Partner access key

x-api-keystringRequired

Body

application/json

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/send/swap

HTTPcURLJavaScriptPython

POST /v1/defi/send/swap 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