iGolder API Reference: <SubAccountGetBalance>

The web service <SubAccountGetBalance> is our simplest API.  Fetching your account balance may be useful if you are an exchanger wishing to display to your customers how much available gold you have in your inventory.

Fetching my account balance

A simple HTTP POST request to the following URL https://www.iGolder.com/api.ashx is sufficient to fetch your account balance:

 

<SubAccountGetBalance> <SubAccountId>16523c7d4fc44925a6a844fb919ea8b9</SubAccountId> <SecurityTokenId>0498d220267241f2a8106b416df1ed33</SecurityTokenId> </SubAccountGetBalance>

 

The SubAccountId is the identifier of the sub-account you wish to fetch your balance, and the SecurityTokenId is your security identifier acting as your automation password.  Each sub-account provides a secret security token for you to use when calling our web services.  In the example above, you replace the value 16523c7d4fc44925a6a844fb919ea8b9 with your sub-account identifier, and 0498d220267241f2a8106b416df1ed33 with security token identifier.  For extra security and convenience, we designed our automation interface to not use your login email and password.  Without a security token identifier, the automation module would require your email and password to be hardcoded, thus exposing your iGolder password in case the code gets stolen.  With iGolder, someone knowing your secret security identifier is still unable to access your account without your permission.  You, the account owner must manually grant access to the IP address of the computers you authorize to access your account via automation.  To manually approve the IP addresses, you must login using your email and password.  Using a security token identifier is also convenient, as you may change your email and/or password without affecting your automated payments.

 

After invoking the web service by calling the URL https://www.iGolder.com/api.ashx, the server iGolder.com will return you a response of the following format:

<SubAccountBalance> <AvailableGold>666.550</AvailableGold> <FrozenGold>47.880</FrozenGold> <TotalGold>714.430</TotalGold> <TotalUSD>23157.82</TotalUSD> <TotalEUR>15814.94</TotalEUR> <TotalGBP>14380.53</TotalGBP> <Date>2009-09-30 09:51:38</Date> <Name>Bob</Name> </SubAccountBalance>

 

Returned Value Description
AvailableGold Amount of gold available for spending.  This value represents the amount of gold which had cleared from Safetransit and can be transferred (spent) to another account.  Any gold in Safetransit is considered unavailable, and therefore excluded from this value.
FrozenGold Quantity of gold frozen in Safetransit.  The frozen gold will become available for spending when the payment clears at the Safetransit closing date.
TotalGold Account balance in grams of gold.  This value is the total account balance, including any gold in Safetransit™.
TotalUSD
TotalEUR
TotalGBP
...more...
Current market exchange rate of the total account balance in a fiat currency, such as United States Dollars (USD) or Euros (EUR), Great Britain Pound (GBP).  You may add or remove fiat currencies by clicking on the link iGolder Settings at the top right of the page.  If you wish to know the value of your available or frozen gold, simply do the cross-multiplication.  The value in fiat currency is purely for convenience, and because of the currency market fluctuation, this value changes constantly.
Date Date and time at the moment the account balance was fetched.  Since the account balance may change anytime, it may be useful to know the exact time that the balance was reported.
The time is displayed in your local time, and if incorrect, you have to configure your timezone in your account settings.
Name Public name of the sub-account.  This value is returned for convenience, in case you wish to debug or troubleshoot your integration.  You may change the sub-account name anytime in the account details.

 

iGolder Automation Tool

If you wish to automate iGolder operations, we recommend you to enable automation and download our test tool iGolderAutomationTool.exe.  Within minutes, you will be able to fetch your account balance, download your transaction history and automate sending a gold payment.  Within one hour of work, you may add iGolder payments to your website via our Shopping Cart Interface.

 

iGolder Automation Test Tool fetching Bob's account balance

 

 

Since August 1st, 2013 iGolder is no longer accepting new accounts and balances can only be redeemed. During the past years, we have been recommending Bitcoin more than our own payment system. We believe in physical gold ownership, and developed iGolder as a mechanism for people to acquire physical gold by trading with one another.

Since iGolder has a central point of failure (our server may be raided by thugs wearing some kind of uniform), we feet it is safer for us to cease operations. The iGolder experiment has been personally rewarding as we met many gold enthusiasts and also learned about Bitcoin in the process. For those who have no idea what Bitcoin is, we recommend doing your own research. Bitcoin is far superior to iGolder in every way, both in privacy and security as our server is always vulnerable to confiscation. Bitcoin is a communication protocol with a built-in "escrow service" capable of protecting both the buyer and the seller, rendering our Safetransit completely redundant. To learn more about the Bitcoin protocol and its feature, please watch "http://www.youtube.com/watch?v=mD4L7xDNCmA (Bitcoin 2012 London: Mike Hearn).

For those having gold in their iGolder account, we will ship the physical metal to anyone having more than 1 ounce of gold, assuming the owner is willing to assume the shipping costs. For smaller quantities, we offer to settle in Bitcoin, however we will also settle with any other reasonable payment system. We will give everyone at least two full years (until 2016) to contact us to claim their gold. After that period, any unclaimed gold will go to fund an economic development project in Honduras helping local people to become entrepreneurs.

We sincerely wish you the best in life and hope to keep in contact with you.

Yours in liberty,
The iGolder Team.


Update 2014: Since we announced we no longer accept gold transfers, we have received countless emails asking to keep the free gold charts and the PGP encryption tools. We plan to keep running the domain iGolder.com for both the gold charts and the encryption tools. Better, we are developing state of the art open-source software for a secure decentralized social network with a built-in wallet. We will announce when we have a product ready for use. Stay tuned!