API Documentation

curl -X GET "https://netherapi.com/api/v2/player?uuid=..." \
     -H "API-Key: your-api-key"

Authorization: Bearer your-api-key

{
  "success": false,
  "error": "Error message description"
}

curl "https://netherapi.com/api/v2/account/value?username=Technoblade" \
     -H "API-Key: your-nether-api-key"

{
  "success": true,
  "username": "Technoblade",
  "uuid": "b876ec32e396476ba1158438d83c67d4",
  "currency": "USD",
  "profiles": [
    {
      "profile_name": "Tomato",
      "profile_id": "abc123...",
      "game_mode": "normal",
      "selected": true,
      "value": {
        "breakdown": {
          "catacombs": 45.50,
          "crimson": 5.00,
          "dungeon_classes": 4.00,
          "fairy_souls": 1.00,
          "farming": 5.00,
          "hotm": 2.00,
          "mining": 33.00,
          "networth": 120.00,
          "skills": 85.00,
          "skyblock_level": 8.00,
          "slayer": 1.20
        },
        "total": 309.70
      },
      "stats": {
        "catacombs": "Level 42.50",
        "mining": { "gemstone": "9", "glacite": "6", "mithril": "10" },
        "skills": "SA 52.30",
        "slayer": "Z9 S9 W9 E9 B9 V5"
      }
    }
  ],
  "total": 309.70
}

curl "https://netherapi.com/api/v2/account/lowball?username=Technoblade" \
     -H "API-Key: your-nether-api-key"

{
  "success": true,
  "username": "Technoblade",
  "uuid": "b876ec32e396476ba1158438d83c67d4",
  "currency": "USD",
  "profiles": [
    {
      "profile_name": "Tomato",
      "profile_id": "abc123...",
      "game_mode": "normal",
      "selected": true,
      "lowball": {
        "breakdown": {
          "catacombs": 25.28,
          "crimson": 2.78,
          "dungeon_classes": 2.22,
          "fairy_souls": 0.56,
          "farming": 2.78,
          "hotm": 1.11,
          "mining": 18.33,
          "networth": 66.67,
          "skills": 47.22,
          "skyblock_level": 4.44,
          "slayer": 0.67
        },
        "total": 172.06
      },
      "stats": {
        "catacombs": "Level 42.50",
        "mining": { "gemstone": "9", "glacite": "6", "mithril": "10" },
        "skills": "SA 52.30",
        "slayer": "Z9 S9 W9 E9 B9 V5"
      }
    }
  ],
  "total": 172.06
}

curl "https://netherapi.com/api/v2/networth/prices" \
     -H "API-Key: your-nether-api-key"

{
  "success": true,
  "updatedAt": "2026-07-19T03:02:16.346Z",
  "ageSec": 59,
  "stale": false,
  "count": 14113,
  "prices": {
    "HYPERION": 510000000,
    "NECRON_HANDLE": 168000000,
    "ENCHANTED_DIAMOND": 25400,
    "HOT_POTATO_BOOK": 210000
  }
}

{
  "success": false,
  "error": "Price data unavailable"
}

Account Valuation

Player Data

Resources

SkyBlock

Networth

Housing

Other

const API_KEY = 'your-nether-api-key';
const BASE_URL = 'https://netherapi.com/api';

async function getPlayer(uuid) {
  const response = await fetch(
    `${BASE_URL}/v2/player?uuid=${uuid}`,
    { headers: { 'API-Key': API_KEY } }
  );

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }

  return response.json();
}

// Usage
const data = await getPlayer('069a79f4-44e9-4726-a5be-fca90e38aaf5');
console.log(data.player.displayname);

const API_KEY = 'your-nether-api-key';
const BASE_URL = 'https://netherapi.com/api';

async function getAccountValue(username) {
  const response = await fetch(
    `${BASE_URL}/v2/account/value?username=${username}`,
    { headers: { 'API-Key': API_KEY } }
  );

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }

  return response.json();
}

// Usage
const data = await getAccountValue('Technoblade');
console.log(`Total value: $${data.total}`);
for (const p of data.profiles) {
  console.log(`${p.profile_name}: $${p.value.total}`);
}

import requests

API_KEY = 'your-nether-api-key'
BASE_URL = 'https://netherapi.com/api'

def get_player(uuid):
    response = requests.get(
        f'{BASE_URL}/v2/player',
        params={'uuid': uuid},
        headers={'API-Key': API_KEY}
    )
    response.raise_for_status()
    return response.json()

# Usage
data = get_player('069a79f4-44e9-4726-a5be-fca90e38aaf5')
print(data['player']['displayname'])

import requests

API_KEY = 'your-nether-api-key'
BASE_URL = 'https://netherapi.com/api'

def get_account_value(username):
    response = requests.get(
        f'{BASE_URL}/v2/account/value',
        params={'username': username},
        headers={'API-Key': API_KEY}
    )
    response.raise_for_status()
    return response.json()

# Usage
result = get_account_value('Technoblade')
print(f"Total value: ${result['total']}")
for p in result['profiles']:
    print(f"{p['profile_name']}: ${p['value']['total']}")

curl "https://netherapi.com/api/v2/networth/prices" \
     -H "API-Key: your-nether-api-key"

const API_KEY = 'your-nether-api-key';
const BASE_URL = 'https://netherapi.com/api';

async function getPrices() {
  const response = await fetch(
    `${BASE_URL}/v2/networth/prices`,
    { headers: { 'API-Key': API_KEY } }
  );

  if (response.status === 503) {
    throw new Error('Price data unavailable — retry after 30s');
  }

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }

  return response.json();
}

// Usage — one request gives you the whole table
const data = await getPrices();

// stale is null when the table is being served but its age is unknown, so
// check for that before treating false as "definitely fresh".
if (data.stale === null) {
  console.warn('Price age unknown — metadata unavailable');
} else if (data.stale) {
  console.warn(`Prices are ${data.ageSec}s old`);
}

// Look up a single item. count is null on that same metadata-missing path.
console.log(`${data.count ?? Object.keys(data.prices).length} items priced`);
console.log(`HYPERION: ${data.prices['HYPERION']}`);

// Price an inventory locally — no further requests
const inventory = { HYPERION: 1, NECRON_HANDLE: 2, ENCHANTED_DIAMOND: 320 };
const total = Object.entries(inventory).reduce(
  (sum, [id, qty]) => sum + (data.prices[id] ?? 0) * qty,
  0
);
console.log(`Inventory total: ${total}`);

import requests

API_KEY = 'your-nether-api-key'
BASE_URL = 'https://netherapi.com/api'

def get_prices():
    response = requests.get(
        f'{BASE_URL}/v2/networth/prices',
        headers={'API-Key': API_KEY}
    )
    if response.status_code == 503:
        raise RuntimeError('Price data unavailable - retry after 30s')
    response.raise_for_status()
    return response.json()

# Usage - one request gives you the whole table
data = get_prices()

# stale is None when the table is being served but its age is unknown, so
# check for that before treating False as "definitely fresh".
if data['stale'] is None:
    print('Price age unknown - metadata unavailable')
elif data['stale']:
    print(f"Prices are {data['ageSec']}s old")

# Look up a single item. count is None on that same metadata-missing path.
count = data['count'] if data['count'] is not None else len(data['prices'])
print(f"{count} items priced")
print(f"HYPERION: {data['prices']['HYPERION']}")

# Price an inventory locally - no further requests
inventory = {'HYPERION': 1, 'NECRON_HANDLE': 2, 'ENCHANTED_DIAMOND': 320}
total = sum(data['prices'].get(item, 0) * qty for item, qty in inventory.items())
print(f'Inventory total: {total}')