{"openapi":"3.1.0","info":{"title":"Telos Chain API","version":"1.0.0","description":"Live on-chain data for Telos EVM — a high-throughput EVM Layer 1 — via its public Blockscout explorer (no wallet, no key). The stats endpoint returns chain-wide totals (blocks, transactions, addresses, average block time, gas used); gas gives the current gas-price oracle (slow/average/fast). Blocks lists the latest blocks, and a single block resolves by height or by hash with its transaction count, gas, miner and timestamp. The address endpoint returns any account's TLOS balance, nonce, contract flag and token holdings; transaction resolves a tx by hash with its from/to, value in TLOS, fee, status and block. The token endpoint returns an ERC-20 token's metadata (name, symbol, decimals, total supply, holders) by contract address, and search runs a universal lookup across addresses, tokens, blocks and transactions. Gas, balances, values and fees are denominated in TLOS, the native coin. Real on-chain data straight from the explorer, refreshed every call — no key. 9 endpoints. For multi-chain coverage combine with the other oanor chain APIs (Ethereum, Base, Arbitrum and more).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/telos-api","description":"oanor gateway"}],"tags":[{"name":"Chain"},{"name":"Blocks"},{"name":"Accounts"},{"name":"Transactions"},{"name":"Tokens"},{"name":"Search"},{"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/gas":{"get":{"operationId":"get_v1_gas","tags":["Chain"],"summary":"Gas-price oracle","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"fast":5777.9,"slow":5777.9,"unit":"gwei","average":5777.9,"gas_used_today":"171779466"},"meta":{"timestamp":"2026-06-08T09:49:54.325Z","request_id":"e78ffbde-8e03-4d67-8e1e-b9b338eda5fb"},"status":"ok","message":"Gas 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":["Chain"],"summary":"Chain stats","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"gas_prices":{"fast":5777.9,"slow":5777.9,"average":5777.9},"total_blocks":471793112,"coin_price_usd":0.01139262,"gas_used_today":"171779466","market_cap_usd":4784899.978068622,"total_addresses":"221824","total_transactions":"9533159","transactions_today":"3529","network_utilization_percent":0},"meta":{"timestamp":"2026-06-08T09:49:54.588Z","request_id":"e2364fd9-2b95-45fd-913a-fae26488ad7e"},"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/block":{"get":{"operationId":"get_v1_block","tags":["Blocks"],"summary":"A block by height or hash","description":"","parameters":[{"name":"height","in":"query","required":false,"description":"Block height","schema":{"type":"string"},"example":"471764058"},{"name":"hash","in":"query","required":false,"description":"Block hash (alternative to height)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"block":{"hash":"0xd4fc77bb160d64b525cad4e0f726910a0814900223c4637ef4312065cca24e6f","size":821,"miner":"0x0000000000000000000000000000000000000000","height":471764058,"gas_used":33892,"tx_count":1,"gas_limit":2147483647,"timestamp":"2026-06-08T04:44:07.000000Z","burnt_fees":"0","difficulty":"0"}},"meta":{"timestamp":"2026-06-08T09:49:54.822Z","request_id":"1e061419-4472-4788-8609-2d92a5721489"},"status":"ok","message":"Block 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/blocks":{"get":{"operationId":"get_v1_blocks","tags":["Blocks"],"summary":"Latest blocks","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":50,"blocks":[{"hash":"0xb2f4180dbdde5477d77883cbc92acae4e97d38520def80ef8a7f8ec988952f97","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800752,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:54.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xa3c63b79a329c084268b72132ed04034bb08f7253334a7094abfc3a33d0d3275","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800751,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:53.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xd752c99201e6c8ff631fd2e3af843c94d33098559dc7dc861947636c94f8f3ec","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800750,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:53.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xce18f8fc2c08f785d20ad9ff811ed97d8d1279c5379fea716d17b88500a8433b","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800749,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:52.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x7685e9622f9423d27a890895f29b5a993384200f7c6609972559d4b2fb9c6dfe","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800748,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:52.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xf9d9be7345186438de786328148fbe57e522ce56744343efba0bd983a68dd192","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800747,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:51.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x18d0fbc30f14e9b3ac6e1e46b3b4ca9b1f3039846a602dfca9e35623a6613fef","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800746,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:51.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xf34a2e5a7323e697a43cefc7ac34568334e50c6119e154c153417dd955a8da10","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800745,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:50.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xfff9affd7937665e616cf52472fb0da3a08fc980cc8017168cd8058d026330d1","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800744,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:50.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xd9a4e850cab4e405e3a197ba7b12fb737a9276e1876e9db43faede7b607e64bd","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800743,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:49.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x7cd1ca90bb3bbc99400922e7dcc58d998883d72e2a410e66d64cbf6b00626a2b","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800742,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:49.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xeaea3c32c8b63b95a8aaa1fde494f9d6c334bac70e573094cbbe807f6d872b53","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800741,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:48.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xaa48a194d42e5bd43d88baf5871160276e522ffba54689dc14474a64c9a56396","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800740,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:48.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x0acf1443e5b3b43f167e3fbb8f397bd36620155ed00102f5729f96c085d76f0c","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800739,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:47.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xf0ac3b845ea0d23d249ec2865f41498d6d714415391f61817034042c60395eee","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800738,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:47.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xed159603b52a0dce277357afc2dc9829e191e2a940a38283a6ae1598fb6ad33f","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800737,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:46.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x05ae333d609f5641f771635db54d8dbc719191620eea665f834e223d9a8ab744","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800736,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:46.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xdb3783042e92702f7a2cbe1dd99668c8173fd065db26cb2299d8ed1e91e92dfc","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800735,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:45.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x18e998723928c1ea19453e9b1ce89da05926ba86107003184fb6c36752208f10","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800734,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:45.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x2c5c91df7e4384d5a137feda057230370e5becbf19f124e1a55e3b29db1d735f","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800733,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:44.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xc43d2d93366dac5f48115e29199f8727c1ffaf8b3b711cb426afdcf2f3718a88","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800732,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:44.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xbe15080ff81c4214512348d620f7b02ef1ad033524d538b8dcab9b2d7a8a83d9","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800731,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:43.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xe5be2b863a1ef1b9809fa495d56653e87e34d6b0c52a10b47f354e310d564d50","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800730,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:43.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x620bf3eb39ad48cae532d58e7bbe27f0b260934642d34146571c3600891f3558","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800729,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:42.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xf4c6b7a088cfb141a22f1535c256b4099455781d7ab75ce9cde924cbd40274f8","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800728,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:42.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x7cb16b0dc7c86b49f4d9d2f1b2f516d2b98063d52a7e9845cffc37f19a920f23","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800727,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:41.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xe74982e125d3d76d77e5985283f7c98a4768060417ed178ef581a6ee010898de","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800726,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:41.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xfbea9451bd52e26c26c2a17188ae1c80fa8a8ca1cd034025ba9e97f6822d4231","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800725,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:40.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xee5759c51541ebd03cbd3e4311d7a2d9f7dd51bb6f50835784cd6343a6c4c780","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800724,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:40.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x7681a6b85f3529d09b1be25c1f12271e877c01e72814fe824120a13233dc9d7f","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800723,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:39.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xd3c7d0dd09cdef58b3b2605a0be88938c142fdb0c44e94ede659e279f6011fe3","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800722,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:39.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xb79ccbfc562f4651e3930f5f2893bd20fd7649bd29d227e0332fbf5c27f59d58","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800721,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:38.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xb53d9d50b8a8231bffb5b0d8b5241f4d835032f3463900fde0cecb0a51638b59","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800720,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:38.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xff4466cd40035c3ead156eadeff2cc2728aabc09daa4b987705627e2f397b1b9","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800719,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:37.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x7b4f8f0bde6488caacd36e748d822ed5e0a0c859a429e344caf4029f672289ed","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800718,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:37.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x250c830cf16f7c31c6a2c61aa9abd08846162b445c4f4d9094b5ce90b80a497e","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800717,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:36.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x5c0047fdb5b5e4b2933521564cc4aa45f7264002452701249180eeb23c3592b2","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800716,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:36.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x2282a7f6ce622c6fdc21dcdcb564f5b747219148db3a5699e0bcd27b9920e9a2","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800715,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:35.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xd5ff99979b1a00315ec9f572f77417b0821f5ae82884779746217b29fc1667a8","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800714,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:35.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x7bc387e5036ccc9736407d06cb4ad1625f3648bc1b84bc4dfb3b0c6793f9540d","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800713,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:34.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xbdbfb7b919ceae5fdda7de1dda220e14b8db5c8125e6045d5db9f7963b299395","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800712,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:34.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x810e235052a2e0a98bd7a94580530515904fc21a7f6d9011aaa3cc6b3046469c","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800711,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:33.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x4e1c1e34497c26a333edadc0ac4e49f32661a89ef99da0205aa7b228c409ac19","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800710,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:33.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x102b10a4574e14f357011e13c4c943ed9234d431023fdd6d3b4a97225353388a","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800709,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:32.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x479be65f368fcf98e4a28b051a02bee231bbaf0103121c5ed3504ed366f00de9","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800708,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:32.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x9e69506a8e7d21d2fbeb74de304abbd58a7c93a7c77d2cb358310858b4b25168","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800707,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:31.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xae59df56e2e99ad73fde2fd2d0ce45b0278d0fb29f981eadbabd3b7492d36794","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800706,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:31.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x456f3639d32a578804a14b429213a18c49ac2246542970d9839effa6cc54612c","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800705,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:30.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0xded141b0426c52049c5d3333982d49755e6438b9de5074b1a66f1f038c6f736d","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800704,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:30.000000Z","burnt_fees":"0","difficulty":"0"},{"hash":"0x117e2f994c9788ae3f85afd139e387e31b23809440d624dd46378095b6a2564c","size":545,"miner":"0x0000000000000000000000000000000000000000","height":471800703,"gas_used":0,"tx_count":0,"gas_limit":2147483647,"timestamp":"2026-06-08T09:49:29.000000Z","burnt_fees":"0","difficulty":"0"}]},"meta":{"timestamp":"2026-06-08T09:49:55.299Z","request_id":"e9ec9181-e958-4021-be76-94445fcff593"},"status":"ok","message":"Blocks 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":["Accounts"],"summary":"Account balance & holdings","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Account address (0x + 40 hex)","schema":{"type":"string"},"example":"0x681636784F1E2e119a86B0ddD089f4D6f49FeB41"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"address":{"hash":"0x681636784F1E2e119a86B0ddD089f4D6f49FeB41","balance_wei":"9092361549074397305869","is_contract":false,"is_verified":false,"balance_tlos":9092.361549074398}},"meta":{"timestamp":"2026-06-08T09:49:55.555Z","request_id":"8c58bfd2-706f-4374-bae8-5f9726d0e2ff"},"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/transaction":{"get":{"operationId":"get_v1_transaction","tags":["Transactions"],"summary":"A transaction by hash","description":"","parameters":[{"name":"hash","in":"query","required":true,"description":"Transaction hash (0x + 64 hex)","schema":{"type":"string"},"example":"0xee27195cd9636a15c485ae05c5c17bfe513a8f6b8678d37841c118c576d5abe1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"transaction":{"to":"0xf774801c9f1b11e70966CE65EC7f95d7730F380d","from":"0x681636784F1E2e119a86B0ddD089f4D6f49FeB41","hash":"0xee27195cd9636a15c485ae05c5c17bfe513a8f6b8678d37841c118c576d5abe1","type":0,"block":471764058,"nonce":311789,"method":"setValue","status":"ok","fee_wei":"195824301595837504","fee_tlos":0.1958243015958375,"gas_used":33892,"gas_price":"5777891584912","timestamp":"2026-06-08T04:44:07.000000Z","value_wei":"0","value_tlos":0,"confirmations":36697}},"meta":{"timestamp":"2026-06-08T09:49:55.817Z","request_id":"abae5a08-3887-4cd9-a96a-68bc7ca6a1bd"},"status":"ok","message":"Transaction 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/token":{"get":{"operationId":"get_v1_token","tags":["Tokens"],"summary":"ERC-20 token metadata","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"Token contract address","schema":{"type":"string"},"example":"0x7627b27594bc71e6Ab0fCE755aE8931EB1E12DAC"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"token":{"name":"Bitcoin","type":"ERC-20","symbol":"BTC.b","decimals":8,"total_supply":"4144918","exchange_rate_usd":63334,"circulating_market_cap":"7354930115.191614"}},"meta":{"timestamp":"2026-06-08T09:49:56.050Z","request_id":"15540dbf-61d8-4466-9481-4b103d36cd1c"},"status":"ok","message":"Token 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/search":{"get":{"operationId":"get_v1_search","tags":["Search"],"summary":"Universal search","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Address, token, block or tx","schema":{"type":"string"},"example":"BTC.b"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":46,"query":"BTC.b","results":[{"name":"Bitcoin","type":"token","symbol":"BTC.b","address":"0x7627b27594bc71e6Ab0fCE755aE8931EB1E12DAC"},{"name":"Wrapped BTC","type":"token","symbol":"WBTC","address":"0x0555E30da8f98308EdB960aa94C0Db47230d2B9c"},{"name":"Wrapped BTC","type":"token","symbol":"WBTC","address":"0xf390830DF829cf22c53c8840554B98eafC5dCBc2"},{"name":"believe btc base","type":"token","symbol":"bbb","address":"0x43D4066B4Cea9ee28A10cF346124095D0072c7fc"},{"name":"gift btc","type":"token","symbol":"gift","address":"0x951385ebc86460eBf0B147307a2BFf591EE43AE5"},{"name":"BitcoinBR","type":"token","symbol":"BTCBR","address":"0x26fD8574a21D3160c6CC6098f8e8761aa2630117"},{"name":"BTC@telos","type":"token","symbol":"BTC","address":"0x9E8AAfd785F8cC9AEbB4B6Fbf817ee988e85feDe"},{"name":"power base btc","type":"token","symbol":"pbb","address":"0x7d0E2fd200cFa4fF1f104922F1CeEA4fB0dCA1B3"},{"name":"radiant base btc","type":"token","symbol":"rbb","address":"0x139222A49f49F53639Ec828B7892660397698225"},{"name":"AI BTC","type":"token","symbol":"AIBTC","address":"0xdc44665094BF46FA38b166f27aBEeF3E65b1B09C"},{"name":"Bitcoin","type":"token","symbol":"BTC","address":"0xa4E7bed75844bB940F14846Ac2959a7B917448E4"},{"name":"Bitcoin","type":"token","symbol":"BTC","address":"0xab9d57e053a5C2afc1041317ff147928c8AaB7a6"},{"name":"Bitcoin","type":"token","symbol":"BTC","address":"0x2468225303BCE652a8Aa42880F793aE547C8a293"},{"name":"Bitcoin","type":"token","symbol":"BTC.b","address":"0x62a15FbB0Bfe3cFb8D2F3528Cc71BAB4128f7c22"},{"name":"BitcoinBR","type":"token","symbol":"BTCBR","address":"0x75C5f6D32d8Ef3a4f0F43F7792Aa08e8678972F9"},{"name":"brilliant btc","type":"token","symbol":"bbtc","address":"0x02bF36D4461868Da0F4a3D997212C48048C8f03b"},{"name":"btcmonkey","type":"token","symbol":"btc","address":"0x7aD74D7012E6A1b927f74cD3B452a41289c8f7b6"},{"name":"BTC World","type":"token","symbol":"bwr","address":"0xEB4cd259Ffcee2E16c2Afe36412D13FC598f48c1"},{"name":"cold btc","type":"token","symbol":"cold","address":"0x100CE9d0496708712503c0472f2E767B7E424E52"},{"name":"color of btc","type":"token","symbol":"color","address":"0x388e0058901b277fb5B6Fb6B5f471C46aD05EcC9"},{"name":"fire btc","type":"token","symbol":"fireb","address":"0x587AEef985720602Aee336B5E86D807308ad3dcE"},{"name":"gA-BTC-TLOS","type":"token","symbol":"gA-BTC-TLOS","address":"0x173630Ff7c7763DbcD9B38b03c2870B5d51dDB80"},{"name":"gold btc","type":"token","symbol":"goldb","address":"0x02D920273d178775B00Af7c8317062dE372b947d"},{"name":"gS-BTC-TLOS","type":"token","symbol":"gS-BTC-TLOS","address":"0xB3e34c8046AFC1F7dE0F6f2C0d3140647AD58b30"},{"name":"happy btc","type":"token","symbol":"happy","address":"0xeE2AeF83F538F4f5C42CeE58ca2d7BADF9D079D6"}]},"meta":{"timestamp":"2026-06-08T09:49:56.348Z","request_id":"a2ec72c6-ae47-4d33-89c9-3ed26f9e3cb2"},"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/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Spec","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"telos-api","endpoints":{"GET /v1/gas":"Gas oracle (slow/average/fast in gwei).","GET /v1/meta":"This document.","GET /v1/block":"Block detail by height= or hash=.","GET /v1/stats":"Network stats (blocks, txns, coin price, market cap, gas).","GET /v1/token":"ERC-20 token detail by contract (address=).","GET /v1/blocks":"The most recent blocks.","GET /v1/search":"Search addresses, tokens, blocks & txns (q=).","GET /v1/address":"Address balance, ENS & contract info (address=).","GET /v1/transaction":"Transaction detail (hash=)."},"description":"Live Telos EVM on-chain data via Blockscout: network stats, a gas oracle (gwei), recent blocks and block detail, address balances with ENS, transaction detail, ERC-20 token detail and a universal search across addresses, tokens, blocks and transactions. Telos is an EVM Layer 1; gas, balances and fees are in TLOS. Real on-chain data, no key."},"meta":{"timestamp":"2026-06-08T09:49:56.478Z","request_id":"36adb16b-0c49-4b54-a5d5-a27fd827d63a"},"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":1900,"rps_limit":2,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":1350,"monthly_call_quota":85000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4400,"monthly_call_quota":560000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":14500,"monthly_call_quota":2950000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/telos-api"}