1.1 Crypto
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id.
1.2 Stocks
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
2.1 Goldbell Wallet
GoldBell Wallet holds all your assets. On the account page, you can see an overview of the contents.
2.2 Wallet Number
Every user has a wallet number. This is used to represent and identify your account in transactions.
2.3 Goldbell Card
Every user has their own Goldbell Card. This is used to visually represent your account while making purchases with Goldbell Pay.
The yellow card consists of the text 'Goldbell', the Goldbell logo, your wallet number, your username and a decorative expiry date.
If you are logged in, you can view your card on the Wallet page, at https://goldbell.kiyan.site/wallet/card/ and while making purchases on Goldbell Pay.
3.1 Goldbell Pay
GoldBell Wallet holds all your assets. On the account page, you can see an overview of the contents.
3.2 Page
The URL for Goldbell Pay is https://goldbell.kiyan.site/pay/
Below is an example of the page:
https://goldbell.kiyan.site/pay/?id=60908834
3.3 Process
Goldbell Pay makes it easy for users and businesses to send and receive payment. See explanation below:
- RECIPIENT (site): If the product/service has a fixed price OR if the user can control the price, for example when depositing or withdrawing funds onto your site, send request(s) to the startpayment API endpoint when the user presses the submit button.
- RECIPIENT (site): Write code to add the newly generated transaction ID from the startpayment endpoint after 'https://goldbell.kiyan.site/pay/?id='. After that, you can add '&destination=[the page you would like the user to be redirected back to]'. This way, after the user completes the payment, they will be redirect back to your desired page. The destination parameter is optional. If it is not specified, the user will see 'You can close this tab now.'
- RECIPIENT (site): Then, redirect the user to that URL.
- RECIPIENT (site): Write code to continuously request the checkpayment API endpoint until it's success response returns true. This way, you can monitor whether the user has completed the transaction. If successful, process the payment on your end (i.e: add funds, add order, withdraw funds).
- USER: When you are redirected to Goldbell Pay, make sure you are logged in. When you press Pay, you will be redirected back to the site.
4.1 API Overview
API URL: https://goldbell.kiyan.site/api/
| Endpoint |
Description |
Method |
Data |
Data Method |
Authorization |
| buy |
Endpoint for purchasing assets |
GET |
asset (string), amount (number), price (number), type (string) |
URL Parameters |
Needs to be logged in on current session |
| details |
Endpoint to fetch asset details |
GET |
asset (string) |
URL Parameters |
None |
| price |
Endpoint to fetch current asset price |
GET |
asset (string) |
URL Parameters |
None |
| boosters |
Endpoint to fetch current asset boosters |
GET |
asset (string) |
URL Parameters |
None |
| pricelist |
Endpoint to fetch prices for all assets |
GET |
None |
- |
None |
| startpayment |
Endpoint to start a payment. Returns the created transaction ID |
POST |
recipient (string), info (string), amount (number), type (string: 'pay' OR 'deposit') |
Request Body |
None |
| completepayment |
Endpoint to complete a payment |
POST |
id (string) |
Request Body |
Needs to be logged in on current session |
| checkpayment |
Endpoint to check payment status |
GET |
id (string) |
URL Parameters |
None |
| mine |
Endpoint to add new asset value |
POST |
asset (string), value (number), token (string) |
Request Body |
Secret token |
| activity |
Endpoint for buying activity simulation |
POST |
asset (string), amount (number), price (number), type (string) |
Request Body |
Secret token |
| fetchbalance |
Endpoint for fetching current user balance |
GET |
None |
- |
Needs to be logged in on current session |
| generatePDF |
Endpoint to generate a PDF |
GET |
type |
URL Parameters |
Needs to be logged in on current session |
| clearpayments |
Endpoint to remove active payments older than 10 minutes |
POST |
token (string) |
Request Body |
Secret token |
4.2 API Examples
buy Endpoint
Example URL: https://goldbell.kiyan.site/api/buy?asset=LEAP&amount=12&price=0.0381&type=crypto
Example Output: {"success":true,"newBalance":281.36532681229835}
details Endpoint
Example URL: https://goldbell.kiyan.site/api/details/?asset=ASTR
Example Output: {"name":"Astral Coin","abbreviation":"ASTR","supplyMax":1000000,"supplyCurrent":2745.9420859294337,"changeMin":-2,"changeMax":2,"type":"crypto","specificType":"Crypto\/Coin","launchDate":"28 September 2023","launchTime":"16:00:00","launchQ":"Q3 2023"}
price Endpoint
Example URL: https://goldbell.kiyan.site/api/price/?asset=ASTR
Example Output: {"value":"4.6358329219817"}
boosters Endpoint
Example URL: https://goldbell.kiyan.site/api/boosters/?asset=ASTR
Example Output: {"boosters":[{"asset":"ASTR","name":"ASTR Booster","percentage":"Positive","amount":"3"}]}
pricelist Endpoint
Example URL: https://goldbell.kiyan.site/api/pricelist/
Example Output: [{"ASTR":"4.6358329219817"},{"ZTRA":"4.7727726606434"},{"LEAP":"0.038102"}]
startpayment Endpoint
Example URL: https://goldbell.kiyan.site/api/startpayment/
Example Post Body: FORM URL Encoded (application/x-www-form-urlencoded)recipient=Goldbell
info=Goldbell Payment $20
amount=20
type=pay
Example Output: {"transactionId":67586430}
completepayment Endpoint
Example URL: https://goldbell.kiyan.site/api/completepayment/
Example Post Body: FORM URL Encoded (application/x-www-form-urlencoded)id=67586430
Example Output: {"success":true}
checkpayment Endpoint
Example URL: https://goldbell.kiyan.site/api/checkpayment/?id=29545264
Example Output: {"success":true}
mine Endpoint
Example URL: https://goldbell.kiyan.site/api/mine/
Example Output: ...
activity Endpoint
Example URL: https://goldbell.kiyan.site/api/activity/
Example Post Body: JSON (application/json){"token":"SECRET TOKEN"}
Example Output: Transaction simulated successfully. Asset: ASTR, Amount: 23, Price: 4.6013913340365.
fetchbalance Endpoint
Example URL: https://goldbell.kiyan.site/api/fetchbalance/
Example Output: 104.46
generatePDF Endpoint
Example URL: https://goldbell.kiyan.site/api/generatePDF/?type=transactions
Example Output: ... (downloads pdf)
clearpayments Endpoint
Example URL: https://goldbell.kiyan.site/api/clearpayments/
Example Post Body: FORM URL Encoded (application/x-www-form-urlencoded)token=SECRET TOKEN
Example Output: {"message":"Old payments cleared successfully."}
6.1 Storage Structure
Storage URL: https://goldbell.kiyan.site/storage/
/storage/crypto/
The crypto folder contains a folder for each asset, named according to their abbreviation.
Within an asset folder, there are three files, one for the current value, one for the value history and one for the asset details.
| ASSET-details.json |
A JSON file storing the details about a specific asset. |
| ASSET-history.txt |
A text file storing the asset value history with UNIX timestamps. |
| ASSET-value.txt |
A text file storing the current value of a specific asset. |
URL Examples:
https://goldbell.kiyan.site/storage/crypto/ZTRA/ZTRA-details.json
https://goldbell.kiyan.site/storage/crypto/ZTRA/ZTRA-history.txt
https://goldbell.kiyan.site/storage/crypto/ZTRA/ZTRA-value.txt
/storage/
The root storage folder contains general files essential for Goldbell.
| accounts.json |
A JSON file storing all user data. (Discontinued and moved for security reasons). |
| transactions.json |
A JSON file storing the transactions made using Goldbell Pay. (Discontinued and moved for security reasons). |
| activepayments.json |
A JSON file storing the active payments from Goldbell Pay. (Discontinued and moved for security reasons). |
| boosters.txt |
A text file storing the current active asset boosters. |
| pastboosters.txt |
A text file storing a historical list of asset boosters.. |
Section Item 6.2
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 6.3
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 7.1
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 7.2
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 7.3
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 8.1
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 8.2
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 8.3
Vivamus efficitur fringilla ullamcorper. Cras condimentum condimentum mauris, vitae facilisis leo. Aliquam sagittis purus nisi, at commodo augue convallis id. Sed interdum turpis quis felis bibendum imperdiet. Mauris pellentesque urna eu leo gravida iaculis. In fringilla odio in felis ultricies porttitor. Donec at purus libero. Vestibulum libero orci, commodo nec arcu sit amet, commodo sollicitudin est. Vestibulum ultricies malesuada tempor.
Section Item 9.1 (FAQ Category One)
What's sit amet quam eget lacinia?
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo. Nullam dictum felis eu pede mollis pretium.
How to ipsum dolor sit amet quam tortor?
Donec sodales sagittis magna. Sed consequat, leo eget bibendum sodales, augue velit cursus nunc, quis gravida magna mi a libero. Fusce vulputate eleifend sapien. Vestibulum purus quam, scelerisque ut, mollis sed, nonummy id, metus. Nullam accumsan lorem in dui.
Can I bibendum sodales?
Fusce vulputate eleifend sapien. Vestibulum purus quam, scelerisque ut, mollis sed, nonummy id, metus. Nullam accumsan lorem in dui.
Where arcu sed urna gravida?
Aenean et sodales nisi, vel efficitur sapien. Quisque molestie diam libero, et elementum diam mollis ac. In dignissim aliquam est eget ullamcorper. Sed id sodales tortor, eu finibus leo. Vivamus dapibus sollicitudin justo vel fermentum. Curabitur nec arcu sed urna gravida lobortis. Donec lectus est, imperdiet eu viverra viverra, ultricies nec urna.
Section Item 9.2 (FAQ Category Two)
What's sit amet quam eget lacinia?
Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Aenean commodo ligula eget dolor. Aenean massa. Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Donec quam felis, ultricies nec, pellentesque eu, pretium quis, sem. Nulla consequat massa quis enim. Donec pede justo, fringilla vel, aliquet nec, vulputate eget, arcu. In enim justo, rhoncus ut, imperdiet a, venenatis vitae, justo. Nullam dictum felis eu pede mollis pretium.
How to ipsum dolor sit amet quam tortor?
Donec sodales sagittis magna. Sed consequat, leo eget bibendum sodales, augue velit cursus nunc, quis gravida magna mi a libero. Fusce vulputate eleifend sapien. Vestibulum purus quam, scelerisque ut, mollis sed, nonummy id, metus. Nullam accumsan lorem in dui.
Can I bibendum sodales?
Fusce vulputate eleifend sapien. Vestibulum purus quam, scelerisque ut, mollis sed, nonummy id, metus. Nullam accumsan lorem in dui.
Where arcu sed urna gravida?
Aenean et sodales nisi, vel efficitur sapien. Quisque molestie diam libero, et elementum diam mollis ac. In dignissim aliquam est eget ullamcorper. Sed id sodales tortor, eu finibus leo. Vivamus dapibus sollicitudin justo vel fermentum. Curabitur nec arcu sed urna gravida lobortis. Donec lectus est, imperdiet eu viverra viverra, ultricies nec urna.
Section Item 9.3 (FAQ Category Three)
How to dapibus sollicitudin justo vel fermentum?
Donec sodales sagittis magna. Sed consequat, leo eget bibendum sodales, augue velit cursus nunc, quis gravida magna mi a libero. Fusce vulputate eleifend sapien. Vestibulum purus quam, scelerisque ut, mollis sed, nonummy id, metus. Nullam accumsan lorem in dui.
How long bibendum sodales?
Fusce vulputate eleifend sapien. Vestibulum purus quam, scelerisque ut, mollis sed, nonummy id, metus. Nullam accumsan lorem in dui.
Where dapibus sollicitudin?
Aenean et sodales nisi, vel efficitur sapien. Quisque molestie diam libero, et elementum diam mollis ac. In dignissim aliquam est eget ullamcorper. Sed id sodales tortor, eu finibus leo. Vivamus dapibus sollicitudin justo vel fermentum. Curabitur nec arcu sed urna gravida lobortis. Donec lectus est, imperdiet eu viverra viverra, ultricies nec urna.