{"openapi":"3.1.0","info":{"title":"Lightning Network API","version":"1.0.0","description":"Live data for Bitcoin's Lightning Network — the instant-payment layer on top of Bitcoin — served straight from mempool.space's public API, no key, nothing cached. The stats endpoint returns the state of the whole network: how many nodes and payment channels exist, the total capacity locked in Bitcoin, the average and median channel capacity, the average fee rate, and the split between clearnet and Tor nodes — the network runs tens of thousands of channels holding thousands of BTC. The top endpoint is the node league table, ranked by liquidity (capacity) or by connectivity (channel count), with each node's alias, capacity and channel count — Bitfinex and Binance run some of the largest routing nodes. The search endpoint finds nodes by alias and returns their public key, capacity and channel count. This is the routing-and-liquidity layer for any Lightning wallet, node operator, payment or analytics app — who the big routing nodes are and how much capacity the network holds. Live from mempool.space, nothing stored. Distinct from on-chain Bitcoin and fee APIs — this is the Lightning Network layer. 4 endpoints.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/lightning-api","description":"oanor gateway"}],"tags":[{"name":"Lightning"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Lightning"],"summary":"Find nodes by alias","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Node alias to search","schema":{"type":"string"},"example":"bitfinex"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":3,"nodes":[{"alias":"blocktank-bitfinex-integration","channels":1,"public_key":"0269c79a76518d58320044208838dca1705ba6b8e8e4465bc9028d778ab774d291","capacity_btc":0.0043,"capacity_sats":430367},{"alias":"BITFINEXCH","public_key":"03ef018c550ac4dedb42788fdffdf859b4bff75bd8505b8c91fc44d05b8b4c5726"},{"alias":"LN-Bitfinex","public_key":"02aa40ca5a360cf9735da325d03932025a9940cb8689c96d0479152ba301259893"}],"query":"bitfinex"},"meta":{"timestamp":"2026-06-09T11:38:51.674Z","request_id":"6b7912da-470e-4178-bcbc-a8cec7159cc8"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stats":{"get":{"operationId":"get_v1_stats","tags":["Lightning"],"summary":"Network statistics","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"tor_nodes":8937,"node_count":17434,"channel_count":40924,"clearnet_nodes":4692,"avg_fee_rate_ppm":830,"avg_capacity_sats":11986349,"unannounced_nodes":2027,"avg_base_fee_msats":882,"clearnet_tor_nodes":1778,"total_capacity_btc":4905.29365,"median_fee_rate_ppm":100,"total_capacity_sats":490529364915,"median_capacity_sats":2100000},"meta":{"timestamp":"2026-06-09T11:38:51.768Z","request_id":"0f67c8ff-cd67-43f1-8a00-4a0014d13701"},"status":"ok","message":"Stats retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/top":{"get":{"operationId":"get_v1_top","tags":["Lightning"],"summary":"Node league table","description":"","parameters":[{"name":"by","in":"query","required":false,"description":"liquidity | connectivity (default liquidity)","schema":{"type":"string"},"example":"liquidity"},{"name":"limit","in":"query","required":false,"description":"How many (default 25, max 100)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"nodes":[{"alias":"bfx-lnd0","country":"Switzerland","channels":665,"public_key":"033d8656219478701227199cbd6f670335c8d408a92ae88b962c49d4dc0e83e025","capacity_btc":560.52491,"capacity_sats":56052491080},{"alias":"bfx-lnd1","country":"Switzerland","channels":616,"public_key":"03cde60a6323f7122d5178255766e38114b4722ede08f7c9e0c5df9b912cc201d6","capacity_btc":463.11432,"capacity_sats":46311431881},{"alias":"Binance","channels":224,"public_key":"03a1f3afd646d77bdaf545cceaf079bab6057eae52c6319b63b5803d0989d6a72f","capacity_btc":462.95901,"capacity_sats":46295900847},{"alias":"ACINQ","country":"United States","channels":2025,"public_key":"03864ef025fde8fb587d989186ce6a4a186895ee44a926bfc370e2c366597a3f8f","capacity_btc":356.09318,"capacity_sats":35609317862},{"alias":"LNBiG [Hub-1]","country":"United States","channels":308,"public_key":"034ea80f8b148c750463546bd999bf7321a0e6dfc60aaf84bd0400a2e8d376c0d5","capacity_btc":343.85546,"capacity_sats":34385545850},{"alias":"LNBiG [Hub-2]","country":"United States","channels":183,"public_key":"033e9ce4e8f0e68f7db49ffb6b9eecc10605f3f3fcb3c630545887749ab515b9c7","capacity_btc":264.05437,"capacity_sats":26405437277},{"alias":"block-iad-1","country":"United States","channels":643,"public_key":"027100442c3b79f606f80f322d98d499eefcb060599efc5d4ecb00209c2cb54190","capacity_btc":256.99634,"capacity_sats":25699634020},{"alias":"Kraken 🐙⚡","country":"India","channels":1157,"public_key":"02f1a8c87607f415c8f22c00593002775941dea48869ce23096af27b0cfdcc0b69","capacity_btc":248.61321,"capacity_sats":24861320515},{"alias":"okx","country":"Hong Kong","channels":500,"public_key":"0294ac3e099def03c12a37e30fe5364b1223fd60069869142ef96580c8439c2e0a","capacity_btc":225.60365,"capacity_sats":22560364522},{"alias":"fixedfloat.com","country":"Lithuania","channels":195,"public_key":"037f990e61acee8a7697966afd29dd88f3b1f8a7b14d625c4f8742bd952003a590","capacity_btc":199.58643,"capacity_sats":19958642662},{"alias":"LNBiG [Hub-3]","country":"United States","channels":154,"public_key":"02c91d6aa51aa940608b497b6beebcb1aec05be3c47704b682b3889424679ca490","capacity_btc":185.8173,"capacity_sats":18581729502},{"alias":"cyberdyne.sh","country":"Netherlands","channels":304,"public_key":"03a93b87bf9f052b8e862d51ebbac4ce5e97b5f4137563cd5128548d7f5978dda9","capacity_btc":164.12781,"capacity_sats":16412781323},{"alias":"Megalithic.me","country":"United States","channels":233,"public_key":"0322d0e43b3d92d30ed187f4e101a9a9605c3ee5fc9721e6dac3ce3d7732fbb13e","capacity_btc":158.68221,"capacity_sats":15868221040},{"alias":"Boltz","country":"Costa Rica","channels":638,"public_key":"026165850492521f4ac8abd9bd8088123446d126f648ca35e60f88177dc149ceb2","capacity_btc":146.98359,"capacity_sats":14698359180},{"alias":"WalletOfSatoshi.com","country":"Canada","channels":1119,"public_key":"035e4ff418fc8b5554c5d9eea66396c227bd429a3251c8cbc711002ba215bfc226","capacity_btc":140.19755,"capacity_sats":14019754694},{"alias":"Strike","country":"United States","channels":353,"public_key":"03c8e5f583585cac1de2b7503a6ccd3c12ba477cfd139cd4905be504c2f48e86bd","capacity_btc":128.81015,"capacity_sats":12881015017},{"alias":"Julia⚡️LND01","country":"France","channels":193,"public_key":"03632f5c3e45832ddf045469f117b503764ad71866d961ae5ec8df2c4378ac019a","capacity_btc":107.39906,"capacity_sats":10739906386},{"alias":"LOOP","country":"United States","channels":73,"public_key":"021c97a90a411ff2b10dc2a8e32de2f29d2fa49d41bfbb52bd416e460db0747d0d","capacity_btc":106.58868,"capacity_sats":10658867997},{"alias":"e960fd8385a1603003727","country":"United States","channels":186,"public_key":"039174f846626c6053ba80f5443d0db33da384f1dde135bf7080ba1eec465019c3","capacity_btc":101.76586,"capacity_sats":10176585751},{"alias":"Authenticity","country":"United States","channels":166,"public_key":"026f46207fd290a33cbd86e29b3ad0a47cdd44ab9aa5267cde66483e10aa9d3180","capacity_btc":89.76816,"capacity_sats":8976815536},{"alias":"LifeIsGood","country":"Germany","channels":153,"public_key":"0391904d140fdf88d19423513945a5fcc49c606521b65a85f6d6fe46ebdd1c7665","capacity_btc":82.65294,"capacity_sats":8265294417},{"alias":"LNBiG [Edge-3]","country":"United States","channels":102,"public_key":"03da1c27ca77872ac5b3e568af30673e599a47a5e4497f85c7b5da42048807b3ed","capacity_btc":81.8784,"capacity_sats":8187839580},{"alias":"ed528ad49bedd1f7a638a","country":"United States","channels":203,"public_key":"02a98e8c590a1b5602049d6b21d8f4c8861970aa310762f42eae1b2be88372e924","capacity_btc":81.07912,"capacity_sats":8107911775},{"alias":"LNBiG [Edge-4]","country":"United States","channels":100,"public_key":"039edc94987c8f3adc28dab455efc00dea876089a120f573bd0b03c40d9d3fb1e1","capacity_btc":80.45935,"capacity_sats":8045935150},{"alias":"nicehash-ln1","country":"Belgium","channels":672,"public_key":"037659a0ac8eb3b8d0a720114efc861d3a940382dcfa1403746b4f8f6b2e8810ba","capacity_btc":76.51067,"capacity_sats":7651066641}],"ranked_by":"liquidity"},"meta":{"timestamp":"2026-06-09T11:38:51.936Z","request_id":"0a538622-1c70-4879-8937-ead4794ea734"},"status":"ok","message":"Top nodes retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"mempool.space public Lightning API (live)","service":"lightning-api","endpoints":{"GET /v1/top":"Node league table (by=liquidity|connectivity, limit up to 100).","GET /v1/meta":"This document.","GET /v1/stats":"Network statistics: nodes, channels, total capacity (BTC), fees, clearnet/Tor split.","GET /v1/search":"Find nodes by alias (q=bitfinex): public key, capacity, channels."},"description":"Live Bitcoin Lightning Network data from mempool.space: network statistics (node and channel counts, total capacity in BTC, average and median channel capacity, average fee rate, clearnet/Tor split); the node league table ranked by liquidity or connectivity; and node search by alias with public key, capacity and channel count. Live, no key, nothing stored. Distinct from on-chain Bitcoin and fee APIs — this is the Lightning Network layer.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-09T11:38:52.050Z","request_id":"f0796a83-d325-43ab-8510-78daff6b2f5f"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10200,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":850,"monthly_call_quota":124000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2250,"monthly_call_quota":608000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5450,"monthly_call_quota":3040000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/lightning-api"}