# VeChain API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/vechain-api/..."
```

## Pricing
- **Free** (Free) — 9,000 calls/Mo, 3 req/s
- **Basic** ($8/Mo) — 140,000 calls/Mo, 8 req/s
- **Pro** ($22/Mo) — 880,000 calls/Mo, 15 req/s
- **Scale** ($55/Mo) — 4,700,000 calls/Mo, 30 req/s

## Endpoints

### Network

#### `GET /v1/network` — Live VeChainThor chain tip and dual-token info

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vechain-api/v1/network"
```

**Response:**
```json
{
    "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
}
```

### Account

#### `GET /v1/account` — An address VET balance and VTHO energy

**Parameters:**
- `address` (query, required, string) — VeChain address (0x + 40 hex) Example: `0xdec03b1419446f11cec897c9d3e0e909755562b7`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vechain-api/v1/account?address=0xdec03b1419446f11cec897c9d3e0e909755562b7"
```

**Response:**
```json
{
    "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
}
```

### Transaction

#### `GET /v1/transaction` — A transaction clauses, value, gas and VTHO paid

**Parameters:**
- `id` (query, required, string) — Transaction id (0x + 64 hex) Example: `0x9372643acdda521e7ec30de971dda3f4561ca5a7109414326b08735bf1caf206`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vechain-api/v1/transaction?id=0x9372643acdda521e7ec30de971dda3f4561ca5a7109414326b08735bf1caf206"
```

**Response:**
```json
{
    "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
}
```

### Block

#### `GET /v1/block` — A block details by revision

**Parameters:**
- `revision` (query, optional, string) — Block number, 0x block id or best Example: `15000000`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vechain-api/v1/block?revision=15000000"
```

**Response:**
```json
{
    "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
}
```

### Meta

#### `GET /v1/meta` — Service metadata and endpoint catalog

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/vechain-api/v1/meta"
```

**Response:**
```json
{
    "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-toke
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/vechain-api
OpenAPI spec: https://www.oanor.com/api/vechain-api/openapi.json