{"uid":"cap_rGV1nyA3zh1Vb9lhvUAeR","slug":"btc-node-api-bitcoin-whale-transactions-3c4331fe","name":"BTC Node API — Bitcoin Whale Transactions","description":"Bitcoin whale transactions","url":"https://api.relai.fi/relay/1780781322365/api/whales","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":{"count":4,"min_btc":100,"success":true,"transactions":[{"time":"2026-06-12T04:29:22.000Z","txid":"455ceae5ad1942ff6037b5c3013ce6f6886328ddaa834a439d24827c524af321","vsize":347,"fee_sats":1810,"addresses":["bc1q2j3m0kjatzuucujg20sucdczjvmfzt702n7zd7","33EdBGaVenQkMcC5D2mrF6qYeuerL1are7","bc1qj3ujnsvs24n407uzpxnxmmnjkaau6gvx5hv8lh"],"value_btc":277.14074861},{"time":"2026-06-12T04:20:57.000Z","txid":"4c0ea1602631062f126771ef319c0f2b5c5c1184cbbb7e7db01c74249cdb3a94","vsize":350,"fee_sats":1810,"addresses":["bc1q2jks5s0ruc9mn99l9umfvh9f928uq9gjx665l6","bc1qu9mz3k4yy5h53p86l0qvccw3frgqt2rx0ynfzw","1NkUqeupCHu3XZ2o4zJ4mRU4WztGq24HHN"],"value_btc":410.37533651},{"time":"2026-06-12T04:18:29.000Z","txid":"a12d92ab2149fbcabea2edd609cd6d014300436595622dd1f5bb22eb052e039f","vsize":367,"fee_sats":1687,"addresses":["bc1qxqmfz02frdvs8lpwryk059ydzcdgtzv77x73su","3J7cUjBZxvGRCwFBz3q23zAsnhFfZrDSSU"],"value_btc":487.00015183},{"time":"2026-06-12T04:18:47.000Z","txid":"f1e3c5206da8ae816268315abeb80a2f75168fb9dc3ad4a8031a35bc515b9c5f","vsize":278,"fee_sats":667,"addresses":["bc1qgsw89nnqs2lmeqqw6uv8zns6zd0ay5205z5ufu","33mhsZH2tGPME3RbQ3soWYHLTxgU4hEanN","bc1q60kg5u8huayuyv098dg28p038e0nyzru7vh3a8"],"value_btc":347.67390114}]}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.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_e_fu_R67WDLc66uBZsiCf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a list of recent large Bitcoin whale transactions from the blockchain","exampleAgentPrompt":"Show me the latest Bitcoin whale transactions — large BTC transfers that have happened recently on-chain.","exampleUseCases":[{"title":"Alert portfolio managers on whale movements","prompt":"Monitor the blockchain for me and let me know whenever a Bitcoin whale moves more than 1,000 BTC in a single transaction. I want to know immediately so I can adjust our trading strategy if needed."},{"title":"Investigate suspicious exchange fund flows","prompt":"Pull the recent large Bitcoin transactions and tell me which ones are moving funds into or out of major exchange wallets. I need to understand if whales are accumulating or liquidating right now."},{"title":"Track institutional investor Bitcoin positions","prompt":"Show me which wallets have been consistently moving large amounts of Bitcoin over the past week, and help me identify if these look like institutional investors or exchange operations based on their transaction patterns."}],"resultDescription":"A list of recent large Bitcoin transactions (whale movements), likely including transaction IDs, wallet addresses, BTC amounts transferred, block height or timestamp, and possibly USD value equivalents.","failureModes":["Node connectivity issues returning 503 or timeout","Empty result set if no whale transactions occurred recently","402 payment required if x402 payment not included or insufficient","Rate limiting returning 429 if called too frequently","Malformed response if upstream Bitcoin node is syncing"],"whenToPreferThis":"Use this endpoint when you need real-time or recent large Bitcoin transaction data directly from a Bitcoin node, specifically for whale-watching, on-chain analytics, market signal detection, or alerting on large BTC movements. Prefer over generic blockchain explorers when you need programmatic access with a pay-per-call model.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:46:23.443Z","isFirstParty":false}