API
Instawallet provides an API, making it easy to interface with the service. API calls return JSON-encoded data.
HTTP POST
https://www.instawallet.org/api/v1/new_walletCreates a new Instawallet.
Example response: {"successful": true, "wallet_id": "1CKAK7zU5NGUlY1n3PK0aw"}
HTTP GET
https://www.instawallet.org/api/v1/w/<wallet_id>/address
Returns the Bitcoin address associated with this Instawallet.
Example response: {"successful": true, "address": "1PmggT9YKj4HL2iaUs8ukUSvvk3Q1xMv5G"}
HTTP GET
https://www.instawallet.org/api/v1/w/<wallet_id>/balance
Returns the current balance of this Instawallet in Bitcoin base units (Satoshis). This means 0.01 BTC will be returned as 1000000.
Example response: {"successful": true, "balance": 1000000}
HTTP POST
https://www.instawallet.org/api/v1/w/<wallet_id>/payment
Initiates a payment. Your request needs to include the parameters "address" and "amount". Amount should be in Bitcoin base units (Satoshis). The optional parameter "use_green_address" can be passed with a value of "true" to use the green address feature.
Example response: {"successful": true, "message": "Sent 0.01 BTC to 14Z1mazY4HfysZyMaKudFr63EwHqQT2njz", "message_code": 0}
If an error occurred or the API is not available for some reason, the parameter "succesful" will be false and a "message" as well as a "message_code" will be returned alongside. See the following table for possible codes and messages:
1 The API is currently unavailable.
2 Please provide a Bitcoin address.
3 Please specify the amount you would like to send.
4 Sorry, this does not look like a valid Bitcoin address.
5 Sorry, I was not able to parse the amount field.
6 Sorry, currently only amounts of 0.01 BTC and more are supported.
7 Use of green address failed - please contact support.
8 Sorry, I was unable to validate the Bitcoin address.
-4 Sorry, this does not seem to be a valid Bitcoin address.
-6 Account has insufficient funds (or not enough confirmations) to complete this action.
0 Sent <amount> BTC to <address>.
