Developers
Build on the lab-grown diamond market.
StoneOS is API-first infrastructure, not a portal. Query aggregated lab-grown inventory and cross-supplier price discovery through a clean, keyed JSON API (with OpenAPI) — and build your own storefront, pricing, and procurement on top.
The API
One request, the whole market.
Full reference: OpenAPI 3.1 spec. The major version is in the URL (/v1); breaking changes ship under a new major with a Sunset header on the old one.
$ curl https://api.openstoneos.com/v1/diamonds?shape=Round \
-H "Authorization: Bearer sk_live_..."
{
"data": [
{
"sku": "LAB-RD-150-FVS1",
"supplierId": "f0000000-...-0001",
"shape": "Round",
"carat": 1.5,
"color": "F",
"clarity": "VS1",
"cut": "Ideal",
"cert": { "lab": "IGI", "number": "LG123456789" },
"pricing": {
"unitPrice": 780.00,
"pricePerCarat": 520.00,
"platformFee": 39.00,
"total": 819.00,
"currency": "USD"
}
}
],
"count": 1
}What the API gives you.
One normalized feed and one price-discovery primitive — enough to back very different products.
Aggregated inventory
One API over normalized lab-grown inventory from many suppliers — the 4 Cs in a single canonical schema, reconciled and fresh.
Price discovery built in
GET /v1/diamonds/compare returns best price, spread, and median $/ct for an exact spec across every supplier — a first-class primitive.
Keyed, metered, tiered
Issue keys per integration; per-key rate limits, monthly quotas, and tier-gated access. Inventory is never public.
Build your product on it
Power your own storefront, pricing tool, or procurement system — StoneOS is infrastructure, not a portal you log into.
Endpoints.
A small, focused surface. Every call is keyed, metered, and tier-gated — inventory is never public.
/v1/diamondsQuery normalized lab-grown inventory across every supplier — filter by shape and the 4 Cs.
/v1/diamonds/compareBest price, spread, and median $/ct for an exact spec across every supplier.
Get an API key
API access is available on Trade plans. Create an account, then talk to us about a key.