{"uid":"cap_JiBut5lBQklsWf9dkfjSe","slug":"api-quantoracle-dev-9f17da5e","name":"QuantOracle Transaction Cost Analysis","description":"QuantOracle: risk/transaction-cost","url":"https://api.quantoracle.dev/v1/risk/transaction-cost","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"adv":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Adv","description":"Average daily volume in USD (for Almgren model)"},"shares":{"type":"integer","title":"Shares","default":1,"minimum":1,"description":"Number of shares"},"spread_bps":{"type":"number","title":"Spread Bps","default":5,"description":"Bid-ask spread in basis points"},"trade_value":{"type":"number","title":"Trade Value","description":"Total trade value in USD","exclusiveMinimum":0},"commission_pct":{"type":"number","title":"Commission Pct","default":0,"description":"Commission as percentage of trade value"},"commission_flat":{"type":"number","title":"Commission Flat","default":0,"description":"Flat commission per trade"},"market_impact_bps":{"type":"number","title":"Market Impact Bps","default":0,"description":"Estimated market impact in basis points"},"participation_rate":{"type":"number","title":"Participation Rate","default":0.1,"description":"Fraction of ADV consumed by trade"},"commission_per_share":{"type":"number","title":"Commission Per Share","default":0,"description":"Commission per share"}}},"responseSchema":null,"example":{"request":{"adv":10000000,"shares":10000,"spread_bps":5,"trade_value":500000,"commission_pct":0.02,"market_impact_bps":8,"participation_rate":0.2},"response":{"ms":12.26,"_meta":{"url":"https://quantoracle.dev","docs":"https://api.quantoracle.dev/docs","powered_by":"QuantOracle"},"cost_bps":6.74,"commission":100,"total_cost":336.8034,"cost_as_pct":0.0674,"spread_cost":125,"market_impact":111.8034,"round_trip_bps":13.47,"round_trip_cost":673.6068,"breakeven_move_pct":0.1347}},"exampleRequest":{"adv":10000000,"shares":10000,"spread_bps":5,"trade_value":500000,"commission_pct":0.02,"market_impact_bps":8,"participation_rate":0.2},"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_IQHxvj_hk4HITZlkp_oL2","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":"Computes detailed transaction cost breakdown for a trade including spread cost, market impact, commission, round-trip cost, and breakeven move percentage","exampleAgentPrompt":"What are the full transaction costs for buying 10,000 shares of a stock with a $500,000 trade value, ADV of $10 million, spread of 5 bps, market impact of 8 bps, commission of 0.02%, and a participation rate of 20%?","exampleUseCases":null,"resultDescription":"Returns a detailed cost breakdown including: total cost in basis points, spread cost in USD, market impact in USD, commission in USD, total cost in USD, cost as a percentage of trade value, round-trip cost in bps and USD, breakeven move percentage, and computation latency in milliseconds.","failureModes":["Missing required fields (adv, shares, trade_value) returns validation error","Negative or zero values for share count or trade value may return computation error","Participation rate outside 0-1 range may return invalid input error","Commission percentage expressed as decimal vs percentage may yield unexpected results"],"whenToPreferThis":"Use this endpoint when you need a full decomposition of transaction costs for a single equity trade — specifically when you need spread cost, market impact, commission, and round-trip cost all broken down with a breakeven move calculation. Prefer this over generic slippage estimators when you have ADV, participation rate, and spread data available and need precise bps-level cost attribution.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:54:01.298Z","isFirstParty":false}