{"uid":"cap_W941DcWiLHPzDpVqqzQ8F","slug":"myc-iasignal-btc-usd-liquidation-flow-oracle-f5155c02","name":"MycелiaSignal BTC/USD Liquidation Flow Oracle","description":"BTC liquidation flow — real-time across 4 exchanges with imbalance and clustering — Ed25519 signed attestation","url":"https://api.myceliasignal.com/oracle/liquidations/btc/usd","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"pair":"btc/usd","digest":"0d95d2d41f6f7d115276dd870b3a25084ede613f791f7a97dd752fef427bb733","pubkey":"7ab07fbe7d08cd16823e5eb0db0e21f3f38e9366d5fd00d14e95df0fb9b51a1a","signed":true,"preview":false,"burst_1m":0,"canonical":"v1|LIQUIDATIONS|BTCUSD|imbalance|-0.8277|count|100|long_notional|7367458.13|short_notional|78142282.22|1781933224|581941","imbalance":-0.8277,"signature":"d3090a8468f35a218471a84552afa4fb8a5e027608ead2e2caf3f72ab13a17d68a3c75e3627395a8ba18bd2f80457c115af54f42399e001bbc2b7d4847925604","long_count":24,"by_exchange":{"okx":{"long_count":24,"short_count":76,"long_notional":7367458.13,"short_notional":78142282.22}},"short_count":76,"events_total":100,"recent_events":[{"pair":"btc/usd","side":"SHORT","price":"64057.5","exchange":"okx","quantity":"0.05","timestamp":"2026-06-20T05:10:15.342548+00:00","notional_usd":"3202.875"},{"pair":"btc/usd","side":"SHORT","price":"64057.5","exchange":"okx","quantity":"0.05","timestamp":"2026-06-20T05:10:15.343542+00:00","notional_usd":"3202.875"},{"pair":"btc/usd","side":"SHORT","price":"63841.8","exchange":"okx","quantity":"1.01","timestamp":"2026-06-20T05:10:15.738762+00:00","notional_usd":"64480.218"},{"pair":"btc/usd","side":"SHORT","price":"63841.8","exchange":"okx","quantity":"1.01","timestamp":"2026-06-20T05:10:15.750862+00:00","notional_usd":"64480.218"},{"pair":"btc/usd","side":"SHORT","price":"63862.3","exchange":"okx","quantity":"9.43","timestamp":"2026-06-20T05:10:16.432827+00:00","notional_usd":"602221.4890000001"},{"pair":"btc/usd","side":"SHORT","price":"63862.3","exchange":"okx","quantity":"9.43","timestamp":"2026-06-20T05:10:16.433833+00:00","notional_usd":"602221.4890000001"},{"pair":"btc/usd","side":"SHORT","price":"63799.5","exchange":"okx","quantity":"10.0","timestamp":"2026-06-20T05:13:21.272764+00:00","notional_usd":"637995.0"},{"pair":"btc/usd","side":"SHORT","price":"63799.5","exchange":"okx","quantity":"10.0","timestamp":"2026-06-20T05:13:21.273734+00:00","notional_usd":"637995.0"},{"pair":"btc/usd","side":"SHORT","price":"63854.7","exchange":"okx","quantity":"0.08","timestamp":"2026-06-20T05:14:00.530990+00:00","notional_usd":"5108.376"},{"pair":"btc/usd","side":"SHORT","price":"63854.7","exchange":"okx","quantity":"0.08","timestamp":"2026-06-20T05:14:00.532290+00:00","notional_usd":"5108.376"}],"long_notional_usd":7367458.13,"clustering_per_min":0.4,"short_notional_usd":78142282.22,"total_notional_usd":85509740.35}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QVxKQGpflRueetYFA4CYg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time BTC/USD liquidation flow data aggregated across 4 exchanges, with imbalance metrics and clustering analysis, delivered as an Ed25519-signed attestation","exampleAgentPrompt":"Pull the latest BTC/USD liquidation flow snapshot — I want to see cross-exchange imbalance and clustering right now, with the Ed25519-signed attestation so I can verify it on-chain.","exampleUseCases":[{"title":"Alert on emerging BTC liquidation cascades","prompt":"Monitor the BTC liquidation clustering metrics in real-time and alert me if cascade risk is building across exchanges — I need the signed attestation so I can trigger defensive positions before the cascade accelerates."},{"title":"Verify liquidation imbalance for smart contracts","prompt":"Fetch the latest cross-exchange BTC liquidation flow with directional imbalance data and the Ed25519 signature — I'm feeding this into an on-chain contract that needs trustless proof of market stress levels before executing a collateral adjustment."},{"title":"Detect systematic long or short liquidations","prompt":"Show me which BTC liquidations are happening right now across all four exchanges with a breakdown of long versus short positions being cleared — I need the cryptographically signed data so I can validate it independently and adjust my risk exposure."}],"resultDescription":"A signed JSON payload containing real-time BTC/USD liquidation flow aggregated across 4 exchanges, including directional imbalance (long vs short liquidations), clustering metrics indicating cascade risk, per-exchange breakdown, and an Ed25519 cryptographic attestation for trustless verification of data integrity.","failureModes":["Payment not received or x402 micropayment flow failed — 402 Payment Required returned","Upstream exchange data feed temporarily unavailable — partial or stale data may be returned","Ed25519 signing service unavailable — attestation cannot be generated","Rate limit exceeded — 429 Too Many Requests","One or more of the 4 exchanges is offline — reduced exchange coverage in response"],"whenToPreferThis":"Choose this endpoint when you need cryptographically attested, real-time BTC liquidation data suitable for on-chain smart contract consumption or trustless off-chain verification. It is especially valuable when you need cross-exchange aggregation (4 exchanges) and want to detect liquidation clustering or cascade risk with imbalance metrics — capabilities not typically offered by simple price oracles.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:46:28.288Z","isFirstParty":false}