Skip to main content
POST
/
v3
/
quote
curl --request POST \
  --url https://be.onebalance.io/api/v3/quote \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "from": {
    "accounts": [
      {
        "type": "solana",
        "accountAddress": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5"
      }
    ],
    "asset": {
      "assetId": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501"
    },
    "amount": "10000000"
  },
  "to": {
    "asset": {
      "assetId": "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
    },
    "account": "eip155:42161:0x895Cf62399bF1F8b88195E741b64278b41EB7F09"
  },
  "slippageTolerance": 100
}'
{
  "id": "0xcd3a5cfe80d1b84db755bfb8ebe0a617ff153cc48ab6d5ab28436386f06ce100",
  "accounts": [
    {
      "type": "solana",
      "accountAddress": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5"
    }
  ],
  "originChainsOperations": [
    {
      "type": "solana",
      "instructions": [
        {
          "keys": [
            {
              "pubkey": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5",
              "isSigner": true,
              "isWritable": true
            },
            {
              "pubkey": "8qtsCyJ4NCL4RMkVTnGtbkzrB92e4ztSQapVAVpG4yRi",
              "isSigner": false,
              "isWritable": true
            }
          ],
          "programId": "11111111111111111111111111111111",
          "data": "020000008096980000000000"
        },
        {
          "keys": [
            {
              "pubkey": "8qtsCyJ4NCL4RMkVTnGtbkzrB92e4ztSQapVAVpG4yRi",
              "isSigner": false,
              "isWritable": true
            }
          ],
          "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "data": "11"
        }
      ],
      "recentBlockHash": "2UoZifqUWTS8vZF25LrpJJUwabdDrfRqXSLMScDh4WDp",
      "feePayer": "6roz4r5VGs67YdDvjNdALSQgXZecwqUzpqvmKTdmjXyH",
      "signature": "2z1h92bonjpq5yELFiDfNgKoAFEp1MxU8qLuAV7RRbFDTHZ6Ts8AvGYBry7TR9doZK1ePMdWJGNt7XiNzU9wAd5B",
      "addressLookupTableAddresses": [
        "BpQ5uMzQNWNgBCRNf6jffChhYMX5XVZuaoM4Rx16NCdf"
      ],
      "assetType": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501",
      "amount": "10000000",
      "dataToSign": "gAIABQ1XDQTmmqW/djyUx9QxVovp4LBhd9nKW9lbKmZgBJpASP2prCGRAhJ2LZxv7WJqmNSI35tMGa1fy+dTOYTdb2um..."
    }
  ],
  "originToken": {
    "aggregatedAssetId": "ob:single",
    "assetType": [
      "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501"
    ],
    "amount": "10000000",
    "fiatValue": [
      {
        "assetType": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501",
        "amount": "10000000",
        "fiatValue": "1.67"
      }
    ]
  },
  "destinationToken": {
    "aggregatedAssetId": "ob:single",
    "assetType": "eip155:42161/erc20:0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
    "amount": "1570450",
    "minimumAmount": "1516171",
    "fiatValue": "1.57",
    "minimumFiatValue": "1.51",
    "recipientAccount": "eip155:42161:0x895Cf62399bF1F8b88195E741b64278b41EB7F09"
  },
  "expirationTimestamp": "1752673847",
  "slippage": {
    "origin": {
      "percent": "3.57",
      "usd": "0.059593",
      "value": "59761"
    },
    "destination": {
      "percent": "3.45",
      "usd": "0.054180",
      "value": "54279"
    }
  },
  "fees": {
    "assets": {
      "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/slip44:501": "183581",
      "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp/token:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": "93373"
    },
    "cumulativeUSD": "0.12"
  },
  "tamperProofSignature": "0x1ae7e61279f297d5e6bd702388db0069a3cc2b5168eecd91b53ea0b8bbdf7c412742dd8f0ab778c9a3faa7be38031ce6279b65c202b920c65632840accf01d021c"
}

Authorizations

​
x-api-key
string
header
required

The OneBalance API uses API keys to authenticate requests. All API requests require authentication using an API key passed in the x-api-key header:

curl -X 'GET' \
  'https://be.onebalance.io/api/path-to/endpoint' \
  -H 'x-api-key: ${ONEBALANCE_API_KEY}' \
  ...

A public API key is available for testing purposes with limited usage: 42bb629272001ee1163ca0dbbbc07bcbb0ef57a57baf16c4b1d4672db4562c11.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Learn how to generate API access tokens at OneBalance Docs.

Body

application/json

Quote request with support for multiple account types (v3)

​
from
object
required

Source configuration for the quote

​
to
object
required

Destination configuration for the quote

​
slippageTolerance
integer

Slippage tolerance in basis points (1/100th of a percent). For example, 50 = 0.5%, 100 = 1%, 1000 = 10%.

Required range: x >= 1
Example:

50

Response

Quote generated successfully

Quote response with support for multiple blockchain types (v3)

​
id
string
required

Unique quote identifier

Example:

"0xcd3a5cfe80d1b84db755bfb8ebe0a617ff153cc48ab6d5ab28436386f06ce100"

​
accounts
(Role-based Account · object | Basic Account · object | EIP-7702 Account · object | Solana Account · object)[]
required

Array of accounts used in this quote

Minimum length: 1
  • Role-based Account
  • Basic Account
  • EIP-7702 Account
  • Solana Account
Example:
[
  {
    "type": "solana",
    "accountAddress": "J5CCzBULFax899tcirb6wMbenQUd8whbaetG7EfSick5"
  }
]
​
originChainsOperations
object[]
required

Array of blockchain operations to execute, supporting both EVM and Solana

  • Option 1
  • Option 2
​
originToken
object
required
​
destinationToken
object
required
​
expirationTimestamp
string
required

Unix timestamp when the quote expires

Example:

"1752673847"

​
tamperProofSignature
string
required

Cryptographic signature to verify quote integrity

Example:

"0x1ae7e61279f297d5e6bd702388db0069a3cc2b5168eecd91b53ea0b8bbdf7c412742dd8f0ab778c9a3faa7be38031ce6279b65c202b920c65632840accf01d021c"

​
slippage
object

Slippage information for origin and destination

​
fees
object

Fee breakdown by asset type

⌘I