<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>Open Market Rank API Documentation</title>
<meta name="description" content="Access the latest Open Market Rank rankings and permanent historical data snapshots in JSON format.">
<meta name="google-site-verification" content="bc23He0sQczdKb4wMtlEljy14EX89ptUi1423wwbjUg">
<link rel="canonical" href="https://openmarketrank.com/api/">
<meta name="robots" content="max-snippet:-1, max-image-preview:large">
<meta property="og:site_name" content="Open Market Rank">
<meta property="og:title" content="Open Market Rank API Documentation">
<meta property="og:description" content="Access the latest Open Market Rank rankings and permanent historical data snapshots in JSON format.">
<meta property="og:type" content="website">
<meta property="og:locale" content="en">
<meta property="og:url" content="https://openmarketrank.com/api/">
<meta property="og:image" content="https://openmarketrank.com/s/img/og-default.png">
<meta property="og:image:width" content="1200">
<meta property="og:image:height" content="630">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:image" content="https://openmarketrank.com/s/img/og-default.png">
<meta name="theme-color" content="#ffffff">
<link rel="icon" href="/s/img/favicon.svg" type="image/svg+xml">
<link rel="icon" href="/s/img/favicon-32.png" sizes="32x32" type="image/png">
<link rel="apple-touch-icon" href="/s/img/apple-touch-icon.png">
<link rel="preload" href="/s/fonts/publicsans.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" href="/s/omr.css?v=4c2ab592">
<script defer src="https://getmair.com/analytics/umami/script.js" data-website-id="68855850-3b48-4714-a827-f7fc2a131791"
 data-domains="openmarketrank.com,www.openmarketrank.com"></script>
<script type="application/ld+json">{"@graph":[{"@context":"https://schema.org","@type":"Organization","@id":"https://openmarketrank.com/#publisher","name":"Haydamax","url":"https://haydamax.com","brand":{"@type":"Brand","name":"Open Market Rank","url":"https://openmarketrank.com"}},{"@context":"https://schema.org","@type":"WebSite","@id":"https://openmarketrank.com/#website","name":"Open Market Rank","url":"https://openmarketrank.com/","inLanguage":"en","publisher":{"@id":"https://openmarketrank.com/#publisher"}},{"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://openmarketrank.com/"},{"@type":"ListItem","position":2,"name":"About","item":"https://openmarketrank.com/about.html"},{"@type":"ListItem","position":3,"name":"API","item":"https://openmarketrank.com/api/"}]}]}</script>
</head>
<body data-snapshot="2026-09-19T18Z">
<a class="skip" href="#main">Skip to content</a>
<header class="mast"><div class="wrap">
  <a class="brand" href="/" aria-label="Open Market Rank home">
    <svg class="mark" viewBox="0 0 32 32" aria-hidden="true" focusable="false"><rect class="rule" x="5.4" y="6" width="2.2" height="20" rx="1.1"/><rect class="rule" x="5.4" y="8.6" width="4.6" height="2.2" rx="1.1"/><rect class="r1" x="11" y="7.5" width="15" height="5" rx="2.5"/><rect class="r2" x="11" y="14.5" width="10.5" height="5" rx="2.5"/><rect class="r3" x="11" y="21.5" width="7.5" height="5" rx="2.5"/></svg>
    <span class="wm">Open Market Rank</span></a>
  <nav class="main" aria-label="Primary navigation">
  <div class="menu"><button type="button" class="nav-top" aria-expanded="false"
    
    >Rankings<svg class="ic cv" width="16" height="16" viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 8l5 5 5-5"/></svg></button>
    <div class="drop wide"><a href="/rankings/countries.html"><b>Countries</b><span>Largest economies by GDP</span></a><a href="/rankings/currencies.html"><b>Currencies</b><span>Largest money supplies</span></a><a href="/rankings/crypto.html"><b>Crypto</b><span>Largest cryptocurrencies by market cap</span></a><a href="/rankings/market-size.html"><b>Market size overview</b><span>Compare the scale of the three tracked markets</span></a></div></div>
  <a href="/compare.html">Compare</a>
  <a href="/research/">Research</a>
  <a href="/news.html">News</a>
  <div class="menu"><button type="button" class="nav-top" aria-expanded="false"
    >About<svg class="ic cv" width="16" height="16" viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 8l5 5 5-5"/></svg></button>
    <div class="drop"><a href="/about.html">About Open Market Rank</a><a href="/methodology.html">Methodology</a><a href="/sources.html">Data sources</a><a href="/snapshots/">Snapshots</a><a href="/glossary.html">Glossary</a><a href="/faq.html">FAQ</a><a href="/api/">API</a></div></div>
</nav>
  <form class="finder" role="search" action="/search.html" method="get">
    <svg class="ic fi" width="18" height="18" viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="9" cy="9" r="6"/><path d="M13.5 13.5 17.5 17.5"/></svg>
    <input type="search" name="q" autocomplete="off" spellcheck="false"
      placeholder="Search countries, currencies or cryptocurrencies"
      aria-label="Search Open Market Rank" role="combobox" aria-expanded="false"
      aria-controls="finder-list" aria-autocomplete="list">
    <ul id="finder-list" role="listbox" aria-label="Search results"></ul>
  </form>
  <details class="status">
  <summary aria-haspopup="dialog"><span class="dot amber" aria-hidden="true"></span>
    <span class="lbl">Data</span>
    <span class="when">Sep 19 · 18:00 UTC</span><svg class="ic cv" width="14" height="14" viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M5 8l5 5 5-5"/></svg></summary>
  <div class="status-pop" role="dialog" aria-label="Data status">
    <p class="t">Data status</p>
    <p>Snapshot updated <b>Sep 19, 2026 · 18:00 UTC</b></p>
    <p>843 entries tracked</p>
    <p>8 values are using their latest previously available observation.</p>
    <p class="id">Snapshot ID: 2026-09-19T18Z</p>
    <p class="links"><a href="/snapshots/2026-09-19T18Z.html">Open
      snapshot</a><a href="/methodology.html">About data freshness</a></p>
  </div>
</details>
  <button class="mburger" type="button" aria-expanded="false"
    aria-label="Open navigation menu"><svg class="ic" width="22" height="22" viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 6h14M3 10h14M3 14h14"/></svg></button>
</div></header>
<nav class="crumbs" aria-label="Breadcrumb"><div class="wrap"><a href="/">Home</a><span class="sep" aria-hidden="true">/</span><a href="/about.html">About</a><span class="sep" aria-hidden="true">/</span><span aria-current="page">API</span></div></nav>
<main id="main">
<div class="wrap">
  <div class="page-head">
    <p class="eyebrow">Developers</p>
    <h1>Open Market Rank API</h1>
    <p class="lead">Access the latest rankings and permanent historical snapshots as
      JSON. The API exposes the same data the website is drawn from — no key, no
      sign-up.</p>
  </div>

  <section class="sec" id="quick-start">
    <div class="sec-head"><h2>Quick start</h2>
      <p>Use the latest endpoint when you always want the newest published
        snapshot.</p></div>
    <div class="note" style="display:flex;flex-wrap:wrap;gap:14px;align-items:center">
      <code style="font-size:15px;color:var(--ink)">GET /api/latest.json</code>
      <span class="grow" style="flex:1 1 auto"></span>
      <button class="tool-btn" type="button" data-copy="https://openmarketrank.com/api/latest.json"
        data-ev="api_docs_open">Copy endpoint</button>
      <a class="btn secondary" href="/api/latest.json" data-ev="raw_json_open">Open JSON<svg class="ic btn-ic" width="18" height="18" viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M8 5h7v7M15 5 6 14"/></svg></a>
    </div>
    <ul class="toc"><li><a href="#quick-start">Quick start</a></li><li><a href="#latest-data">Latest data</a></li><li><a href="#historical-snapshots">Historical snapshots</a></li><li><a href="#response-schema">Response schema</a></li><li><a href="#dates-and-freshness">Dates and freshness</a></li><li><a href="#errors">Errors</a></li><li><a href="#attribution">Attribution</a></li><li><a href="#rate-limits">Rate limits</a></li></ul>
  </section>

  <section class="sec" id="latest-data">
    <div class="sec-head"><h2>Latest data</h2></div>
    <div class="prose">
      <p>The latest endpoint returns the most recent published snapshot across
        countries, currencies and cryptocurrencies. Its contents change whenever a
        new snapshot is published; use a historical snapshot endpoint when you need a
        permanent response.</p>
    </div>
  </section>

  <section class="sec" id="historical-snapshots">
    <div class="sec-head"><h2>Historical snapshots</h2></div>
    <div class="prose">
      <p>Snapshot endpoints are permanent references to previously published data.
        They are the preferred option for citations, reproducible research and
        archived analyses. Snapshot identifiers use the UTC publication time, for
        example <code>2026-09-19T18Z</code>.</p>
      <ul><li><code>GET /api/snapshot/2026-09-19T18Z.json</code></li><li><code>GET /api/snapshot/2026-09-19T06Z.json</code></li><li><code>GET /api/snapshot/2026-09-18T18Z.json</code></li></ul>
      <p><a href="/snapshots/">Browse all snapshots</a></p>
    </div>
  </section>

  <section class="sec" id="response-schema">
    <div class="sec-head"><h2>Response schema</h2>
      <p>Each response carries snapshot metadata and one record per entity. Field
        availability depends on the entity type.</p></div>
    <pre class="code"><code>{
  &quot;site&quot;: &quot;Open Market Rank&quot;,
  &quot;snapshot&quot;: &quot;2026-09-19T18Z&quot;,
  &quot;built_at&quot;: &quot;2026-09-20T03:35:02+00:00&quot;,
  &quot;entities&quot;: [
    {
      &quot;id&quot;: &quot;country:usa&quot;,
      &quot;type&quot;: &quot;country&quot;,
      &quot;name&quot;: &quot;United States&quot;,
      &quot;rank_in_type&quot;: 1,
      &quot;size_flow_usd&quot;: 30769700000000.0,
      &quot;size_flow_basis&quot;: &quot;gdp&quot;,
      &quot;as_of&quot;: &quot;2025&quot;,
      &quot;sources&quot;: [&quot;worldbank&quot;]
    }
  ]
}</code></pre>
    <div class="prose">
      <p><b>snapshot</b> — identifier of the published snapshot.<br>
        <b>built_at</b> — UTC time the snapshot was generated.<br>
        <b>as_of</b> — reporting period of the underlying source value.<br>
        <b>sources</b> — providers behind the record.<br>
        <b>rank_in_type</b> — position within the entity's own class.</p>
      <p>Single records are also served individually:
        <code>GET /api/e/country-usa.json</code>.</p>
    </div>
  </section>

  <section class="sec" id="dates-and-freshness">
    <div class="sec-head"><h2>Dates and freshness</h2></div>
    <div class="prose">
      <p>Do not treat the snapshot timestamp as the reporting date of every value in
        the response. Economic statistics, money-supply observations, exchange rates
        and crypto market data update on different schedules; record-level fields
        identify the reporting period of the underlying observation separately.</p>
    </div>
  </section>

  <section class="sec" id="errors">
    <div class="sec-head"><h2>Errors</h2></div>
    <div class="prose">
      <p><code>404 Not Found</code> — the requested snapshot or resource does not
        exist.<br>
        <code>500 Internal Server Error</code> — the request could not be completed
        because of a server error.</p>
    </div>
  </section>

  <section class="sec" id="attribution">
    <div class="sec-head"><h2>Attribution</h2></div>
    <div class="prose">
      <p>When using Open Market Rank data publicly, link back to Open Market Rank and
        retain the original data-source attribution where practical. Source providers
        may have their own licensing requirements — check the
        <a href="/sources.html">data sources</a> page before redistributing source
        data.</p>
    </div>
  </section>

  <section class="sec" id="rate-limits">
    <div class="sec-head"><h2>Rate limits</h2></div>
    <div class="prose">
      <p>No public rate limit is currently documented. Clients should avoid
        unnecessary repeated requests and cache snapshot responses where
        practical.</p>
    </div>
  </section>

  <section class="sec">
    <div class="sec-head"><h2>Need a permanent response?</h2>
      <p>Use a historical snapshot endpoint when the data behind your application,
        article or analysis must remain reproducible.</p></div>
    <div class="btns"><a class="btn secondary" href="/snapshots/">Browse snapshots</a></div>
  </section>
</div>
</main>
<footer class="site"><div class="wrap">
  <div class="cols"><div><h3>Rankings</h3><ul><li><a href="/rankings/countries.html">Countries</a></li><li><a href="/rankings/currencies.html">Currencies</a></li><li><a href="/rankings/crypto.html">Crypto</a></li><li><a href="/rankings/market-size.html">Market size overview</a></li></ul></div><div><h3>Explore</h3><ul><li><a href="/compare.html">Compare</a></li><li><a href="/research/">Research</a></li><li><a href="/news.html">News</a></li></ul></div><div><h3>Data</h3><ul><li><a href="/snapshots/">Snapshots</a></li><li><a href="/methodology.html">Methodology</a></li><li><a href="/sources.html">Data sources</a></li><li><a href="/glossary.html">Glossary</a></li><li><a href="/api/">API</a></li></ul></div><div><h3>Open Market Rank</h3><ul><li><a href="/about.html">About</a></li><li><a href="/faq.html">FAQ</a></li><li><a href="mailto:contact@openmarketrank.com">contact@openmarketrank.com</a></li></ul></div></div>
  <div class="foot">
    <p>© 2026 Open Market Rank. A financial-data project of
      <a href="https://haydamax.com" rel="noopener">Haydamax</a>. Data is collected from
      external providers; original providers remain authoritative for their
      definitions, revisions and publication schedules.</p>
    <p>Open Market Rank provides financial and economic data for informational and
      research purposes. Data may be delayed, revised or unavailable. Nothing here
      constitutes personalized investment advice.</p>
    <p class="by">Developed by <a href="https://www.spng.space" rel="noopener">Sponge</a></p>
  </div>
</div></footer>
<script src="/s/omr.js?v=26a1d5ba" defer></script>
<script src="/s/omr-live.js?v=0c32685c" defer></script>
</body>
</html>
