Что означает XAU/USD: коды XAU, XAG, XPT и XPD

Что означает XAU/USD?

XAU/USD — это цена одной тройской унции золота в долларах США. Вот и всё значение XAU/USD в одном предложении: XAU — код золота, USD — доллар США, а число рядом с парой показывает, сколько долларов стоит одна унция золота. Если график показывает XAU/USD на уровне 3 997,89, унция золота стоит 3 997,89 доллара. Это примерное значение, которое используется во всей документации MetalAPI, а не актуальная цена.

Эта запись пришла с валютного рынка, где каждая цена записывается как пара кодов:

• Базовая валюта (первый код) — то, что оценивается, в данном случае одна тройская унция золота.
• Котируемая валюта (второй код) — то, в чём выражена цена, в данном случае доллары США.
• Курс — количество единиц котируемой валюты, которое стоит одна единица базовой.

EUR/USD устроена так же: это цена одного евро в долларах. Брокеры и торговые платформы часто опускают косую черту и пишут XAUUSD, а сайты с графиками называют тот же ряд «золото спот» (gold spot). Все эти названия обозначают спотовую цену золота в долларах за тройскую унцию — обычно среднюю между котировками bid и ask оптового рынка. Как эта средняя цена соотносится с ценами, которые на самом деле берут дилеры, объясняет статья «Спот, bid, ask и спред».

Что обозначают XAU, XAG, XPT и XPD?

У четырёх драгоценных металлов есть собственные коды в ISO 4217 — международном стандарте кодов валют. Каждый код обозначает одну тройскую унцию металла, то есть 31,1034768 грамма:

Схема простая: X, за которым следует химический символ металла. Символы золота и серебра происходят из латыни, поэтому код золота — XAU, а не что-то на G (от английского gold), а код серебра — XAG, а не что-то на S (silver).

Серебро, платина и палладий читаются точно так же, как золото. XAG/USD — цена одной тройской унции серебра в долларах (53,94 в примере из документации), XPT/USD — цена унции платины (1 612,35), а XPD/USD — цена унции палладия (1 475,80).

ISO 4217 не определяет для металлов дробную единицу. В долларе 100 центов, но официальной сотой доли унции золота не существует, поэтому количества и цены металлов записываются с таким числом знаков после запятой, какое требуется для конкретной задачи.

Почему у золота есть код валюты?

Коды ISO 4217 состоят из трёх букв. У национальных валют первые две буквы — код страны по ISO 3166, а третья обычно берётся из названия валюты: US плюс D для доллара США, JP плюс Y для японской иены. Коды, которые не принадлежат ни одной стране, начинаются с X. Кроме четырёх металлов, в эту группу входят специальные права заимствования МВФ (XDR), региональные валюты, такие как западноафриканский франк КФА (XOF) и восточнокарибский доллар (XCD), а также два технических кода: XTS для тестирования и XXX для операций без участия валюты.

Золото не является валютой ни одной страны — так почему же оно в списке валют? Потому что на оптовом рынке драгоценные металлы ведут себя во многом как валюты. Банки хранят их на металлических счетах, котируют спот к доллару США круглосуточно по будним дням и проводят расчёты по сделкам между счетами примерно так же, как на валютном рынке. Стандартный код позволяет платёжным, учётным и торговым системам проводить унцию золота так же, как евро.

Для разработчиков у этого есть практический плюс: золото помещается в любое поле, таблицу или библиотеку, которые ожидают трёхбуквенный код валюты. Подвох в том, что сумма в XAU — это количество металла в тройских унциях, а не денежная сумма. Если отформатировать её с символом валюты или округлить до двух знаков, как центы, быстро возникнут ошибки: 0,00025 XAU, округлённые как центы, превращаются в 0,00.

XAU/USD или USD/XAU: в каком направлении?

Любую пару можно записать в двух направлениях, и оба несут одну и ту же информацию. XAU/USD — это доллары за унцию золота. USD/XAU — унции золота за доллар, то есть просто 1, делённая на курс XAU/USD. С примерными ценами из документации:

По рыночному соглашению металл ставится первым, чтобы котируемое число было понятной людям ценой. USD/XAU редко встречается на экранах, но широко используется внутри программ, где таблица курсов показывает, сколько каждой валюты можно купить на единицу общей базовой валюты. У обоих направлений есть своё применение; ошибки возникают, когда их путают.

Последние две строки показывают, что котируемой стороной не обязательно должен быть доллар. XAU/EUR выражает цену золота в евро (в примере используется курс 1,1642 доллара за евро), а XAU/XAG — в унциях серебра, то есть это соотношение золота и серебра. Статья «Соотношение золота и серебра» объясняет, что показывает это число и как его отслеживать.

Простая проверка на здравый смысл выявляет почти любую ошибку направления. Цена одной тройской унции золота в национальной валюте намного больше 1, поэтому если число, которое вы собираетесь показать как цену золота, — маленькая дробь, перед вами обратный курс.

Как MetalAPI возвращает XAU и USDXAU

MetalAPI использует те же коды и возвращает оба направления для каждого запрошенного символа. Этот запрос получает цены четырёх драгоценных металлов в долларах США:

curl "https://metalapi.com/api/v1/latest?base=USD&currencies=XAU,XAG,XPT,XPD" \
  -H "X-API-Key: $METALAPI_KEY"

Объект rates содержит по два ключа на каждый символ. Ниже — примерные значения из документации:

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89,
    "XAG": 0.01853911754,
    "USDXAG": 53.94,
    "XPT": 0.000620212733,
    "USDXPT": 1612.35,
    "XPD": 0.0006775985906,
    "USDXPD": 1475.8
  }
}

Правило для ключей такое: rates.<BASE><SYMBOL> — цена одной единицы символа в базовой валюте, а простой ключ rates.<SYMBOL> — обратная величина, сохранённая для совместимости с API в стиле форекс. В рыночной нотации это выглядит так:

Чтобы превратить любую пару в запрос, используйте котируемую валюту как base, а первый код — как символ, и прочитайте ключ, который их объединяет. Эта вспомогательная функция делает это для пар, записанных как XAU/USD, XAG/EUR, XAU/XAG или даже USD/XAU. Сохраните её в файл pair.mjs и запустите в Node.js 18 или новее:

// Translate a pair such as "XAU/USD" into a MetalAPI request and read the matching key.
async function pairRate(pair) {
  const [symbol, quote] = pair.toUpperCase().split("/");
  const params = new URLSearchParams({ base: quote, currencies: symbol });
  const res = await fetch(`https://metalapi.com/api/v1/latest?${params}`, {
    headers: { "X-API-Key": process.env.METALAPI_KEY },
    signal: AbortSignal.timeout(10_000),
  });
  const data = await res.json();
  if (!data.success) throw new Error(`MetalAPI ${data.error.code} (${data.error.type}): ${data.error.info}`);

  return { pair, rate: data.rates[`${quote}${symbol}`], asOf: new Date(data.timestamp * 1000).toISOString() };
}

console.log(await pairRate("XAU/USD")); // rate 3997.89 at the example prices
console.log(await pairRate("USD/XAU")); // rate 0.0002501319446, the inverse
console.log(await pairRate("XAU/XAG")); // rate about 74.12, the gold/silver ratio

Каждый вызов — это один запрос. Если у нескольких пар общая котируемая валюта, как у XAU/USD, XAG/USD и XPT/USD, запросите все символы одним вызовом с currencies=XAU,XAG,XPT; он всё равно засчитывается как один запрос. Руководство по форматам данных показывает то же правило для валют и для цен bid и ask.

XAU — это всегда одна тройская унция?

В ISO 4217 и в рыночных котировках — да: одна единица XAU — это одна тройская унция золота, а XAU/USD — цена за тройскую унцию. Тройская унция равна 31,1034768 грамма и примерно на 9,7% тяжелее обычной торговой унции (avoirdupois) массой 28,35 грамма, поэтому цена золота никогда не бывает ценой за обычную унцию.

MetalAPI тоже по умолчанию использует тройские унции, а параметр unit меняет массу, к которой относится цена: troy_oz, gram, kilogram, ounce (торговая унция), pound, metric_ton или short_ton. При unit=gram значение EURXAU становится ценой одного грамма золота в евро, а ответ повторяет единицу в поле unit верхнего уровня, чтобы их невозможно было перепутать:

curl "https://metalapi.com/api/v1/latest?base=EUR&currencies=XAU&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

В примере из документации этот запрос возвращает "EURXAU": 110.4064149 — евро за грамм — против 3 434,02 евро за тройскую унцию. Храните единицу рядом с каждой сохранённой ценой и будьте осторожны с unit=ounce и его краткой формой oz: они означают торговую унцию. В статье «Тройские унции, граммы и килограммы» приведены точные коэффициенты и правила округления.

Другие символы: медь, энергоносители и криптовалюты

Коды ISO 4217 есть только у золота, серебра, платины и палладия. Другие сырьевые товары котируются под символами, которые следуют торговым соглашениям. MetalAPI охватывает 83 символа в пяти группах, и все они подчиняются одинаковым правилам для base, currencies и ключей:

• Драгоценные металлы: XAU, XAG, XPT и XPD — коды ISO 4217.
• Промышленные металлы: XCU — медь, ALU — алюминий, ZNC — цинк и HRC — горячекатаный рулонный прокат (сталь). XCU заимствует схему «X плюс химический символ», но это не код ISO.
• Энергоносители: WTI, BRENT, NATURALGAS, GASOLINE и HEATINGOIL, цены за баррель, MMBtu или галлон.
• Валюты: 57 валют ISO 4217, например USD, EUR, GBP, JPY и INR.
• Криптовалюты: 13 монет, включая BTC и ETH. Их тикеры взяты с бирж, а не из ISO 4217.

Поскольку базой может быть любой символ, запрос той же формы позволяет выразить цену золота в биткоинах или оценить валюту в золоте. На странице символов перечислены все коды с названиями и актуальными ценами, а GET /api/v1/symbols?details=1 возвращает категорию и единицу каждого символа и не расходует вашу квоту.

Чтобы попробовать коды самостоятельно, создайте бесплатный аккаунт. Для тарифа Free не нужна банковская карта; он включает 100 запросов в месяц с ежедневным обновлением цен — этого вполне достаточно, чтобы изучить все символы и оба направления каждого курса.

Частые вопросы

Что означает XAU?

XAU — код ISO 4217 для одной тройской унции золота. X обозначает код, который не принадлежит ни одной стране, а AU — химический символ золота, от латинского aurum. Серебро обозначается XAG, платина — XPT, палладий — XPD.

XAU/USD — это то же самое, что спотовая цена золота?

Да. XAU/USD — обычное обозначение спотовой цены золота в долларах США за тройскую унцию. Большинство сайтов и API показывают среднюю цену между bid и ask. Дилеры покупают ниже неё и продают выше, поэтому розничная монета или слиток стоят дороже, чем XAU/USD.

Чем XAUUSD отличается от XAU/USD?

В трейдинге ничем: XAUUSD — та же пара без косой черты, как её пишут многие брокеры и платформы с графиками. Однако в ответах MetalAPI эта цена — ключ USDXAU, потому что в ключах API базовая валюта стоит первой. Ключ с именем XAUUSD появляется только при base=XAU и означает обратную величину — цену одного доллара в унциях золота.

Почему значение XAU в ответе API такое маленькое?

Потому что простой ключ XAU — это обратный курс: тройские унции золота за единицу базовой валюты, например 0,00025 унции за доллар. Цена за унцию находится в ключе с префиксом: USDXAU при базовой валюте USD или EURXAU при базовой валюте EUR. Если у вас есть только обратная величина, цена равна 1, делённой на неё.

XAU — это валюта?

Не в смысле денег, которые выпускает государство. ISO 4217 присваивает коды золоту, серебру, платине и палладию, потому что банки хранят их и торгуют ими во многом как валютами, и системы, созданные для обменных курсов, могут работать с металлами в той же нотации и с теми же трёхбуквенными полями.