НА ЖИВО
НачалоAPI
Отворени данни · JSON · без регистрация

Публично API

Същите данни, които виждате на сайта — достъпни програмно. Безплатно за разумна употреба; посочването на Goldinvest.bg като източник е достатъчно.

Крайни точки

EndpointВръща
GET /api/v1/latestвсички текущи цени + индекс
GET /api/v1/ratio/{a}/{b}текущо съотношение между два актива
GET /api/v1/history/{asset}дневни исторически стойности
GET /api/v1/indexиндексът + компоненти + история

Кеш: 60 секунди на ръба на мрежата. CORS: отворен. Всички цени в мерните единици на сайта (метали: евро за тройунция).

Условия за ползване

Безплатно за разумна употреба — без регистрация и без ключ. Единственото условие е да посочите Goldinvest.bg като източник, ако публикувате данните. При автоматизирано теглене, моля, не надхвърляйте едно запитване в минута за крайна точка: данните така или иначе се обновяват на всеки няколко минути.

Стабилност на схемата

Идентификаторите на активите (zlato, srebro, …) и структурата на отговорите са фиксирани. Ако се наложи несъвместима промяна, тя ще влезе в нова версия на пътя (/api/v2/), а текущата ще продължи да работи.

GET /api/v1/ratio/zlato/srebro

{
  "base": "zlato",
  "quote": "srebro",
  "value": 70.2,
  "unit": "oz t сребро за 1 oz t злато",
  "updated": "2026-08-03T17:45:00Z",
  "source": "goldinvest.bg"
}
Въпроси

Често задавани въпроси

Трябва ли ми ключ или регистрация?

Не. API-то е публично и не изисква ключ, регистрация или заплащане. CORS е отворен, така че може да се извиква директно от браузър.

Мога ли да използвам данните в свой сайт или приложение?

Да, свободно за разумна употреба — единственото условие е да посочите Goldinvest.bg като източник, ако публикувате числата.

Колко назад стигат историческите данни?

Над 5 години дневни стойности за повечето активи, достъпни през /api/v1/history/{asset}. Обхватът расте с всеки изминал ден, тъй като платформата записва собствени данни.

Пример

Едно запитване

curl https://goldinvest.bg
  /api/v1/latest

# текущи цени на 12 актива,
# GSR и стойността на индекса
# в един JSON отговор

Същите числа, които виждате на страниците на сайта — без разлика и без забавяне.