# DeFi

## Currency info

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

```json
{"openapi":"3.0.0","info":{"title":"Baltex Partner API","version":"1.0.0"},"servers":[{"url":"https://api.baltex.io"}],"security":[{"Partner access key":[]}],"components":{"securitySchemes":{"Partner access key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"DeFiCurrency":{"type":"object","properties":{"name":{"type":"string","description":"Full name of the token"},"address":{"type":"string","description":"Token contract address"},"decimals":{"type":"integer","description":"Number of decimal places for the token"},"symbol":{"type":"string","description":"Token symbol"},"network":{"type":"string","description":"Network ticker"},"enabled":{"type":"boolean","description":"Indicates if token is currently available for swaps"},"image":{"type":"string","description":"URL to the token icon"}}}},"responses":{"UnauthorizedError":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"}}}}}}}},"paths":{"/v1/defi/currency/info":{"get":{"description":"Returns a currency info for the specified network and address if it exists.","operationId":"DexController_getCurrencyInfo_v1","parameters":[{"name":"network","required":true,"in":"query","description":"Network ticker (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)","schema":{"type":"string"}},{"name":"address","required":true,"in":"query","description":"Token contract address","schema":{"type":"string"}}],"responses":{"200":{"description":"Currency information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeFiCurrency"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"summary":"Currency info","tags":["DeFi"]}}}}
```

## Available currencies

> Returns a list of available currencies for the specified network.

```json
{"openapi":"3.0.0","info":{"title":"Baltex Partner API","version":"1.0.0"},"servers":[{"url":"https://api.baltex.io"}],"security":[{"Partner access key":[]}],"components":{"securitySchemes":{"Partner access key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"DeFiCurrency":{"type":"object","properties":{"name":{"type":"string","description":"Full name of the token"},"address":{"type":"string","description":"Token contract address"},"decimals":{"type":"integer","description":"Number of decimal places for the token"},"symbol":{"type":"string","description":"Token symbol"},"network":{"type":"string","description":"Network ticker"},"enabled":{"type":"boolean","description":"Indicates if token is currently available for swaps"},"image":{"type":"string","description":"URL to the token icon"}}}},"responses":{"UnauthorizedError":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"}}}}}}}},"paths":{"/v1/defi/available-currencies":{"get":{"description":"Returns a list of available currencies for the specified network.","operationId":"DexController_getAvailableCurrenciesList_v1","parameters":[{"name":"network","required":true,"in":"query","description":"Network ticker (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)","schema":{"type":"string"}},{"name":"page","required":false,"in":"query","description":"Page number for pagination","schema":{"type":"string"}},{"name":"limit","required":false,"in":"query","description":"Number of items per page","schema":{"type":"string"}}],"responses":{"200":{"description":"List of available currencies for DeFi","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeFiCurrency"}}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"summary":"Available currencies","tags":["DeFi"]}}}}
```

## Swap quote

> Returns a quote for swapping tokens on a specified network.

```json
{"openapi":"3.0.0","info":{"title":"Baltex Partner API","version":"1.0.0"},"servers":[{"url":"https://api.baltex.io"}],"security":[{"Partner access key":[]}],"components":{"securitySchemes":{"Partner access key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"SwapQuote":{"type":"object","properties":{"fromAmount":{"type":"string","description":"Amount to swap from"},"usdFromAmount":{"type":"string","description":"USD value of from amount"},"toAmount":{"type":"string","description":"Estimated amount to receive"},"usdToAmount":{"type":"string","description":"USD value of to amount"},"receivedAmount":{"type":"string","description":"Actual amount user will receive after fees"},"fee":{"type":"string","description":"Fee amount"},"routes":{"type":"array","items":{"$ref":"#/components/schemas/SwapRoute"},"description":"Swap routes with DEX details"},"priceImpact":{"type":"string","description":"Price impact percentage"}}},"SwapRoute":{"type":"object","properties":{"percentage":{"type":"number","description":"Percentage of total swap using this route"},"subRoutes":{"type":"array","items":{"$ref":"#/components/schemas/SwapSubRoute"},"description":"Individual steps in the swap route"}}},"SwapSubRoute":{"type":"object","properties":{"from":{"type":"string","description":"Source token address in this step"},"to":{"type":"string","description":"Target token address in this step"},"dexes":{"type":"array","items":{"$ref":"#/components/schemas/SwapDexInfo"},"description":"DEXes used in this swap step"}}},"SwapDexInfo":{"type":"object","properties":{"name":{"type":"string","description":"DEX name"},"address":{"type":"string","description":"DEX contract address"},"fee":{"type":"number","description":"DEX fee percentage"},"percentage":{"type":"number","description":"Percentage of swap going through this DEX"}}}},"responses":{"UnauthorizedError":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"}}}}}}}},"paths":{"/v1/defi/quote":{"get":{"description":"Returns a quote for swapping tokens on a specified network.","operationId":"DexController_getQuote_v1","parameters":[{"name":"network","required":true,"in":"query","description":"Network name (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)","schema":{"type":"string"}},{"name":"fromTokenAddress","required":true,"in":"query","description":"Source token contract address","schema":{"type":"string"}},{"name":"toTokenAddress","required":true,"in":"query","description":"Target token contract address","schema":{"type":"string"}},{"name":"amount","required":true,"in":"query","description":"Amount to swap","schema":{"type":"string"}},{"name":"slippage","required":true,"in":"query","description":"Allowed slippage in percent","schema":{"type":"string"}},{"name":"referrerFee","required":true,"in":"query","description":"Referrer fee in percent","schema":{"type":"string"}}],"responses":{"200":{"description":"Swap quote","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapQuote"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"summary":"Swap quote","tags":["DeFi"]}}}}
```

## List of exchanges

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

```json
{"openapi":"3.0.0","info":{"title":"Baltex Partner API","version":"1.0.0"},"servers":[{"url":"https://api.baltex.io"}],"security":[{"Partner access key":[]}],"components":{"securitySchemes":{"Partner access key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"DexExchangeList":{"type":"object","properties":{"total":{"type":"integer","description":"Total number of exchanges"},"exchanges":{"type":"array","items":{"$ref":"#/components/schemas/DexExchange"},"description":"Array of DEX exchanges"}}},"DexExchange":{"type":"object","properties":{"id":{"type":"string","description":"Unique exchange identifier"},"created":{"type":"string","format":"date-time","description":"Exchange creation timestamp"},"updated":{"type":"string","format":"date-time","description":"Exchange last update timestamp"},"network":{"type":"string","description":"Network where exchange occurred"},"fromTokenAddress":{"type":"string","description":"Source token contract address"},"toTokenAddress":{"type":"string","description":"Target token contract address"},"amountFrom":{"type":"string","description":"Amount sent"},"amountTo":{"type":"string","description":"Amount received"},"addressFrom":{"type":"string","description":"Sender wallet address"},"addressTo":{"type":"string","nullable":true,"description":"Recipient wallet address"},"commissionPercentage":{"type":"string","description":"Commission percentage"},"status":{"type":"string","enum":["pending","confirming","finished","failed"],"description":"Exchange status"},"hash":{"type":"string","description":"Transaction hash"}}}},"responses":{"UnauthorizedError":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"}}}}}}}},"paths":{"/v1/defi/exchange/list":{"get":{"description":"Returns all DEX exchanges for partner from the last 24 hours with optional filters.","operationId":"DexController_getPartnerDexExchanges_v1","parameters":[{"name":"status","required":false,"in":"query","description":"Filter by exchange status","schema":{"type":"string"}},{"name":"fromTokenAddress","required":false,"in":"query","description":"Filter by source token address","schema":{"type":"string"}},{"name":"toTokenAddress","required":false,"in":"query","description":"Filter by target token address","schema":{"type":"string"}},{"name":"network","required":false,"in":"query","description":"Filter by network","schema":{"type":"string"}}],"responses":{"200":{"description":"List of DEX exchanges","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DexExchangeList"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"summary":"List of exchanges","tags":["DeFi"]}}}}
```

## Swap tokens

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

```json
{"openapi":"3.0.0","info":{"title":"Baltex Partner API","version":"1.0.0"},"servers":[{"url":"https://api.baltex.io"}],"security":[{"Partner access key":[]}],"components":{"securitySchemes":{"Partner access key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"SwapDexTransactionDto":{"type":"object","properties":{"account":{"type":"string","description":"Sender address"},"fromTokenAddress":{"type":"string","description":"Source token contract address"},"toTokenAddress":{"type":"string","description":"Target token contract address"},"amount":{"type":"string","description":"Amount to swap"},"slippage":{"type":"string","description":"Allowed slippage"},"referrerFee":{"type":"string","description":"Referrer fee"},"network":{"type":"string","description":"Network name (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)"}},"required":["account","fromTokenAddress","toTokenAddress","amount","slippage","referrerFee","network"]}},"responses":{"UnauthorizedError":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"}}}}}}}},"paths":{"/v1/defi/transaction/swap":{"post":{"description":"Build a transaction hash from the provided data and returns it to sign.","operationId":"DexController_swapTransaction_v1","parameters":[],"requestBody":{"required":true,"description":"Swap transaction data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SwapDexTransactionDto"}}}},"responses":{"201":{"description":"Transaction hash(es) created","content":{"application/json":{"schema":{"oneOf":[{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":1,"description":"Array containing swap raw transaction hash only (approval not required)"},{"type":"array","items":{"type":"string"},"minItems":2,"maxItems":2,"description":"Array containing approval (1st string) and swap transaction (2nd string) raw transactions"}]}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"summary":"Swap tokens","tags":["DeFi"]}}}}
```

## Send approve transaction

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

```json
{"openapi":"3.0.0","info":{"title":"Baltex Partner API","version":"1.0.0"},"servers":[{"url":"https://api.baltex.io"}],"security":[{"Partner access key":[]}],"components":{"securitySchemes":{"Partner access key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"SendDexApproveTransactionDto":{"type":"object","properties":{"network":{"type":"string","description":"Network name"},"rawApproveTx":{"type":"string","description":"Raw approve transaction"}},"required":["network","rawApproveTx"]}},"responses":{"UnauthorizedError":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"}}}}}}}},"paths":{"/v1/defi/send/approve":{"post":{"description":"Broadcasts the client-signed transaction hash to the network to approve token spending.","operationId":"DexController_sendApproveTransaction_v1","parameters":[],"requestBody":{"required":true,"description":"Approve transaction data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendDexApproveTransactionDto"}}}},"responses":{"201":{"description":"Approve transaction sent successfully","content":{"application/json":{"schema":{"type":"string","description":"Transaction hash"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"summary":"Send approve transaction","tags":["DeFi"]}}}}
```

## Send transaction

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

```json
{"openapi":"3.0.0","info":{"title":"Baltex Partner API","version":"1.0.0"},"servers":[{"url":"https://api.baltex.io"}],"security":[{"Partner access key":[]}],"components":{"securitySchemes":{"Partner access key":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"SendDexTransactionDto":{"type":"object","properties":{"account":{"type":"string","description":"Receiver address"},"amountFrom":{"type":"string","description":"Amount sent from sender"},"amountTo":{"type":"string","description":"Amount to be received"},"fromTokenAddress":{"type":"string","description":"Source token contract address"},"toTokenAddress":{"type":"string","description":"Target token contract address"},"network":{"type":"string","description":"Network name (Currently available: eth, sol, sui, sei, arbitrum, base, bsc, cchain, celo, linea, matic, op, sonic, uni)"},"commissionPercentage":{"type":"string","description":"Commission percentage"},"rawTx":{"type":"string","description":"Raw transaction data"},"hash":{"type":"string","description":"Transaction hash"},"to":{"type":"string","description":"Recipient address (again, for compatibility)"},"isExchange":{"type":"boolean","description":"If it is an approve transaction or any other transaction other than a swap, the flag must be false."}},"required":["account","amountFrom","amountTo","fromTokenAddress","toTokenAddress","network","commissionPercentage"]}},"responses":{"UnauthorizedError":{"description":"Unauthorized — missing or invalid API key","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"},"error":{"type":"string"},"statusCode":{"type":"integer"}}}}}}}},"paths":{"/v1/defi/send/swap":{"post":{"description":"Broadcasts the client-signed transaction hash to the network to execute the swap.","operationId":"DexController_sendTransaction_v1","parameters":[],"requestBody":{"required":true,"description":"Transaction data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendDexTransactionDto"}}}},"responses":{"201":{"description":"Transaction sent successfully","content":{"application/json":{"schema":{"type":"string","description":"Transaction hash"}}}},"401":{"$ref":"#/components/responses/UnauthorizedError"}},"summary":"Send transaction","tags":["DeFi"]}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.baltex.io/api-docs/defi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.