Terracoin budget information network (TBIN)
The cryptocurrency Terracoin introduced a budget system, that allows owners of full Terracoin nodes (masternodes) to vote on budget proposals. If a proposal got enough votes, it will be funded directly by the Terracoin blockchain. Proposals can be submitted by everybody and aim to improve the technical side, law and public awareness of Terracoin. Terracoin Services allows proposal owners present and describe their proposals. Masternode owners can comment and discuss on a proposal, to form a common opinion. Multiple proposal descriptions and discussion on different websites leads to loss of information and should be avoided.To counter this problem, we are offering an API allowing everybody to conveniently pull the proposal data, description as well as the comments, to enhance the own website with a vivid Terracoin budget information section.
Benefits:
- Terracoin proposal information and discussion is interesting an newsworthy content increasing retention of users on your website
- Users can follow the budget proposals as well as the discussion directly on your website
- Data is provided free of charge
- Please link the "comment amount" and (if user comments have been integrated) a "comment reply link" to the respective Terracoin Services comment section, to allow users to post comments
How does it work?
- Call the "budget" API to get the list currently active proposals and store this information locally (e.g. mysql, redis, memcached)
- Display the list of proposals on your website
- The "budget" API also provides you with the proposal hash. Use the proposal hash to call the "proposal" API, giving your detailed proposal information including the description and comments
- Store the proposal information in a local database. Link the single entries of your proposal list with a separate page displaying detailed proposal information (description and comments)
- Check out the Terracoin Services budget page, to get an impression of how things could look like!
Overview
- Budget API: list of all active proposals
- Proposal API: detailed proposal information including description and comments
- Partner: become a partner of the Terracoin budget information network (TBIN)
Budget API
List of currently active budget proposals.
https://services.terracoin.io/api/v1/budget
Group | Values |
---|---|
budget |
|
proposals [array] |
|
status | API status [ok, warning, error] |
error_type | API error type [empty, evaluation_mode, invalid_partner] |
Proposal API
This API provides you with detailed proposal information incudling proposal description and comments
https://services.terracoin.io/api/v1/proposal?hash=<proposal_hash>
Group | Values |
---|---|
proposal [array] |
|
comments [array] |
|
status | API status [ok, warning, error] |
error_type | API error type [empty, evaluation_mode, invalid_partner, proposal_not_existing] |
Register as a TBIN partner
You are free to develop your app with the APIs provided above.Before putting your app live, we highly recommend to request your personal partner key, which will be appended to the API (e.g. https://services.terracoin.io/api/v1/budget?partner=XXX).
Simply send a short email to partner at terracoin.io providing us with the name and the URL of your project. It's free of charge and we are happy to welcome and list you as a TBIN partner.