LogoLogo
  • Introduction to Unizen
    • Unizen Overview
      • Unizen Liquidity Distribution Mechanism (ULDM)
        • ULDM Performance
      • Unizen Interoperability Protocol (UIP)
        • LayerZero
        • DeBridge
        • Stargate
        • Celer
        • Axelar
        • Thorchain
    • Unizen Dashboard
      • General
      • Portfolio
      • History
    • Unizen Trade
      • Fees
    • Unizen Explore
      • Unizen Omni-Chain Data Pool
    • Unizen Earn
  • ZCX
    • Token Utility
    • Tokenomics
  • API - Introduction
    • Introduction
    • Before you get started
      • Understanding Price Impact and Price Slippage in Token Swaps
      • Token Allowance Management for Non-updatable Allowance Tokens
      • Tokens with taxes
      • Wrapping and Unwrapping Native Tokens
      • Quote expiration deadline
    • Security Best Practices for Integrating Unizen
      • Why disable CORS
      • How to integrate with a reverse proxy
    • Version 2 of our smart contracts
      • Migration to smart contract v2
  • API - GET STARTED
    • QuickStart guide
    • Swagger
    • Information endpoints
      • GET /trade/v1/info/chains
      • GET /trade/v1/info/sources
      • GET/v1/info/cross-providers
      • GET /trade/v1/info/token/search
      • GET /v1/info/token/popular
      • GET /trade/v1/info/token/{chainId}/{tokenAddress}
      • GET /trade/v1/info/tokenLogo/{chainId}/{tokenAddress}
      • GET /info/thorchain-inbound-address
      • GET /trade/v1/info/tx/{txHash}
      • GET /trade/v1/info/trade/{chainId}/{txHash}
      • GET /trade/v1/info/trades
    • Approval
      • GET /trade/v1/{chainId}/approval/spender
      • GET /trade/v1/{chainId}/approval/transaction
      • GET /trade/v1/{chainId}/approval/allowance
    • Single-Chain Swap
      • GET /trade/v1/{chainId}/quote/single
      • GET /trade/v1/{chainId}/swap/single
      • Send transaction in evm chains
      • Send transaction in Solana
    • Cross-Chain Swap
      • GET /trade/v1/{chainId}/quote/cross
      • GET /trade/v1/{chainId}/swap/cross
      • Send transaction
    • Gasless orders
      • POST /trade/v1/gasless/typed-data
      • POST /v1/gasless/estimate
      • POST /v1/gasless/create
      • POST /v1/gasless/cancel
      • GET /trade/v1/gasless/status/{orderId}
      • GET /v1/gasless/orderByAddress/{address}
    • UTXO Assets and Cosmos Swap
      • GET /trade/v1/{chainId}/quote/cross 1
      • GET /trade/v1/{chainId}/swap/cross
      • Sending transactions
    • Efficient Quote Retrieval with Batch Processing
      • GET /trade/v1/{chainId}/batch_quote/single
    • Error Messages
  • GASLESS TRADES
    • Obtaining gasless quotes
    • Gas estimation
    • Executing the trade
    • Following the orders
  • On-Chain Contracts - Get Started
    • Integration with Unizen Contracts for Token Swapping
    • Registering Errors on Smart Contract Calls
  • PERMIT2
    • What is Permit2?
    • Usage in our api
  • WIDGET - Get Started
    • Embed the Unizen Widget
    • Playground
  • Other
    • Smart Contracts
    • Security Audits
    • Roadmap
  • links
    • Unizen
    • Marketing Website
    • Medium
    • Twitter
    • Discord
    • Telegram
Powered by GitBook
On this page

Was this helpful?

  1. API - GET STARTED

Single-Chain Swap

Unizen API for Dex Aggregator Single-Chain Transaction

This document provides an overview of the Unizen API for single-chain transactions via the Unizen DEX aggregator. The API provides access to all available quotes for a trade from supported DEXes, as well as the ability to generate transaction data for a trade.

Unizen's trading architecture is decentralized, providing access to over 20,000 digital assets across more than 160 decentralized exchanges and 7 blockchains. This allows users to get the most out of their trades and easily access digital assets on any supported blockchain.

Available Endpoints

The Unizen API for single-chain transactions provides the following endpoints:

  • GET /trade/v1/{chainId}/quote/single: Find all available quotes for a single-chain trade via the Unizen DEX aggregator.

  • GET /trade/v1/{chainId}/swap/single: Generate transaction data for a single-chain trade via the Unizen DEX aggregator.

Network

Quote Endpoint

Swap Endpoint

Ethereum (Mainnet)

/trade/v1/1/quote/single

/trade/v1/1/swap/single

Polygon

/trade/v1/137/quote/single

/trade/v1/137/swap/single

Binance Smart Chain

/trade/v1/56/quote/single

/trade/v1/56/swap/single

Optimism

/trade/v1/10/quote/single

/trade/v1/10/swap/single

Fantom

/trade/v1/250/quote/single

/trade/v1/250/swap/single

Avalanche

/trade/v1/43114/quote/single

/trade/v1/43114/swap/single

Arbitrum

/trade/v1/42161/quote/single

/trade/v1/42161/swap/single

Using the Unizen API for Single-Chain Transactions

  1. Call GET /trade/v1/{chainId}/quote/single to get all available quotes for a single-chain trade via the Unizen DEX aggregator.

  2. Call GET /trade/v1/{chainId}/swap/single to generate transaction data for a single-chain trade via the Unizen DEX aggregator.

  3. Send the transaction to the DEX aggregator contract using the sendTransaction function, passing in the from address, to address, data, gasPrice, gasLimit, and value parameters.

Note: you can avoid calling the 2nd step (swap call) if you pass the sender and the parameter disableEstimateGas=false to the quote endpoint, so you will get the gas estimation and the transaction data to conduct the trade

Minimum Trade Amount:

  • The minimum amount to trade is $1 (in USD value of tokens). Trades with amounts below this limit are not allowed.

Solana

You can get quotes and execute trades on supported EVM chains (Ethereum, BSC, Polygon, Berachain, etc.) as well as on Solana. The process is identical for both, except for the final step—sending the confirmation to the user's wallet. This step requires different handling depending on whether the chain is EVM-based or Solana. The details are explained in the following articles.

Important: the chain id for Solana is -846853820

PreviousGET /trade/v1/{chainId}/approval/allowanceNextGET /trade/v1/{chainId}/quote/single

Last updated 1 month ago

Was this helpful?