Ctrlk
Baltex Website
For the complete documentation index, see llms.txt. This page is also available as Markdown.

De Fi

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
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

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
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

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
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

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
totalintegerOptional

Total number of exchanges

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

application/json
string[] · min: 1 · max: 1Optional

Array containing swap raw transaction hash only (approval not required)

or
string[] · min: 2 · max: 2Optional

Array containing approval (1st string) and swap transaction (2nd string) raw transactions

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

Send approve transaction

post

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

Authorizations
x-api-keystringRequired
Body
networkstringRequired

Network name

rawApproveTxstringRequired

Raw approve transaction

Responses
201

Approve transaction sent successfully

application/json
stringOptional

Transaction hash

post/v1/defi/send/approve
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
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
stringOptional

Transaction hash

post/v1/defi/send/swap
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
PreviousCross Chain
NextModels

Last updated