{"openapi":"3.1.0","info":{"title":"FeeEdge Tools API","version":"1.0.0","description":"Public, read-only calculators and USDT transfer observations. No account or API key required. Use the canonical source pages for context and citations."},"servers":[{"url":"https://feeedge.com"}],"externalDocs":{"url":"https://feeedge.com/developers"},"paths":{"/api/v1/trade-calculator":{"post":{"operationId":"calculateTrade","summary":"Estimate after-fee risk and reward for one trade","description":"Uses supplied prices, fees and execution allowance. Returns position size, stop loss, net target profit, break-even price and break-even win rate. Funding and liquidation are outside this model.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"market":{"type":"string","enum":["spot","futures"],"description":"Spot or linear perpetual futures."},"side":{"type":"string","enum":["long","short"],"description":"Spot supports long only."},"currency":{"type":"string","enum":["USD","USDT"]},"entry":{"type":"number","minimum":1e-8,"maximum":1000000000000,"description":"Entry price in quote currency per unit."},"stop":{"type":"number","minimum":1e-8,"maximum":1000000000000,"description":"Stop price in quote currency per unit."},"target":{"type":"number","minimum":1e-8,"maximum":1000000000000,"description":"Target price in quote currency per unit."},"risk":{"type":"number","minimum":0.01,"maximum":1000000000,"description":"Risk budget in quote currency, including modeled costs at the stop."},"entryFeePct":{"type":"number","minimum":-10,"maximum":10,"description":"Percentage points per fill. Enter 0.05 for 0.05%. Negative values are rebates."},"exitFeePct":{"type":"number","minimum":-10,"maximum":10,"description":"Percentage points per fill. Enter 0.05 for 0.05%. Negative values are rebates."},"executionPct":{"type":"number","minimum":0,"maximum":10,"description":"Spread and slippage allowance in percentage points per side."}},"required":["market","side","currency","entry","stop","target","risk","entryFeePct","exitFeePct","executionPct"],"additionalProperties":false}}}},"responses":{"200":{"description":"Completed scenario with a canonical source page.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"result":{"type":"object","properties":{"quantity":{"type":"number","description":"Position size in base units."},"notional":{"type":"number","description":"Amount in the requested quote currency."},"grossProfit":{"type":"number","description":"Amount in the requested quote currency."},"entryFee":{"type":"number","description":"Amount in the requested quote currency."},"stopFee":{"type":"number","description":"Amount in the requested quote currency."},"targetFee":{"type":"number","description":"Amount in the requested quote currency."},"stopExecution":{"type":"number","description":"Amount in the requested quote currency."},"targetExecution":{"type":"number","description":"Amount in the requested quote currency."},"targetProfit":{"type":"number","description":"Amount in the requested quote currency."},"stopLoss":{"type":"number","description":"Amount in the requested quote currency."},"breakEven":{"type":"number","description":"Break-even exit price in quote currency per unit."},"breakEvenWinRate":{"anyOf":[{"type":"number","minimum":0,"maximum":1},{"type":"null"}],"description":"Fraction from 0 to 1. Null means the modeled target loses money after costs."},"grossRR":{"type":"number","description":"Gross reward-to-risk ratio."},"netRR":{"type":"number","description":"After-cost reward-to-risk ratio."}},"required":["quantity","notional","grossProfit","entryFee","stopFee","targetFee","stopExecution","targetExecution","targetProfit","stopLoss","breakEven","breakEvenWinRate","grossRR","netRR"]},"source":{"type":"string"}},"required":["result","source"]}}}},"400":{"description":"Invalid JSON, fields, or values.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}},"415":{"description":"Content type must be application/json.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}},"422":{"description":"Inputs do not form a supported scenario.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}}}}},"/api/v1/strategy-cost-calculator":{"post":{"operationId":"estimateStrategy","summary":"Estimate strategy costs and break-even gross return","description":"Uses supplied fees and a fixed position size without compounding. Funding is an optional signed cost assumption. Monthly outcomes estimate the entered scenario.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"market":{"type":"string","enum":["spot","futures"],"description":"Spot or linear perpetual futures."},"grossPct":{"type":"number","minimum":-100,"maximum":100,"description":"Average gross return per completed trade in percentage points."},"positionUsd":{"type":"number","minimum":0.01,"maximum":1000000000,"description":"Fixed USD notional per trade."},"trades":{"type":"integer","minimum":1,"maximum":100000,"description":"Completed round trips per month."},"entryFeePct":{"type":"number","minimum":-10,"maximum":10,"description":"Percentage points per fill. Enter 0.05 for 0.05%. Negative values are rebates."},"exitFeePct":{"type":"number","minimum":-10,"maximum":10,"description":"Percentage points per fill. Enter 0.05 for 0.05%. Negative values are rebates."},"executionPct":{"type":"number","minimum":0,"maximum":10,"description":"Spread and slippage allowance in percentage points per side."},"funding":{"description":"Optional scenario for perpetual futures. Leave absent for spot or to exclude funding.","type":"object","properties":{"costPct8h":{"type":"number","minimum":-10,"maximum":10,"description":"Assumed funding cost per 8 hours in percentage points. Positive pays and negative receives."},"holdHours":{"type":"number","minimum":0,"maximum":8760,"description":"Modeled holding time per trade, in hours."}},"required":["costPct8h","holdHours"],"additionalProperties":false}},"required":["market","grossPct","positionUsd","trades","entryFeePct","exitFeePct","executionPct"],"additionalProperties":false}}}},"responses":{"200":{"description":"Completed scenario with a canonical source page.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"result":{"type":"object","properties":{"grossPct":{"type":"number","description":"Percentage points per round trip."},"feePct":{"type":"number","description":"Percentage points per round trip."},"executionPct":{"type":"number","description":"Percentage points per round trip."},"fundingPct":{"type":"number","description":"Percentage points per round trip."},"breakEvenPct":{"type":"number","description":"Percentage points per round trip."},"netPct":{"type":"number","description":"Percentage points per round trip."},"grossMonthly":{"type":"number","description":"Estimated USD per month."},"feesMonthly":{"type":"number","description":"Estimated USD per month."},"executionMonthly":{"type":"number","description":"Estimated USD per month."},"fundingMonthly":{"type":"number","description":"Estimated USD per month."},"netMonthly":{"type":"number","description":"Estimated USD per month."},"roundTripVolume":{"type":"number","description":"Estimated USD per month."}},"required":["grossPct","feePct","executionPct","fundingPct","breakEvenPct","netPct","grossMonthly","feesMonthly","executionMonthly","fundingMonthly","netMonthly","roundTripVolume"]},"source":{"type":"string"}},"required":["result","source"]}}}},"400":{"description":"Invalid JSON, fields, or values.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}},"413":{"description":"Request body exceeds 4096 bytes.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}},"415":{"description":"Content type must be application/json.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}},"422":{"description":"Inputs do not form a supported scenario.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"},"details":{"type":"array","items":{"type":"string"}}},"required":["error"]}}}}}}},"/api/transfer-catalogues":{"get":{"operationId":"getUsdtTransferCatalogues","summary":"Read public USDT network observations from Bitget, HTX and KuCoin","description":"Only Ethereum ERC20 and Tron TRC20 are covered. Null or absent data means unavailable or unverified. A numeric zero is a reported value. Verify availability with both exchanges before transferring.","responses":{"200":{"description":"At least one exchange was observed. Individual rails may be unavailable.","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"bitget":{"anyOf":[{"type":"object","properties":{"checkedAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unix timestamp in milliseconds. Treat observations older than two minutes as stale."},"networks":{"type":"object","properties":{"erc20":{"type":"object","properties":{"depositMinimum":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},{"type":"null"}]},"withdrawal":{"anyOf":[{"type":"object","properties":{"fee":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"minimum":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"step":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."}},"required":["fee","minimum","step"]},{"type":"null"}]}},"required":["depositMinimum","withdrawal"]},"trc20":{"type":"object","properties":{"depositMinimum":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},{"type":"null"}]},"withdrawal":{"anyOf":[{"type":"object","properties":{"fee":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"minimum":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"step":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."}},"required":["fee","minimum","step"]},{"type":"null"}]}},"required":["depositMinimum","withdrawal"]}}}},"required":["checkedAt","networks"]},{"type":"null"}]},"htx":{"anyOf":[{"type":"object","properties":{"checkedAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unix timestamp in milliseconds. Treat observations older than two minutes as stale."},"networks":{"type":"object","properties":{"erc20":{"type":"object","properties":{"depositMinimum":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},{"type":"null"}]},"withdrawal":{"anyOf":[{"type":"object","properties":{"fee":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"minimum":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"step":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."}},"required":["fee","minimum","step"]},{"type":"null"}]}},"required":["depositMinimum","withdrawal"]},"trc20":{"type":"object","properties":{"depositMinimum":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},{"type":"null"}]},"withdrawal":{"anyOf":[{"type":"object","properties":{"fee":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"minimum":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"step":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."}},"required":["fee","minimum","step"]},{"type":"null"}]}},"required":["depositMinimum","withdrawal"]}}}},"required":["checkedAt","networks"]},{"type":"null"}]},"kucoin":{"anyOf":[{"type":"object","properties":{"checkedAt":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Unix timestamp in milliseconds. Treat observations older than two minutes as stale."},"networks":{"type":"object","properties":{"erc20":{"type":"object","properties":{"depositMinimum":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},{"type":"null"}]},"withdrawal":{"anyOf":[{"type":"object","properties":{"fee":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"minimum":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"step":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."}},"required":["fee","minimum","step"]},{"type":"null"}]}},"required":["depositMinimum","withdrawal"]},"trc20":{"type":"object","properties":{"depositMinimum":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},{"type":"null"}]},"withdrawal":{"anyOf":[{"type":"object","properties":{"fee":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"minimum":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."},"step":{"type":"integer","minimum":0,"maximum":9007199254740991,"description":"Millionths of USDT."}},"required":["fee","minimum","step"]},{"type":"null"}]}},"required":["depositMinimum","withdrawal"]}}}},"required":["checkedAt","networks"]},{"type":"null"}]}},"required":["bitget","htx","kucoin"]}}}},"400":{"description":"Query parameters are unsupported."},"503":{"description":"No exchange catalogue could be verified."}}}}}}