Network API

#Base URL

https://mlx.app/api

The same routes answer on https://explorer.mlx.app/api (one deployment serves both hosts). Every page on explorer.mlx.app is built from these endpoints, so anything you see there you can read here.

curl https://mlx.app/api/stats

const res = await fetch("https://mlx.app/api/stats");
const { chain, head } = await res.json();
console.log(chain, head.height);

import requests

d = requests.get("https://mlx.app/api/stats").json()
print(d["chain"], d["head"]["height"])

#The basics

• JSON in, JSON out. Every endpoint returns application/json, except the CSV of compute rewards and the open data files.
• No key for reads. Nothing on this section needs an account, a token or a signature. Writing to the ledger is a signed POST /api/tx, covered in Submitting transactions.
• CORS is open. Every /api/* response carries Access-Control-Allow-Origin: *, with GET, POST, OPTIONS allowed and content-type as the only allowed request header, so you can call the API straight from a page on any site.
• Only GET. Every route on these pages is a GET. A route that doesn't exist answers with the site's HTML 404 page, not JSON.

#Amounts

Ledger amounts are strings of base units, never floats. Every token on the ledger (MLX, USDC and the legacy USDT) has 6 decimals:

Read them as big integers (BigInt in JavaScript, int in Python) and divide by 10^6 only to display them.

A few summary fields are plain numbers in whole units instead, because they are prices or derived figures, not balances. Each page says which. The main ones:

• /api/token gives prices, supply and holders in whole MLX and dollars.
• /api/curve gives prices in dollars per MLX and history points in whole MLX.
• units and position (the network's place on the curve) are counted in seat units, and can carry floating-point noise such as 27.020000000000003.

#Times

Every timestamp is milliseconds since the Unix epoch, UTC (ts, receivedAt, created, until, seen, at). Hours (hour on a compute reward) and days are the millisecond value of the start of that UTC hour or day.

#Caching

Each route sets its own Cache-Control, and Vercel's CDN may serve a copy that is a few seconds old:

The response headers are the source of truth; read them rather than hard-coding a refresh rate. Rate limits on reads: see Rate limits.

#Names and privacy

• Wallet names end in .mlx (luca.mlx). Protocol accounts are named the same way: treasury.mlx, compute.mlx, rewards.mlx, community.mlx, team.mlx, bridge.mlx, withdrawals.mlx.
• What people buy is a dedicated seat. The API keeps the older word in its ids and paths: /api/nodes, /api/node/<id>, nodes fields and the buy_node transaction all mean seats.
• A Mac's own name is never published. Public reads show the kind of Mac ("MacBook Pro") instead. See Transactions.

#Errors

An error is a JSON object with one field, error, and an HTTP status:

{ "error": "Block not found" }

The statuses each route uses are listed on Errors.

#Endpoints