{"openapi":"3.1.0","info":{"title":"VeChain API","version":"1.0.0","description":"Live on-chain data from the VeChainThor network (VET), an enterprise-focused layer-1 blockchain with a dual-token model (VET stores value, VTHO pays for gas): an address's VET balance and VTHO energy; a transaction's origin, clauses, total VET value, gas used, VTHO paid and revert status; a block's number, id, timestamp, gas limit and used, Proof-of-Authority beneficiary and transaction count; and the live network tip.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/vechain-api","description":"oanor gateway"}],"tags":[{"name":"Network"},{"name":"Account"},{"name":"Transaction"},{"name":"Block"},{"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 VeChainThor chain tip and dual-token info","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"chain":"vechainthor","source":"VeChain","tip_id":"0x017e567c52f7c864bdbcb511c24a0a2b86b4b6486381b2b536e49353cde6c23f","gas_token":"VTHO","tip_number":25056892,"native_token":"VET","tip_gas_used":476193,"tip_tx_count":2,"tip_gas_limit":40000000,"tip_timestamp":"2026-06-10T14:01:40.000Z","tip_beneficiary":"0x3624f8c097c7e20b37df136339dd2f6feffa3db0","tip_gas_used_pct":1.19},"meta":{"timestamp":"2026-06-10T14:01:38.324Z","request_id":"726cb4cd-b53e-4031-badd-4382725dc270"},"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/account":{"get":{"operationId":"get_v1_account","tags":["Account"],"summary":"An address VET balance and VTHO energy","description":"","parameters":[{"name":"address","in":"query","required":true,"description":"VeChain address (0x + 40 hex)","schema":{"type":"string"},"example":"0xdec03b1419446f11cec897c9d3e0e909755562b7"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"source":"VeChain","address":"0xdec03b1419446f11cec897c9d3e0e909755562b7","is_contract":false,"vet_balance":885.94061,"vtho_energy":75246.757712,"vet_balance_wei":"0x3006e5531c0eb9710c","vtho_energy_wei":"0xfef228968719d0ebc45"},"meta":{"timestamp":"2026-06-10T14:01:38.476Z","request_id":"21bc6511-a065-4f2e-b078-482f9b46f6ff"},"status":"ok","message":"Account 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":["Transaction"],"summary":"A transaction clauses, value, gas and VTHO paid","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Transaction id (0x + 64 hex)","schema":{"type":"string"},"example":"0x9372643acdda521e7ec30de971dda3f4561ca5a7109414326b08735bf1caf206"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"gas":324966,"size":1506,"txid":"0x9372643acdda521e7ec30de971dda3f4561ca5a7109414326b08735bf1caf206","nonce":"0xcdbf4","origin":"0xdec03b1419446f11cec897c9d3e0e909755562b7","source":"VeChain","block_id":"0x017e513c8b8dbc97ac5f123ae7affa4058395bfb460c74a3576f0c8e079a04d2","gas_used":190885,"reverted":false,"delegator":"0xf4dcbacd10890172d48c42720c0d8aa97fe21d39","total_vet":0,"vtho_paid":2.867018,"block_time":"2026-06-10T10:17:40.000Z","vtho_reward":0.958168,"block_number":25055548,"clause_count":1,"gas_price_coef":128},"meta":{"timestamp":"2026-06-10T14:01:38.671Z","request_id":"b61d2c67-f17b-45c2-9fa1-95c9506a9ca6"},"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/block":{"get":{"operationId":"get_v1_block","tags":["Block"],"summary":"A block details by revision","description":"","parameters":[{"name":"revision","in":"query","required":false,"description":"Block number, 0x block id or best","schema":{"type":"string"},"example":"15000000"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":"0x00e4e1c088267e1441dad6fc4a1e146f0269491b9109413abea2ef6f91a463a6","size":361,"number":15000000,"source":"VeChain","gas_used":0,"tx_count":0,"gas_limit":30000000,"parent_id":"0x00e4e1bf23a82502afa467a832d9b5ff5de916476f29c5252c4b9b00c669856e","timestamp":"2023-04-03T12:09:20.000Z","beneficiary":"0x762382e169c3488f50b9e2655714ce47fd40be03","total_score":1458595311,"gas_used_pct":0,"is_finalized":true},"meta":{"timestamp":"2026-06-10T14:01:38.800Z","request_id":"f788954a-22ee-43f3-9808-a06a903b4962"},"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/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":"VeChain Thor node API (mainnet.vechain.org, live)","service":"vechain-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/block":"A block's details (revision=best|number|0xid).","GET /v1/account":"An address's VET balance and VTHO energy (address=0xdec03b1419446f11cec897c9d3e0e909755562b7).","GET /v1/network":"Live chain tip and dual-token info.","GET /v1/transaction":"A transaction's clauses, value, gas and VTHO paid (id=0x + 64 hex)."},"tip_number":25056892,"description":"Live on-chain data from the VeChainThor network (VET), an enterprise-focused layer-1 blockchain with a dual-token model (VET stores value, VTHO pays for gas), via the public VeChain Thor node API. The account endpoint returns an address's VET balance, its VTHO energy and whether it is a contract; the transaction endpoint returns a transaction's origin, clauses, total VET value, gas used, VTHO paid and whether it reverted; the block endpoint returns a block's number, id, timestamp, size, gas limit and used, Proof-of-Authority beneficiary and transaction count; the network endpoint returns the live chain tip. Live, no key, nothing stored. Distinct from the Bitcoin, Litecoin, Dogecoin, Cardano, Cosmos, Solana and EVM on-chain APIs and from price feeds — this is VeChainThor's own account state, clause-based transactions, blocks and VET/VTHO dual-token data.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-10T14:01:38.942Z","request_id":"298c28dd-a042-4b3c-814d-757f939904fa"},"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":800,"monthly_call_quota":140000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2200,"monthly_call_quota":880000,"rps_limit":15,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5500,"monthly_call_quota":4700000,"rps_limit":30,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/vechain-api"}