Skip to main content
In this section, you’ll learn how to request quotes for swapping between tokens using the Deframe API.

​
Prerequisites

API Key

Get your API key for authentication at Deframe

Token Addresses

Contract addresses for the tokens you want to swap

Chain IDs

Chain IDs for source and destination chains

Authentication

Include your API key in the x-api-key header

​
Overview

The Deframe API supports both same-chain and cross-chain token swaps. The system automatically detects the swap type based on the chain IDs provided and routes to the appropriate provider.
Same-chain Swap: When originChain equals destinationChain Cross-chain Swap: When originChain differs from destinationChain

​
Getting a Quote

​
Endpoint

GET /v2/swap/quote
This is a v2 endpoint. Always use /v2/swap/quote for new integrations — it saves quotes to the database and returns a quoteId required by POST /v2/swap/bytecode.

​
Required Parameters

ParameterTypeDescriptionExample
originChainstringSource chain nameethereum, polygon, arbitrum
tokenInstringContract address of input token0xdAC17F958D2ee523a2206206994597C13D831ec7 (USDT)
amountInstringAmount in token’s smallest unit. Provide either amountIn or amountOut, not both.1000000 (1 USDT with 6 decimals)
amountOutstringExact output amount (alternative to amountIn)998500
destinationChainstringTarget chain namepolygon, ethereum, base
tokenOutstringContract address of output token0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174 (USDC)
Either amountIn OR amountOut is required (not both). Use amountOut for exact output swaps (“I want to receive exactly X tokens”).

​
Example Requests

​
Same-Chain Swap (Ethereum USDT to USDC)

curl --request GET \
  --url 'https://api.deframe.io/v2/swap/quote?originChain=ethereum&destinationChain=ethereum&tokenIn=0xdAC17F958D2ee523a2206206994597C13D831ec7&tokenOut=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48&amountIn=1000000' \
  --header 'x-api-key: YOUR_API_KEY'

​
Cross-Chain Swap (Ethereum to Polygon)

curl --request GET \
  --url 'https://api.deframe.io/v2/swap/quote?originChain=ethereum&destinationChain=polygon&tokenIn=0xdAC17F958D2ee523a2206206994597C13D831ec7&tokenOut=0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174&amountIn=1000000' \
  --header 'x-api-key: YOUR_API_KEY'

​
Response Format

The API returns a JSON object containing the quote details: 
{
  "quote": {
    "quoteId": "550e8400-e29b-41d4-a716-446655440000",
    "originChain": "ethereum",
    "destinationChain": "polygon",
    "tokenIn": {
      "contract": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "symbol": "USDT",
      "decimals": 6,
      "amount": "1000000",
      "chainId": 1
    },
    "tokenOut": {
      "contract": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
      "symbol": "USDC",
      "decimals": 6,
      "amount": "998500",
      "chainId": 137
    },
    "provider": "TeleSwap",
    "deadline": 1706098500,
    "status": "pending",
    "feeSponsorship": false
  }
}

​
Response Fields

Unique identifier for this quote. Use this when executing the swap.
Source and destination chain names (e.g., ethereum, polygon, arbitrum)
Complete token information including contract address, symbol, decimals, amount, and chain ID
Name of the swap provider used (e.g., 1inch, Jupiter, TeleSwap, Mayan)
Quote expiration as a Unix timestamp in seconds. Execute the swap before this time.
Provider-specific quote data (stringified JSON). Some bridge providers require this for bytecode generation. This field is omitted from the response when null — only pass it to the bytecode endpoint when present.

​
Supported Chains

Ethereum

ethereum
https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/base.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=756b940eb5231e1cc1e73f57ce2404f2

Base

base
https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/optimism.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=ebc2c01e20f0ea367f9f3a01ff78d388

Optimism

optimism
https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/arbitrum.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=64fe30eadfd3165f4cf0a26a65a3983c

Arbitrum

arbitrum
https://mintlify.s3.us-west-1.amazonaws.com/pods-322144f0/images/networks/solana.svg

Solana

solana
https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/polygon.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=f07eb2cb5771381174b2457ccc35f430

Polygon

polygon
https://mintcdn.com/pods-322144f0/VaCfstjR8UDukAyQ/images/networks/gnosis.svg?fit=max&auto=format&n=VaCfstjR8UDukAyQ&q=85&s=1d3db921f11b6e2fcc8abf98a3f60539

Gnosis

gnosis
https://mintlify.s3.us-west-1.amazonaws.com/pods-322144f0/images/networks/bitcoin.svg

Bitcoin

bitcoin

​
Error Handling

The API returns appropriate error messages for:
  • Missing required parameters
  • Invalid chain names or token addresses
  • No available swap provider for the requested route
  • Provider-specific errors during quote generation
Example Error Response: 
{
  "error": {
    "code": "NO_ROUTE_FOUND",
    "message": "No swap route available between specified chains",
    "httpStatus": 400,
    "details": null
  }
}
Amount limit errors:
Error CodeMessage
AMOUNT_IN_TOO_HIGHAmountIn must be less than 5k USDC
AMOUNT_OUT_TOO_HIGHAmountOut must be less than 26k BRLA
Quotes have an expiration time (typically 5 minutes). Make sure to execute the swap before the deadline timestamp.

​
Next Steps

Execute Swap

Use the quote to generate bytecode and execute the swap

API Reference

View detailed API documentation