Refresh Quotes
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.)
Query parameters
rebalancingIdstringRequired
ID of a previously calculated rebalancing
Header parameters
x-api-keystringOptional
31Third API key (Request via [email protected])
chain-idstringOptional
Chain ID as hex string. (e.g.: 0x1 for Ethereum mainnet)
Responses
200Success
application/json
get
GET /1.3/rebalancing/refresh-expired-quotes?rebalancingId=text HTTP/1.1
Host:
Accept: */*
200Success
{
"id": "0096124c-19df-4459-8cbb-7615fdc7c157",
"creationDate": "2025-09-18T16:10:51.060Z",
"baseValueInUsd": 12345.67,
"sellValueInUsd": 12345.67,
"estimatedValueLossInUsd": 12.34,
"estimatedTargetValueInUsd": 12345.67,
"estimatedReceiveValueInUsd": 12345.67,
"minReceiveValueInUsd": 12325.67,
"estimatedImpact": 0.0023,
"maxImpact": 0.0027,
"estimatedGasUnits": "20000000000000000",
"suggestedGasPrice": "20000000000000000",
"estimatedGasFees": "20000000000000000",
"estimatedGasFeesInUsd": 23.45,
"estimatedProtocolFeesInUsd": 23.45,
"requiredAllowances": [
{
"token": {
"address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
"name": "Shiba Inu",
"symbol": "SHIB",
"imageUrl": "https://assets.31third.com/images/tokens/SHIB.svg",
"decimals": 18,
"sliderColor": "#C47438",
"chain": {
"name": "Ethereum",
"identifier": "0x1",
"enabled": true,
"batchTradeSupported": true,
"batchTradeAddress": "0x1ee8b39f09c5299526db65428ab2a8a23ebf08a7",
"blockExplorerLink": "https://etherscan.io",
"nativeTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"wrappedNativeTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenHelperAddress": "0x6af90502f49E3B4151018F7aE82d10079c29Bc97",
"portfolioEnabled": true
},
"tags": [
"text"
],
"deflationary": true
},
"allowanceTarget": "text",
"neededAllowance": 1,
"currentAllowance": 1,
"resetNeeded": true
}
],
"trades": [
{
"from": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"to": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"fromAmount": "100000000",
"toAmount": "99500000",
"minToReceiveBeforeFees": "99000000",
"minToReceive": "99000000",
"fromValueInUsd": 100,
"toValueInUsd": 99.5,
"minToReceiveBeforeFeesInUsd": 99,
"minToReceiveInUsd": 99,
"estimatedPriceImpact": 0.005,
"maxSlippage": 0.005,
"price": 0.999955,
"guaranteedPrice": 0.99,
"previouslyRequiredTrades": [],
"allowanceTarget": "0xdef1c0ded9bec7f1a1670819833240f027b25eff",
"estimatedGasUnits": "5000000000000000",
"suggestedGasPrice": "5000000000000000",
"estimatedGasFees": "5000000000000000",
"expirationTimestamp": "2025-09-18T16:10:51.060Z",
"transactions": [
"text"
],
"fill": {
"liquiditySource": {
"identifier": "text",
"readableName": "text",
"iconUrl": "text",
"enabled": true
},
"proportionInBps": 1,
"from": {
"address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
"name": "Shiba Inu",
"symbol": "SHIB",
"imageUrl": "https://assets.31third.com/images/tokens/SHIB.svg",
"decimals": 18,
"sliderColor": "#C47438",
"chain": {
"name": "Ethereum",
"identifier": "0x1",
"enabled": true,
"batchTradeSupported": true,
"batchTradeAddress": "0x1ee8b39f09c5299526db65428ab2a8a23ebf08a7",
"blockExplorerLink": "https://etherscan.io",
"nativeTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"wrappedNativeTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenHelperAddress": "0x6af90502f49E3B4151018F7aE82d10079c29Bc97",
"portfolioEnabled": true
},
"tags": [
"text"
],
"deflationary": true
},
"to": {
"address": "0x95ad61b0a150d79219dcf64e1e6cc01f0b64c4ce",
"name": "Shiba Inu",
"symbol": "SHIB",
"imageUrl": "https://assets.31third.com/images/tokens/SHIB.svg",
"decimals": 18,
"sliderColor": "#C47438",
"chain": {
"name": "Ethereum",
"identifier": "0x1",
"enabled": true,
"batchTradeSupported": true,
"batchTradeAddress": "0x1ee8b39f09c5299526db65428ab2a8a23ebf08a7",
"blockExplorerLink": "https://etherscan.io",
"nativeTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"wrappedNativeTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"tokenHelperAddress": "0x6af90502f49E3B4151018F7aE82d10079c29Bc97",
"portfolioEnabled": true
},
"tags": [
"text"
],
"deflationary": true
},
"subFills": [
"text"
]
}
}
],
"txHandler": "text",
"txData": {},
"txValue": 1,
"tokensWithoutPricePair": [
"0x3ed3b47dd13ec9a98b44e6204a523e766b225811"
],
"executable": [
"true"
],
"expirationTimestamp": "2025-09-17T15:55:33.069Z",
"earliestRefreshQuotesTimestamp": "2025-09-18T16:10:51.060Z",
"suggestedRefreshQuotesTimestamp": "2025-09-18T16:10:51.060Z",
"tenderlySimulation": {
"status": true,
"errorMessage": "text",
"blockNumber": 313313,
"gas": "313313",
"gasUsed": "310313"
}
}Last updated