Доступные эндпоинты

Базовый URL и общие параметры

Все эндпоинты — это запросы GET к https://metalapi.com/api/v1, и для всех нужен ключ API (см. Аутентификация). Большинство из них принимают одни и те же необязательные параметры:

• base: валюта, в которой выражены цены. По умолчанию USD; подходит любой поддерживаемый символ.
• currencies или его псевдоним symbols: список возвращаемых символов через запятую, например XAU,XAG,EUR. Если параметр не указан, возвращаются все символы.
• unit: единица массы для цен на металлы. Одно из значений: troy_oz (по умолчанию), gram, kilogram, ounce, pound, metric_ton или short_ton.

Даты указываются в формате YYYY-MM-DD и интерпретируются по UTC.

Последние курсы: /latest

Текущие цены с интервалом обновления вашего тарифа: от ежедневного на Free до каждых 5 секунд на Enterprise. На тарифе Standard и выше добавьте в currencies символы вида XAU-BID и XAU-ASK, чтобы получить цены bid и ask.

GET https://metalapi.com/api/v1/latest?api_key=YOUR_API_KEY&base=USD&currencies=XAU,XAG,EUR

Исторические курсы: /{date}

Цены закрытия за прошедший день. Поддерживаются три формы: дата в пути, /historical?date= или /yesterday.

GET /api/v1/2026-10-01?api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/historical?date=2026-10-01&api_key=YOUR_API_KEY&currencies=XAU,XAG
GET /api/v1/yesterday?api_key=YOUR_API_KEY&currencies=XAU,XAG

Конвертация: /convert

Конвертирует amount из from в to, например доллары в унции золота или серебро в евро. Добавьте date, чтобы конвертировать по исторической цене закрытия, и unit, чтобы конвертировать граммы или килограммы металла.

GET /api/v1/convert?api_key=YOUR_API_KEY&from=USD&to=XAU&amount=1000

# 500 граммов серебра в евро по цене закрытия 1 октября 2026 года
GET /api/v1/convert?api_key=YOUR_API_KEY&from=XAG&to=EUR&amount=500&unit=gram&date=2026-10-01

Период: /timeframe

Дневные цены закрытия за каждый день между start_date и end_date. Один запрос может охватывать до 30 дней на тарифе Free и до 365 дней на платных тарифах. Для более длинных периодов возвращается ошибка 207. /timeseries — псевдоним, сохранённый для совместимости.

GET /api/v1/timeframe?api_key=YOUR_API_KEY&start_date=2026-09-01&end_date=2026-09-30&currencies=XAU

Изменение: /change

Начальный курс, конечный курс, абсолютное и процентное изменение между двумя датами для каждого символа. Удобно для надписей вроде «золото выросло на 3,6% за месяц». Ограничения на длину периода те же, что и для /timeframe.

GET /api/v1/change?api_key=YOUR_API_KEY&start_date=2026-09-30&end_date=2026-10-23&currencies=XAU,XAG

OHLC: /ohlc

Цена открытия, максимум, минимум и цена закрытия за один день. Не указывайте date или передайте latest, чтобы получить текущий бар за сегодня.

GET /api/v1/ohlc?api_key=YOUR_API_KEY&date=2026-10-22&currencies=XAU,XAG

Золото по каратам: /carat

Цены на золото ювелирных проб от 24K до 8K в любой валюте и единице измерения. Передайте carat=24 (по умолчанию), одно значение, например 18, или carat=all. Поддерживаются 24, 23, 22, 21, 20, 18, 16, 14, 12, 10, 9 и 8 карат. Добавьте date, чтобы получить исторические цены по каратам.

Эндпоинт доступен на платных тарифах. Для ключей тарифа Free возвращается ошибка 106.

GET /api/v1/carat?api_key=YOUR_API_KEY&carat=all&base=EUR&unit=gram

Символы: /symbols

Список поддерживаемых символов и их названий. Добавьте details=1, чтобы получить категорию и единицу измерения каждого символа. Этот эндпоинт не расходует месячную квоту.

GET /api/v1/symbols?api_key=YOUR_API_KEY&details=1

Использование: /usage

Число использованных и оставшихся запросов в текущем расчётном месяце. Этот эндпоинт тоже бесплатный, поэтому его можно вызывать из систем мониторинга, не расходуя квоту.

GET /api/v1/usage?api_key=YOUR_API_KEY

Поток в реальном времени: /stream

Поток Server-Sent Events, который присылает обновления цен по мере их появления, так что вам не нужно опрашивать /latest. Доступен на тарифе Pro и выше. Формат событий описан в документации по стримингу.

curl -N "https://metalapi.com/api/v1/stream" \
  -H "Authorization: Bearer YOUR_API_KEY"