{"uid":"cap_ruGd4YM7gM0E2FvnyfXli","slug":"api-quantoracle-dev-15a20c27","name":"QuantOracle Crypto Rebalance Threshold","description":"QuantOracle: crypto/rebalance-threshold","url":"https://api.quantoracle.dev/v1/crypto/rebalance-threshold","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"holdings":{"type":"array","items":{"type":"object","title":"Holding","required":["asset","current_value","target_weight"],"properties":{"asset":{"type":"string","title":"Asset","description":"Asset name or ticker"},"current_value":{"type":"number","title":"Current Value","description":"Current value in USD"},"target_weight":{"type":"number","title":"Target Weight","description":"Target portfolio weight (0-1)"}}},"title":"Holdings","description":"Array of current portfolio holdings"},"min_trade_usd":{"type":"number","title":"Min Trade Usd","default":10,"description":"Minimum trade size in USD"},"threshold_pct":{"type":"number","title":"Threshold Pct","default":5,"description":"Rebalance trigger threshold as percentage"}}},"responseSchema":null,"example":{"request":{"holdings":[{"asset":"BTC","current_value":48000,"target_weight":40,"current_weight":48},{"asset":"ETH","current_value":27000,"target_weight":30,"current_weight":27},{"asset":"USDC","current_value":25000,"target_weight":30,"current_weight":25}],"min_trade_usd":50,"transaction_cost_pct":0.25},"response":{"ms":25.28,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"trades":[{"asset":"BTC","action":"SELL","amount":8000},{"asset":"ETH","action":"BUY","amount":3000},{"asset":"USDC","action":"BUY","amount":5000}],"turnover_pct":8,"max_drift_pct":8,"total_turnover":16000,"drift_per_asset":[{"asset":"BTC","drift_pct":8,"target_weight":40,"current_weight":48},{"asset":"ETH","drift_pct":-3,"target_weight":30,"current_weight":27},{"asset":"USDC","drift_pct":-5,"target_weight":30,"current_weight":25}],"needs_rebalance":true}},"exampleRequest":{"holdings":[{"asset":"BTC","current_value":48000,"target_weight":40,"current_weight":48},{"asset":"ETH","current_value":27000,"target_weight":30,"current_weight":27},{"asset":"USDC","current_value":25000,"target_weight":30,"current_weight":25}],"min_trade_usd":50,"transaction_cost_pct":0.25},"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_62okpGvfcgGMq_7wop3aB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates optimal rebalancing threshold percentages for a cryptocurrency portfolio to minimize drift and transaction costs","exampleAgentPrompt":"What's the optimal rebalancing threshold for my crypto portfolio with target weights of 50% BTC, 30% ETH, and 20% SOL, assuming transaction fees of 0.25% per trade and a monthly rebalancing review?","exampleUseCases":null,"resultDescription":"Returns a computed rebalancing threshold — the percentage drift from target allocations that should trigger a rebalance — along with cost-adjusted trigger bands and a recommended tolerance range that balances tracking error against transaction costs.","failureModes":["Invalid or missing portfolio weights that don't sum to 100% — returns 400 validation error","Negative or zero transaction cost values — returns 400 bad request","Unsupported asset tickers or unrecognized crypto symbols — returns 422 unprocessable entity","Malformed request body or missing required fields — returns 400 with field-level error details","Service unavailability or timeout — returns 503 or 504"],"whenToPreferThis":"Use this endpoint when you need a mathematically grounded, cost-aware rebalancing threshold for a crypto portfolio rather than using a fixed arbitrary percentage. It is especially useful when transaction fees vary and you want to avoid over-trading. Prefer this over generic portfolio tools when working specifically with crypto assets and needing a quantitative trigger level.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:54:57.418Z","isFirstParty":false}