Koskamo

Currency codes with sources.

Look up a currency code and its registry metadata without confusing that reference with a market quote.

Choose the currency record

Search US Dollar (USD) within iso-4217-currencies. Check the alphabetic code and title together: similarly named entries can represent distinct codes. Keep the numeric code, minor-unit field, and named source list with the result.

Read the source and date

The recorded example names the SIX maintenance agency and the source list. Inspect the list and its publication date when currency-code changes matter. A new Koskamo document version records a content change; it is not a market update.

Keep rates outside this lookup

Currency codes and minor-unit metadata do not provide exchange rates, quotes, or transaction fees. A conversion question needs another source. Do not use a matching currency name as evidence for a rate.

Try the lookup

Run this in a POSIX shell with curl. Public reads need no account or API key.

Lookup command
curl --fail-with-body 'https://koskamo.com/api/v1/retrieve' -H 'Content-Type: application/json' --data-raw '{"query":"US Dollar (USD)","dataset":"iso-4217-currencies","top_k":3}'

Read the returned evidence

Selected fields from the first passage returned on 2026-10-08. This is a recorded example; current versions and ranking may change. A response can contain other matches, so check the title and text before using a passage.

Recorded passage
{
  "text": "US Dollar (USD) is a current ISO 4217 currency code published by the SIX Group maintenance agency in List One.\n\n- Currency code: USD\n- Numeric code: 840\n- Currency name: US Dollar\n- Minor units: 2\n- Entity: AMERICAN SAMOA\n- Entity: BONAIRE, SINT EUSTATIUS AND SABA\n- Entity: BRITISH INDIAN OCEAN TERRITORY (THE)\n- Entity: ECUADOR\n- Entity: EL SALVADOR\n- Entity: GUAM\n- Entity: HAITI\n- Entity: MARSHALL ISLANDS (THE)\n- Entity: MICRONESIA (FEDERATED STATES OF)\n- Entity: NORTHERN MARIANA ISLANDS (THE)\n- Entity: PALAU\n- Entity: PANAMA\n- Entity: PUERTO RICO\n- Entity: TIMOR-LESTE\n- Entity: TURKS AND CAICOS ISLANDS (THE)\n- Entity: UNITED STATES MINOR OUTLYING ISLANDS (THE)\n- Entity: UNITED STATES OF AMERICA (THE)\n- Entity: VIRGIN ISLANDS (BRITISH)\n- Entity: VIRGIN ISLANDS (U.S.)\n- List: ISO 4217 List One (current currency codes)\n- List published: 2026-09-17",
  "datasetSlug": "iso-4217-currencies",
  "datasetVersion": 316,
  "documentId": "38115ed1-19b1-437b-b2c0-73cf6b6a16c2",
  "documentTitle": "USD US Dollar",
  "documentVersion": 1,
  "sourceUrl": "https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html"
}

Keep the citation with the answer

Keep documentId and documentVersion together with the dataset slug, document title, and original source URL. The dataset version describes the collection; it is not the document version. Preserve this evidence through summarization and show it with the final answer.

Versioned citation
USD US Dollar, document v1, iso-4217-currencies. https://koskamo.com/data/datasets/iso-4217-currencies/documents/38115ed1-19b1-437b-b2c0-73cf6b6a16c2?version=1 Source: https://www.six-group.com/en/products-services/financial-information/market-reference-data/data-standards.html

An empty passages array means there is no returned evidence to cite. An HTTP error is a failed lookup, not an empty result. On 429, respect Retry-After; on other failures, report the failure instead of inventing a source.

Frequently asked questions

Does this return exchange rates?
No. It returns source-linked currency reference records, not market prices or conversion rates.
Should I use datasetVersion in a document citation?
Preserve documentId and documentVersion for the exact passage. datasetVersion identifies the collection state and is not a substitute for the document version.
What if the results name a different currency?
Do not cite them as support. Refine the identifier or inspect the catalog and original source; ranking alone does not establish relevance.