# API part 1

Автор: [@asuleymanov](https://golos.id/@asuleymanov)

Представляю Вам первую часть моей публикации. В данную часть не вошли 18 из 72 (раздела Database\_API) найденных мною команд. Их я опишу позже.

***get\_trending\_tags***

Параметры:`"method":"get_trending_tags", "params":["after_tag","limit"], "id":4`

Описание: Отображает ограниченный список меток(тэгов) включающие словосочетания из первого параметра.

***get\_block\_header***

Параметры:`"method":"get_block_header", "params":["blocknumber"], "id":19`

Описание: Отображает краткую информацию по указанному блоку.

***get\_block***

Параметры:`"method":"get_block", "params":["blocknumber"], "id":20`

Описание: Отображает расширенную информацию по указанному блоку.

***get\_ops\_in\_block***

Параметры:`"method":"get_ops_in_block", "params":["block_num","only_virtual"], "id":21`

Описание: Команда должна отображать только операции в заданном блоке, но к сожалению ответ приходит пустой.

***get\_state***

Параметры:`"method":"get_state", "params":["path"], "id":22`

Описание: Отображает текущее состояние сети GOLOS. Оставить путь пустым для текущей информации.

***get\_trending\_categories***

Параметры:`"method":"get_trending_categories", "params":["searchafter","limit"], "id":23`

Описание: Позволяет искать ограниченное количество трендов категорий как текущие, так и прошлые.

***get\_best\_categories***

Параметры:`"method":"get_best_categories", "params":["after","limit"], "id":24`

Описание: Что именно делает данная команда мне пока непонятно.

***get\_active\_categories***

Параметры:`"method":"get_active_categories", "params":["after","limit"], "id":25`

Описание: Что именно делает данная команда мне пока непонятно.

***get\_recent\_categories***

Параметры:`"method":"get_recent_categories", "params":["after","limit"], "id":26`

Описание: К сожалению команда выдает все время пустой ответ. Так что неизвестно для чего она нужна. Мое понимание что она должна отображать ограниченное количество активностей в категории начиная с новой.

***get\_config***

Параметры:`"method":"get_config", "params":[], "id":27`

Описание: Отображает текущую конфигурацию узла.

***get\_dynamic\_global\_properties***

Параметры:`"method":"get_dynamic_global_properties", "params":[], "id":28`

Описание: Отображает различную информацию о текущем состоянии сети GOLOS.

***get\_chain\_properties***

Параметры:`"method":"get_chain_properties", "params":[], "id":29`

Описание: Отображает комиссию за создание пользователя, максимальный размер блока и процентную ставку GBG.

***get\_feed\_history***

Параметры:`"method":"get_feed_history", "params":[], "id":30`

Описание: Отображает историю конверсий GBG / GOLOS.

***get\_current\_median\_history\_price***

Параметры:`"method":"get_current_median_history_price", "params":[], "id":31`

Описание: Отображает текущую медианную цену конвертации GBG / GOLOS.

***get\_witness\_schedule***

Параметры:`"method":"get_witness_schedule", "params":[], "id":32`

Описание: Отображает текущее состояние делегирования.

***get\_hardfork\_version***

Параметры:`"method":"get_hardfork_version", "params":[], "id":33`

Описание: Отображает текущую версию ХФ GOLOS.

***get\_next\_scheduled\_hardfork***

Параметры:`"method":"get_next_scheduled_hardfork", "params":[], "id":34`

Описание: Отображает дату и версию ХФ GOLOS

***get\_key\_references***

Параметры:`"method":"get_key_references", "params":["key"], "id":35`

Описание: К сожалению сказать что делает данная команда не возможно. (Любой её вызов приводит к ошибке).

***get\_accounts***

Параметры:`"method":"get_accounts", "params":[["username"]], "id":36`

Описание: Отображает данные о пользователях указанных в запросе. Можно запрашивать сразу по нескольким пользователям разделив их запятыми.

***get\_account\_references***

Параметры:`"method":"get_account_references", "params":["accountid"], "id":37`

Описание: В настоящее время запрос возвращает ошибку. По идее должен выдавать информацию о пользователе по его ID.

***lookup\_account\_names***

Параметры:`"method":"lookup_account_names", "params":[["username"]], "id":38`

Описание: Отображает данные о пользователях указанных в запросе. Можно запрашивать сразу по нескольким пользователям разделив их запятыми.

***lookup\_accounts***

Параметры:`"method":"lookup_accounts", "params":["username","limit"], "id":39`

Описание: Действует как функция поиска для отображения имен пользователей, содержащих буквы, заданные в первом параметре. Второй параметр задает количество выдаваемых записей.

***get\_account\_count***

Параметры:`"method":"get_account_count", "params":[], "id":40`

Описание: Показывает количество пользователей зарегистрированных в сети GOLOS.

***get\_conversion\_requests***

Параметры:`"method":"get_conversion_requests", "params":["username"], "id":41`

Описание: Отображает текущие запросы на конвертацию указанным пользователем.

***get\_account\_history***

Параметры:`"method":"get_account_history", "params":["username","from","limit"], "id":42`

Описание: История всех действий пользователя в сети GOLOS в виде транзакций.

***get\_owner\_history***

Параметры:`"method":"get_owner_history", "params":["username"], "id":43}`

Описание: Отображает имя пользователя если он изменил право собственности на блокчейн.

***get\_recovery\_request***

Параметры:`"method":"get_recovery_request", "params":["username"], "id":44`

Описание: Если статус пользователя в настоящее время отмечен для восстановления, вернет true, в противном случае возвращается «null».

***get\_escrow***

Параметры:`"method":"get_escrow", "params":["from","escrow_id"], "id":45`

Описание: Данная команда должна отображать операции реализованные с помощью операций посредничества. К сожалению проверить эту команду нету возможности(у меня).

***get\_withdraw\_routes***

Параметры:`"method":"get_withdraw_routes", "params":["username","withdraw_route_type"], "id":46`

Описание: Команда по идее должна выдавать все переводы(или только активные) на счету пользователя в зависимости от типа(второй параметр). Который задается строкой вида **incoming**, **outgoing** или **all**. Но к сожалению никаких данных я в ответ не получал, так что сказать что и как выдается в ответ возможности нет.

***get\_account\_bandwidth***

Параметры:`"method":"get_account_bandwidth", "params":["username","bandwidth_type"], "id":47`

Описание: Отображает пропускную способность(пока не понял что это) пользователя в зависимости от типа.

Тип задается числом:

0- post

1- forum

2- market

3- old\_forum

4- old\_market

***get\_savings\_withdraw\_from***

Параметры:`"method":"get_savings_withdraw_from", "params":["username"], "id":48`

Описание: Команды "get\_savings\_withdraw\_from" и "get\_savings\_withdraw\_to" обе отображают данные о выводах из "СЕЙФА" для данного пользователя. Хотя как я понимаю одна из них должна отображать данные о переводе на счет "СЕЙФА" для данного пользователя.

***get\_savings\_withdraw\_to***

Параметры:`"method":"get_savings_withdraw_to", "params":["username"], "id":49`

Описание: Команды "get\_savings\_withdraw\_from" и "get\_savings\_withdraw\_to" обе отображают данные о выводах из "СЕЙФА" для данного пользователя. Хотя как я понимаю одна из них должна отображать данные о переводе на счет "СЕЙФА" для данного пользователя.

***get\_order\_book***

Параметры:`"method":"get_order_book", "params":["limit"], "id":50`

Описание: Отображает список заявок на внутренней бирже на покупку и продажу в сети GOLOS.

***get\_open\_orders***

Параметры:`"method":"get_open_orders", "params":["username"], "id":51`

Описание: Отображает список заявок на внутренней бирже на покупку и продажу в сети GOLOS для указанного пользователя.

***get\_liquidity\_queue***

Параметры:`"method":"get_liquidity_queue", "params":["startusername","limit"], "id":52`

Описание: Что именно делает данная команда мне пока непонятно.

***get\_transaction\_hex***

Параметры:`"method":"get_transaction_hex", "params":["trx"], "id":53`

Описание: Что именно делает данная команда мне пока непонятно. Так как не понятно что за параметр передается в запрос.

***get\_transaction***

Параметры:`"method":"get_transaction", "params":["txid"], "id":54`

Описание: Отображает детали транзакции по заданному ID транзакции.

***get\_required\_signatures***

Параметры:`"method":"get_required_signatures", "params":["trx", "availablekeys"], "id":55`

Описание: Что именно делает данная команда мне пока непонятно. Так как не понятно что за параметры передаются в запрос.

***get\_potential\_signatures***

Параметры:`"method":"get_potential_signatures", "params":["trx"], "id":56`

Описание: Что именно делает данная команда мне пока непонятно. Так как не понятно что за параметр передается в запрос.

***verify\_authority***

Параметры:`"method":"verify_authority", "params":["trx"], "id":57`

Описание: Что именно делает данная команда мне пока непонятно. Так как не понятно что за параметр передается в запрос.

***verify\_account\_authority***

Параметры:`"method":"verify_account_authority", "params":["userid/username","signer"], "id":58`

Описание: Что именно делает данная команда мне пока непонятно. Так как не понятно что за параметр передается в запрос.

***get\_active\_votes***

Параметры:`"method":"get_active_votes", "params":["username","permalink"], "id":59`

Описание: Отображает список пользователей проголосовавших за указанную запись.

***get\_account\_votes***

Параметры:`"method":"get_account_votes", "params":["username"], "id":60`

Описание: Отображает все голоса которые выставлены указанным пользователем.

***get\_content***

Параметры:`"method":"get_content", "params":["username","permalink"], "id":61`

Описание: Получает информацию о публикации, за исключением комментариев.

***get\_content\_replies***

Параметры:`"method":"get_content_replies", "params":["username","permalink"], "id":62`

Описание: Отображает список всех комментариев для выбранной публикации.

***get\_discussions\_by\_author\_before\_date***

Параметры:`"method":"get_discussions_by_author_before_date", "params":["username","start_permalink","before_date","limit"], "id":63`

Описание: Отображает ограниченное количество публикации (четвертый параметр) пользователя. Второй параметр задает линк стартовой публикации, если пусто то с самого начала. Третий параметр задает дату до какого момента показывать. Третий параметр является строкой, формат ввода (YYYY-MM-DDTHH:MM:SS

***get\_replies\_by\_last\_update***

Параметры:`"method":"get_replies_by_last_update", "params":["username","start_permalink","limit"], "id":64`

Описание: Странное поведение команды.\
При указание первого и третьего параметра(обязателен) отображает ограниченное количество комментариев во всех публикациях заданного пользователя по времени поступления считая от последнего.\
При указании второго параметра отображает непосредственно публикацию и еще ограниченное количество публикаций сторонних авторов.

***get\_witnesses***

Параметры:`"method":"get_witnesses", "params":[["witnessid"]], "id":65`

Описание: Отображает данные о делегатах в соответствии с заданными ID. Можно запрашивать данные сразу по нескольким делегатам разделив их ID запятыми.

***get\_witness\_by\_account***

Параметры:`"method":"get_witness_by_account", "params":["username"], "id":66`

Описание: Отображает данные о делегате (если он им является) в соответствии с данными из запроса.

***get\_witnesses\_by\_vote***

Параметры:`"method":"get_witnesses_by_vote", "params":["username/blank", "limit"], "id":67 <br>`\
Описание: Отображает ограниченный список делегатов одобряющих голосование. Если первый параметр пуст то отображаются ведущие делегаты, если первый параметр указан то список начинается с указанного делегата.

***lookup\_witness\_accounts***

Параметры:`"method":"lookup_witness_accounts", "params":["search_username", "limit"], "id":68`

Описание: Отображает ограниченный список пользователей, которые объявили о своем намерении работать в качестве делегата.

***get\_witness\_count***

Параметры:`"method":"get_witness_count", "params":[], "id":69`

Описание: Отображает количество делегатов.

***get\_active\_witnesses***

Параметры:`"method":"get_active_witnesses", "params":[], "id":70`

Описание: Отображает список всех активных делегатов.

***get\_miner\_queue***

Параметры:`"method":"get_miner_queue", "params":[], "id":71`

Описание: Создает список майнеров, ожидающих попасть в DPOW цепочку, чтобы создать блок.

## Использование`curl`

Простой способ использовать команду - с помощью`curl`, используя следующий формат:

`curl --data '{"jsonrpc": "2.0", <Параметры>}' https://golos.lexai.host`

Историческая справка

* [Статья № 1](https://golos.id/ru--otkrytyij-kod/@asuleymanov/opisanie-api-golos-chast-1)
  * Начало разбора команд из раздела Database\_Api
* [Статья № 2](https://golos.id/ru--otkrytyij-kod/@asuleymanov/opisani-golosapi-chast-2)
  * Окончание разбора команд из раздела Database\_Api
* [Статья № 3](https://golos.id/ru--otkrytyij-kod/@asuleymanov/opisanie-golosapi-chast-3)
  * Разбор команд из разделов Market\_History\_API и Follow\_API
* [Статья №4](https://golos.id/ru--otkrytyij-kod/@asuleymanov/opisani-golosapi-chast-4)
  * Команды из раздела Network\_Brodcast\_API и Login\_API


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.golos.id/developers/api/api-golos-ch1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
