{"openapi":"3.1.0","info":{"title":"Filecoin API","version":"1.0.0","description":"Live on-chain data from the Filecoin network (FIL), the decentralized storage blockchain where miners are storage providers that pledge real disk capacity: an address's FIL balance, actor type and message count — and, for a storage provider, its raw and quality-adjusted storage power and sector size; storage providers ranked by power with each one's capacity, blocks mined and rewards; a tipset (Filecoin's block) with its height, time, block count and messages; and the chain height, total network storage power and number of active storage providers.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/filecoin-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Address"},{"name":"Providers"},{"name":"Tipset"},{"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/network":{"get":{"operationId":"get_v1_network","tags":["Network"],"summary":"Live chain height, total storage power and active providers","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"filecoin","source":"Filecoin","chain_time":"2026-06-10T13:59:00.000Z","chain_height":6093118,"native_token":"FIL","active_storage_providers":638,"network_storage_power_eib":1.7058,"network_storage_power_pib":1746.7079},"meta":{"timestamp":"2026-06-10T14:00:14.229Z","request_id":"66a3b6b0-0dfa-43a3-9aaa-b90c4c7fb141"},"status":"ok","message":"Network state 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/address":{"get":{"operationId":"get_v1_address","tags":["Address"],"summary":"An address FIL balance and (if a provider) storage power","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Filecoin address (f0..f4)","schema":{"type":"string"},"example":"f02620"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"f02620","actor":"storageminer","source":"Filecoin","address":"f02620","storage":{"owner":{"address":"f3wnmzhu5iln7shuawotkmbaejf6oabp7dits4t4p6zvwxeomqgewjpmp4ho4oyuxuga2gzwe7eu2nmw4prsjq","balance":"4601544414673604093686"},"worker":{"address":"f3wnmzhu5iln7shuawotkmbaejf6oabp7dits4t4p6zvwxeomqgewjpmp4ho4oyuxuga2gzwe7eu2nmw4prsjq","balance":"4601544414673604093686"},"raw_power_pib":0.2939,"sector_size_gib":32,"quality_power_pib":0.953},"balance_fil":12613.915603,"message_count":46765,"created_height":64,"last_seen_height":6092988,"is_storage_provider":true},"meta":{"timestamp":"2026-06-10T14:00:15.373Z","request_id":"b8122c85-8d8a-44f1-997b-d90888a27dfa"},"status":"ok","message":"Address 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/providers":{"get":{"operationId":"get_v1_providers","tags":["Providers"],"summary":"Storage providers ranked by pledged power","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Number of providers (1-100)","schema":{"type":"string"},"example":"20"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"height":6093099,"source":"Filecoin","providers":[{"rank":1,"address":"f01889668","blocks_mined":122,"raw_power_pib":14.5031,"quality_power_pib":144.9341,"total_rewards_fil":553.06313},{"rank":2,"address":"f01315096","blocks_mined":116,"raw_power_pib":12.424,"quality_power_pib":124.2341,"total_rewards_fil":539.784024},{"rank":3,"address":"f0870558","blocks_mined":102,"raw_power_pib":11.6766,"quality_power_pib":116.7369,"total_rewards_fil":455.7169},{"rank":4,"address":"f01518369","blocks_mined":101,"raw_power_pib":11.6363,"quality_power_pib":116.2566,"total_rewards_fil":451.29326},{"rank":5,"address":"f03055005","blocks_mined":107,"raw_power_pib":11.3914,"quality_power_pib":113.8968,"total_rewards_fil":491.122049},{"rank":6,"address":"f03055029","blocks_mined":100,"raw_power_pib":11.1197,"quality_power_pib":111.1777,"total_rewards_fil":451.295596},{"rank":7,"address":"f03055018","blocks_mined":119,"raw_power_pib":10.8845,"quality_power_pib":108.8281,"total_rewards_fil":530.93387},{"rank":8,"address":"f01106668","blocks_mined":101,"raw_power_pib":10.8523,"quality_power_pib":108.5142,"total_rewards_fil":455.739754},{"rank":9,"address":"f01697248","blocks_mined":109,"raw_power_pib":10.5864,"quality_power_pib":105.6325,"total_rewards_fil":486.742967},{"rank":10,"address":"f01082888","blocks_mined":105,"raw_power_pib":10.3616,"quality_power_pib":103.6138,"total_rewards_fil":464.653271},{"rank":11,"address":"f01083914","blocks_mined":106,"raw_power_pib":10.0009,"quality_power_pib":100.0095,"total_rewards_fil":473.445258},{"rank":12,"address":"f03373337","blocks_mined":90,"raw_power_pib":9.9715,"quality_power_pib":99.7147,"total_rewards_fil":398.257775},{"rank":13,"address":"f03377778","blocks_mined":72,"raw_power_pib":9.6375,"quality_power_pib":96.3751,"total_rewards_fil":318.587432},{"rank":14,"address":"f03230423","blocks_mined":92,"raw_power_pib":9.6148,"quality_power_pib":96.1131,"total_rewards_fil":407.072774},{"rank":15,"address":"f03377773","blocks_mined":84,"raw_power_pib":9.602,"quality_power_pib":96.0199,"total_rewards_fil":376.136342},{"rank":16,"address":"f03373733","blocks_mined":89,"raw_power_pib":9.6002,"quality_power_pib":96.0016,"total_rewards_fil":398.21674},{"rank":17,"address":"f03373373","blocks_mined":98,"raw_power_pib":9.5439,"quality_power_pib":95.4383,"total_rewards_fil":438.091155},{"rank":18,"address":"f0114153","blocks_mined":70,"raw_power_pib":9.4826,"quality_power_pib":94.822,"total_rewards_fil":318.560934},{"rank":19,"address":"f03100009","blocks_mined":78,"raw_power_pib":9.1815,"quality_power_pib":91.8152,"total_rewards_fil":358.391453},{"rank":20,"address":"f01083931","blocks_mined":85,"raw_power_pib":9.1379,"quality_power_pib":91.3769,"total_rewards_fil":389.372738}],"active_provider_count":638},"meta":{"timestamp":"2026-06-10T14:00:15.882Z","request_id":"9c06c0b1-7de0-4ef2-af5f-2f6b4bc5b629"},"status":"ok","message":"Providers 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/tipset":{"get":{"operationId":"get_v1_tipset","tags":["Tipset"],"summary":"A tipset height, time, blocks and messages","description":"","parameters":[{"name":"height","in":"query","required":false,"description":"Tipset height or latest","schema":{"type":"string"},"example":"latest"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"height":6093119,"miners":["f03253411","f03559187","f03166677","f03540147","f03526491"],"source":"Filecoin","timestamp":"2026-06-10T13:59:30.000Z","block_count":5,"message_count":23},"meta":{"timestamp":"2026-06-10T14:00:16.328Z","request_id":"dd3ffdd2-944e-4146-acf6-1c23964e0527"},"status":"ok","message":"Tipset 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":"Service metadata and endpoint catalog","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"Filfox Filecoin explorer API (filfox.info, live)","service":"filecoin-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/tipset":"A tipset's height, time, blocks and messages (height=latest|N).","GET /v1/address":"An address's FIL balance and (if a provider) storage power (address=f02620).","GET /v1/network":"Chain height, total network storage power and active providers.","GET /v1/providers":"Storage providers ranked by pledged power (limit=20)."},"description":"Live on-chain data from the Filecoin network (FIL), the decentralized storage blockchain where miners are storage providers that pledge real disk capacity, via the public Filfox explorer. The address endpoint returns an address's FIL balance, actor type, message count and — for a storage provider — its raw and quality-adjusted storage power and sector size; the providers endpoint ranks storage providers by power with each one's capacity, blocks mined and rewards; the tipset endpoint returns a tipset (Filecoin's block) with its height, time, block count and messages; the network endpoint returns the chain height, total network storage power and number of active storage providers. Live, no key, nothing stored. Distinct from the Bitcoin, Stacks, Celestia, Cosmos and EVM on-chain APIs and from price feeds — this is Filecoin's own FIL account state, storage-provider power and decentralized-storage economy.","chain_height":6093118,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:00:17.296Z","request_id":"24db58dc-6612-4b96-911b-767be965e6db"},"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":9000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":900,"monthly_call_quota":139000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":890000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5800,"monthly_call_quota":4680000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/filecoin-api"}