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.
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.
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}'
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.