Universalis API

Beginner's Pick Games & Comics / No Auth Required Beginner HTTPS CORS
Free to Use Varies (check documentation)
90 A+
Measured Score 0 50 100 Reachability 30/30 Speed 10/20 Security 15/15 Developer XP 20/20 Reliability 15/15 TESTED 2026-07-23

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

Request
// ⚠️ 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.

Measured Score Breakdown

Live HTTP request to the API endpoint

Reachability 30/30
Speed 10/20
Security 15/15
Developer XP 20/20
Reliability 15/15
Endpoint Response Time 556ms

Fully tested on Jul 23, 2026

Technical Specifications

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

Related Tags

Similar APIs

View All →