REST API
This Application Programming Interface can be used to retrieve information from hybrixd. The requests are formatted as forward-slash ('/') separated commands (similar to a website url or file path.)
Examples
/asset
returns the assets supported by the hybrixd node.
/asset/btc/balance/32FCGFdRGeho2HBeWQPaAYawJfPqHHvsCJ
returns the balance of the Bitcoin address 32FCGFdRGeho2HBeWQPaAYawJfPqHHvsCJ.
/command/reload
reload hybrixd and reinitialize modules and recipes.
/proc
returns the list of processes running on the hybrixd node.
/proc/1543921378626236
returns the progress and result of process 1543921378626236.
The response will be in JSON format. For the balance request /asset/btc/balance/32FCGFdRGeho2HBeWQPaAYawJfPqHHvsCJ
this will be of the form:
{"error":0,"info":"Process data.","id":"1543921378626236","progress":1,"started":1543923093402,"stopped":1543923093695,"data":"0.00000000","request":"/asset/btc/balance/32FCGFdRGeho2HBeWQPaAYawJfPqHHvsCJ"}
From which we see that the balance on this address is 0.00000000.
Two-Stage Requests
For some requests, the response will consist of a process reference. This means that the response to your request is not yet finished, but you can follow up on it using the given process id.
/asset/btc/balance/32FCGFdRGeho2HBeWQPaAYawJfPqHHvsCJ
Result
{"error":0,"info":"Command process ID.","id":"id","request":"/asset/btc/balance/32FCGFdRGeho2HBeWQPaAYawJfPqHHvsCJ","data":"1543921378626236"}
The same is true for the following request.
/proc/1543921378626236
Result
{"error":0,"info":"Process data.","id":"1543921378626236","progress":1,"started":1543923093402,"stopped":1543923093695,"data":"0.00000000","request":"/asset/btc/balance/32FCGFdRGeho2HBeWQPaAYawJfPqHHvsCJ"}
hybrix JS library
To facilitate integration of the API into you Javascript projects we have created a library. This library will handle two stage request and all client side steps for the encyrption and signing of transactions.
Read more about the hybrix JS library »
Reference
Alias: /a
/asset
/asset//balance/
/asset//fee-balance/
/asset//subbalances/
/asset//transaction-details/
/asset//transaction-details//
/asset//transaction-details///
/asset//transaction-details////
/asset//transaction-details/////
/asset//block
/asset//block/
/asset//confirm/
/asset//confirmed
/asset//confirmed/
/asset//contract
/asset//details
/asset//factor
/asset//features
/asset//features/
/asset//fee
/asset//fee/
/asset//fee-factor
/asset//fee-symbol
/asset//keygen-base
/asset//mode
/asset//height
/asset//history/
/asset//history//
/asset//history///
Root only.
/asset//history////
/asset//info
/asset//icon
/asset//notes
/asset//sample
/asset//report
/asset//test
Root only.
/asset//test-hosts
Root only.
/asset//test-cli
/asset//transaction/
/asset//transaction//
/asset//description/
/asset//message/
/asset//status/
/asset//push/
/asset//unified-symbols
/asset//unspent/
/asset//unspent//
/asset//unspent///
/asset//unspent////
/asset//unspent/////
/asset//validate/
Alias: /c
Root only.
Execute a direct command to hybrixd.
/command/events
/command/apiqueue/pause
/command/apiqueue/resume
/command/apiqueue/status
/command/apiqueue/test/start
/command/apiqueue/test/force
/command/apiqueue/test/stop
/command/apiqueue/test/status
/command/cache/clear
/command/conf
/command/conf/get/
/command/conf/list
/command/conf/list/
/command/conf/set//
/command/conf/conf.js
/command/exec/
/command/update
/command/update/check
/command/reload
/command/reload/conf
/command/reload/modules
/command/reload/recipes
/command/scheduler/pause
/command/scheduler/resume
/command/scheduler/status
/command/endpoint
/command/endpoint///close
/command/endpoint///open
/command/endpoint///status
/command/start
/command/restart
/command/stop
/command/stop/debug
Alias: /e
/engine
/engine/allocation/pair/list
/engine/allocation/pair/find//
/engine/allocation/pair/rebalance//
/engine/allocation/pair/rebalance///
/engine/allocation/pair/rebalance////
/engine/allocation/pair/select//
/engine/allocation/pair/select///
/engine/allocation/pair/stats
/engine/allocation/pair/stats/
/engine/allocation/pair/stats//
/engine/allocation/pair/history
/engine/allocation/pair/history/
/engine/allocation/pair/history//
/engine/allocation/pair/get///
/engine/allocation/pair/get////
/engine/allocation/pair/set////
/engine/allocation/pair/set/////
/engine/allocation/pair/set//////
/engine/allocation/pair/set///////
/engine/allocation/pair/delete///
/engine/allocation/pair/delete////
/engine/allocation/account/list
/engine/allocation/account/init//
/engine/allocation/account/exists/
/engine/allocation/account/details/
/engine/allocation/account/details//
/engine/allocation/account/contact/
/engine/allocation/account/contact//
/engine/allocation/account/setContact//
/engine/allocation/account/setContact///
/engine/allocation/account/address//
/engine/allocation/account/address///
/engine/allocation/account/setAddress///
/engine/allocation/account/setAddress////
/engine/allocation/account/balance//
/engine/allocation/account/balance///
/engine/allocation/account/mint///
/engine/allocation/account/mint////
/engine/allocation/account/burn//
/engine/allocation/account/burn///
/engine/allocation/account/burn////
/engine/allocation/account/securityReserve//
/engine/allocation/account/securityReserve///
/engine/allocation/account/securityReserve////
/engine/allocation/security-symbol
/engine/allocation/valuations/rates
/engine/asset
/engine/asset//balance/
/engine/asset//fee-balance/
/engine/asset//subbalances/
/engine/asset//transaction-details/
/engine/asset//transaction-details//
/engine/asset//transaction-details///
/engine/asset//transaction-details////
/engine/asset//transaction-details/////
/engine/asset//block
/engine/asset//block/
/engine/asset//confirm/
/engine/asset//confirmed
/engine/asset//confirmed/
/engine/asset//contract
/engine/asset//details
/engine/asset//factor
/engine/asset//features
/engine/asset//features/
/engine/asset//fee
/engine/asset//fee/
/engine/asset//fee-factor
/engine/asset//fee-symbol
/engine/asset//keygen-base
/engine/asset//mode
/engine/asset//height
/engine/asset//history/
/engine/asset//history//
/engine/asset//history///
Root only.
/engine/asset//history////
/engine/asset//info
/engine/asset//icon
/engine/asset//notes
/engine/asset//sample
/engine/asset//report
/engine/asset//test
Root only.
/engine/asset//test-hosts
Root only.
/engine/asset//test-cli
/engine/asset//transaction/
/engine/asset//transaction//
/engine/asset//description/
/engine/asset//message/
/engine/asset//status/
/engine/asset//push/
/engine/asset//unified-symbols
/engine/asset//unspent/
/engine/asset//unspent//
/engine/asset//unspent///
/engine/asset//unspent////
/engine/asset//unspent/////
/engine/asset//validate/
/engine/banking/methods
/engine/banking/deposit////
/engine/banking/withdraw////
/engine/banking/transfer////
Root only.
/engine/deal/swap
/engine/deal/pairs
/engine/deal/estimate//
/engine/deal/estimate///
/engine/deal/proposal////
/engine/deal/remit//
Root only.
Claim payment proof for proposal ID. Necessary for a swap to complete, and adds security to the swap.
/engine/deal/claim//
/engine/deal/status/
Root only.
Find deals containing string.
/engine/deal/find/
/engine/deal/list///
/engine/deal/dispute/
Root only.
Force settle a deal.
/engine/deal/settle/
/engine/deal/test
/engine/deal/ledgers
/engine/deal/banking
/engine/evm-interpreter/get/opcodes/
/engine/evm-interpreter/get/functions/
/engine/evm-interpreter/get/events/
/engine/evm-interpreter/get/destinations/
/engine/evm-interpreter/get/swarmhash/
/engine/evm-interpreter/get/gas/
/engine/evm-interpreter/get/gastable
/engine/evm-interpreter/parse/
/engine/evm-interpreter/decompile/
/engine/evm-interpreter/decode/
/engine/portfolio/balances/
/engine/portfolio/balancesLive/
/engine/portfolio/details/
/engine/portfolio/valuations//
/engine/redirect/http//
/engine/storage/seek/
/engine/storage/load/
/engine/storage/save/
Root only.
Delete data from storage.
/engine/storage/burn/
/engine/storage/meta/
/engine/storage/list/
/engine/synchronize/queue/
/engine/synchronize/pull
/engine/synchronize/peers
Root only.
Return a list of unsynchronized items from remote peer host.
/engine/synchronize/list/
Root only.
/engine/synchronize/select
Root only.
/engine/synchronize/autosync
Root only.
Synchronize with a specific peer host.
/engine/synchronize/sync/
/engine/synchronize/test
/engine/unified-asset/compress//
/engine/unified-asset/decompress//
Root only.
/engine/update/check
/engine/update/get-latest-version
/engine/update/get-latest-version/hybrixd
/engine/update/get-latest-version/cli-wallet
/engine/update/get-latest-version/tui-wallet
/engine/update/get-latest-version/hybrix-jslib
Alias: /h
/help
Alias: /l
/list/asset/icons
/list/asset/names
/list/asset/modes
/list/asset/details
Alias: /m
/meta
Alias: /p
/proc
/proc/
Root only.
Kill a process and all child processes.
/proc/kill/
Root only.
/proc/debug
/proc/debug/
/proc/debug/debug.js
Root only.
/proc/code
/proc/code/
/proc/code//
/proc/code///
/proc/code/code.js
Root only.
/proc/exec
/proc/pause
Root only.
/proc/pause/
Root only.
/proc/resume/
Root only.
Display the internal data of a process.
/proc/peek/
Root only.
/proc/queue
/proc/queue/
Root only.
/proc/busy
Root only.
/proc/finished
Alias: /r
/report
Root only.
/report/cron
/report/report.js
/report/report.css
/report/assets
Root only.
/report/assets/cron
Root only.
/report/assets/test
Root only.
/report/assets/cli
/report/assets/html
/report/assets/xml
/report/assets/json
/report/asset/
/report/asset//json
Root only.
/report/asset//cli
Root only.
/report/log
/report/log/
/report/log//
/report/log///
/report/log////
/report/sessions
Root only.
/report/sessions/
/report/sessions//
/report/sessions/json
/report/api
Root only.
/report/api/
/report/api//
/report/api///
/report/api/assets
Root only.
/report/api/assets/
/report/api/assets//
/report/api/assets///
/report/api/assets/json
/report/api/json
Alias: /s
/source
/source/deterministic/assets
/source/deterministic/code/
$MODE
.
/source/deterministic/hash/
$MODE
.Root only.
/source/deterministic/reload
/source/deterministic/reload/
$MODE
.
/source/deterministic/hashes
/source/deterministic/modes
/source/recipe-editor
/source/recipe-editor/submit
/source/resources/powered-by-hybrix.svg
/source/resources/hybrix-lib.web.js
/source/resources/hybrix-lib.node.js
/source/ui
/source/valuations/cron
/source/valuations/list
/source/valuations/rate//
/source/valuations/rate///
/source/valuations/rate////min
/source/valuations/rate////max
/source/valuations/rate////median
/source/valuations/rate////average
/source/valuations/rate////optimized
/source/valuations/rate////range
/source/valuations/rate////meta
/source/web-blockexplorer
/source/web-wallet
/source/web-wallet/version
Alias: /v
/version
/version/details
Alias: /x
/xauth//0
$NONCE1
. Note that resending the request will erase the session.$NONCE1
, if this is verified the session public key is given.
/xauth//1/
Alias: /y
/ychan//
$SESSION_PUBLIC_KEY
is executed as an API command and the result is encrypted and returned.
/ychan///
$ENCRYPTED_PATH
, for example: /asset/btc/details
encrypted using the $SESSION_PUBLIC_KEY
is executed as an API command and the result is encrypted and returned.Alias: /z
/zchan//
$SESSION_PUBLIC_KEY
is executed as an API command and the result is encrypted and compressed using lmza and returned.
/zchan///
$ENCRYPTED_PATH
, for example: /asset/btc/details
encrypted using the $SESSION_PUBLIC_KEY
is executed as an API command and the result is encrypted and compressed using lmza and returned.