Публично API
Същите данни, които виждате на сайта — достъпни програмно. Безплатно за разумна употреба; посочването на Goldinvest.bg като източник е достатъчно.
Адреси на API
| 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/), а текущата ще продължи да работи.
{
"base": "zlato",
"quote": "srebro",
"value": 66.1,
"updated": "2026-09-20T01:06:04Z",
"source": "goldinvest.bg"
}
Често задавани въпроси
Трябва ли ми ключ или регистрация?
Не. API-то е публично и не изисква ключ, регистрация или заплащане. CORS е отворен, така че може да се извиква директно от браузър.
Мога ли да използвам данните в свой сайт или приложение?
Да, свободно за разумна употреба — единственото условие е да посочите Goldinvest.bg като източник, ако публикувате числата.
Колко назад стигат историческите данни?
Над 5 години дневни стойности за повечето активи, достъпни през /api/v1/history/{asset}. Обхватът расте всеки ден, защото платформата записва собствени данни.
Едно запитване
/api/v1/latest
# текущи цени на 12 актива,
# GSR и стойността на индекса
# в един JSON отговор
Точно същите стойности, които виждате на страниците на сайта.
Типични заявки
Текуща цена на златото за грам. Вземете assets.zlato.price от /api/v1/latest и разделете на 31,1035 — стойността е в евро за грам чист метал.
Стойност на бижу по проба. Същата стойност, умножена по пробата, разделена на 1000: 585 за 14 карата, 750 за 18 карата.
Съотношение между два актива. /api/v1/ratio/zlato/srebro връща готовото съотношение, за да не се налага да го смятате сами.
Дълга история за графика. /api/v1/history/zlato?from=2021-01-01 връща дневни OHLC стойности.
Стойността на индекса. /api/v1/index връща цялата серия заедно с трите компонента за всеки ден.
Как да ползвате API-то коректно
Данните се обновяват на всеки няколко минути, затова заявка по-често от веднъж в минута няма да върне нова информация. Кеширайте отговора си локално.
Идентификаторите на активите и структурата на отговорите са фиксирани. Несъвместима промяна ще влезе като нова версия на пътя, а текущата ще продължи да работи.
Ако публикувате стойностите, посочете Goldinvest.bg като източник. Това е единственото условие за безплатно ползване.
За езикови модели и асистенти
Машинно четимо резюме на текущите стойности с връзки към съответните страници се поддържа на /llms.txt и се генерира при всяка заявка от същите данни, които виждате на страниците.