Universalis API

⭐ Beginner's Pick Games & Comics / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)

Overview

Universalis is a crowdsourced Final Fantasy XIV market board API providing real-time and historical pricing data for in-game items across all game worlds and data centres. It requires no authentication and is completely free to use. Ideal for FFXIV players and developers who want to build price-checking tools or market analysis apps.

💡

Beginner Tip

Use the item's numeric ID (found on the FFXIV wiki or XIVAPI) and a world name like "Gilgamesh" or a data centre like "Aether" as path parameters. Historical data is available at the /history endpoint using the same parameters.

Available Data

stock price and symbol
open/close/high/low values
trading volume
market cap
historical price data

Example Response

JSON Response
{
  "id": 1,
  "name": "Universalis",
  "data": "Final Fantasy XIV market board data",
  "source": "Universalis"
}

Field Reference

itemID The numeric FFXIV item identifier that was queried.
worldName The game world or data centre for which market data is returned.
listings Active market board listings sorted by price, each with pricePerUnit and quantity.
recentHistory Recently completed sales showing historical transaction prices.
minPrice Lowest price per unit currently listed on the market board.
averagePrice Average sale price per unit across recent transactions.

Implementation Example

// ⚠️ Note: This URL may be a documentation page. Check official docs for actual API endpoint.
const url = "https://universalis.app/docs/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

404 Not Found The world name or item ID is incorrect or misspelled.
World names are case-sensitive; use the exact name as shown on the FFXIV Lodestone, e.g. Gilgamesh not gilgamesh.
Empty listings array No one is currently selling that item on the specified world's market board.
Try a more populated world or data centre name to find active listings.
Rate limit exceeded Too many requests in a short window.
Cache item price data locally and refresh at intervals; avoid polling the API more than once every few seconds.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 10/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 603ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS YES
Category Games & Comics
Difficulty Beginner
Verified: 2026-04-07

Similar APIs

View All →