Trust and Transparency

Glossary Methodology & Structured Export

Direct answer: The Swoopr Investment Investment & Trading Glossary is built from a single authoring source (a structured term record with fields for definition, formula, worked example, common misconception, risk, market applicability, and sourcing metadata), reviewed on a cadence tied to how time-sensitive each term is, and republished as a machine-readable JSON export at /glossary-export.json every time the glossary changes.

This page explains how glossary terms are authored, sourced, and reviewed, and documents the structured export developers, researchers, and other publishers can use instead of scraping the rendered page. It works alongside the Citation & Sources Policy (site-wide sourcing rules) and the Editorial Policy (how content generally gets researched and reviewed).

Where does a glossary term come from?

Every term starts as one record in a single internal authoring file that the Swoopr Editorial Team maintains. A term record carries a canonical id and slug, the term name and any aliases, a market taxonomy tag, a category and difficulty level, and, once written, a definition, an optional formula, a worked example, a common misconception, a risk note, and links to related terms and to any full guide that covers the concept in more depth. Only terms with a written definition are ever published; a term can exist in the authoring file as a planned entry (an id, a slug, a category) before its definition is written, and it simply isn't shown until it is.

How is a term sourced?

A short glossary definition doesn't carry a full References section the way a guide page does, but the same source hierarchy from the Citation & Sources Policy applies: a definition that depends on a current law, regulatory rule, tax treatment, filing requirement, exchange procedure, or protocol specification is checked against an authoritative source before publication, not written from memory or a single secondary summary. Many term records also carry a `sources` field naming the reference materials consulted while writing that definition.

How often is a term reviewed?

Every published term carries a review-frequency tag. Terms tied to regulatory rules, tax treatment, or protocol mechanics that change on a predictable schedule are tagged for quarterly review; terms describing more stable market structure, strategy, or statistical concepts are tagged for annual review. A term flagged during a scheduled review for a stale rule, a changed tax treatment, or an outdated protocol detail gets corrected the same way any other factual correction does, see the Corrections Policy.

Why does one term sometimes apply to multiple markets?

A term's market tag is a list, not a single value, because plenty of concepts genuinely span markets, the Relative Strength Index means the same thing whether it's plotted on a stock chart or a crypto chart, so it's tagged for both rather than duplicated into two near-identical records. Markets currently tracked are Stocks, Crypto, Options, Futures, and DeFi.

How are duplicate or colliding terms handled?

Every term's id and URL slug are required to be unique and to match each other. Because slug generation collapses both spaces and hyphens to the same character, two differently-styled versions of a similar name (for example "market maker" and "market-maker") can collide even though they look distinct in the authoring file, the site's own data checks catch this before publication, and a genuine ambiguity (the same abbreviation meaning two different things, like ETH for "Ether" versus "Extended Trading Hours") is kept as two separate records rather than forced into one.

What is the structured export?

The published glossary, every term with a written definition, currently rendered on the glossary page itself, is also published as a plain JSON file at /glossary-export.json. It's the same data the site renders, in the same shape, without the HTML wrapper: an array of term records, each with the fields described above (id, term, slug, aliases, markets, category, level, definition, formula, example, misconception, risk, related terms, hub, guide URL, sources, and review cadence). The export regenerates automatically every time the glossary's authoring file changes, so it never drifts out of sync with what's rendered on the live page. There is no authentication or rate limit on this file; it's intended for reuse by educators, researchers, and other publishers, with attribution to Swoopr Investment appreciated but not required for non-commercial use.

Developers who prefer the browser-native format the site itself loads can also read /glossary-data.js directly, it's the same term array, assigned to window.GLOSSARY_TERMS instead of wrapped in a JSON envelope.

How do term counts change over time?

The glossary grows in batches, not continuously, a batch of terms in a given topic area (for example, options, macro/economics, or crypto/DeFi) gets researched, drafted, and reviewed together, then published at once. The most recent expansion, in August 2026, took the published glossary from 3,809 terms to 10,289 across twenty-eight parallel authoring batches. It filled every one of the 808 records that existed as a headword with no definition, so no entry now ships without one. Roughly a fifth of every batch was rejected rather than published, because the proposed term already existed under a different spelling, a plural, an expanded form or a synonym; that rejection work is why the count reflects distinct concepts rather than restated ones. The same pass merged 86 groups of records that had turned out to be one concept, recased 278 headwords that had arrived in capitals from their source, and rewrote 454 passages that used an em dash. The exact current published-term count is always whatever the live glossary page and the structured export report, it isn't restated here as a fixed number because it changes with every batch.

What quality checks does a new or edited term go through?

Before a term is published or an existing definition is changed, it's checked for a circular definition (a definition that just restates the term itself), for whether it duplicates an existing term or alias under a different name, and, for market-tagged terms, that every tag is a recognized market rather than a typo or an invented category. A term whose classification is uncertain (an ambiguous acronym, a borderline market tag, a definition that needs editorial judgment rather than a mechanical check) gets a human review pass rather than being published on the strength of an automated check alone.