31Third.
  • 👋Introduction
    • About 31Third
    • Use cases
    • 0x Labs Collaboration
    • Architecture
    • Team
  • 🤝31Third API
    • Overview
    • Healthcheck
    • Assets
      • Wallet
      • Enzyme
    • Swap
      • Get started
      • price
      • quote
    • Basket Trade (m:n swap)
      • async
      • Wallet
      • Enzyme
      • SetProtocol
    • Refresh Quotes
    • RFQ
  • ⛓️Protocol
    • Overview
    • Contracts
      • BatchTrade
      • Owner Privilege
    • Prohibition
    • Audit
    • Statistics
      • Gas cost analysis
    • Fees
  • 📚Resources
    • FAQ
    • Start trading
    • Discord
    • Twitter
Powered by GitBook
On this page
  1. 31Third API

Refresh Quotes

PreviousSetProtocolNextRFQ

Last updated 1 year ago

After you calculated a rebalancing it might be that you have to refresh quotes. For example if you have a user interface and user don't directly execute received rebalancings.

Currently we consider rebalancings to be valid for 5 minutes however quotes should be refresed more often. A good starting point would be 20 or 30 seconds. (Make sure to not fire refresh calls to our API every second or you might get blocked.)

🤝

Refresh the quotes of a previously calculated rebalancing

get
Query parameters
rebalancingIdstringRequired

ID of a previously calculated rebalancing

Header parameters
x-api-keystringOptional

31Third API key (Request via dev@31third.com)

chain-idstringOptional

Chain ID as hex string. (e.g.: 0x1 for Ethereum mainnet)

Responses
200Success
application/json
get
GET /0.1/rebalancing/refresh-expired-quotes?rebalancingId=text HTTP/1.1
Host: 
Accept: */*
200Success
{
  "trades": [
    {
      "id": "0096124c-19df-4459-8cbb-7615fdc7c157",
      "from": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "fromAmount": "100000000",
      "toAmount": "99500000",
      "minToReceive": "99000000",
      "toValueInEth": "69500000000000000",
      "fromValueInUsd": 100,
      "toValueInUsd": 99.5,
      "minToReceiveInUsd": 99,
      "calculatedLossPercentage": 0.005,
      "maxSlippage": 0.01,
      "price": 0.999955,
      "guaranteedPrice": 0.99,
      "previouslyRequiredTrades": [],
      "allowanceTarget": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
      "estimatedFees": "5000000000000000",
      "txData": "0x6af479b200000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000005f5e1000000000000000000000000000000000000000000000000000000000005e68d620000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002bdac17f958d2ee523a2206206994597c13d831ec70001f4a0b86991c6218b36c1d19d4a2e9eb0ce3606eb48000000000000000000000000000000000000000000869584cd00000000000000000000000058ee0e1efcb86ad60d4df3c8a32b398887bb148b0000000000000000000000000000000000000000000000de6f27846963566719",
      "txHandler": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
      "expirationTimestamp": "2025-05-17T06:57:44.570Z",
      "transactions": [
        "text"
      ]
    }
  ],
  "txHandler": "text",
  "txData": {},
  "txValue": 1
}