My Wallet users can interact with their wallet using our JSON RPC api. It is intended to be fully compatible with the original Bitcoind RPC protocol however some method calls are not supported.

Original Documentation available at https://en.bitcoin.it/wiki/Original_Bitcoin_client/API_Calls_list

Authentication

-rpcuser Should be set to your wallet identifier. This is a 36 character random string which can be found on your wallet login page.
-rpcpassword Should be set to your main wallet password. If double encryption is enabled your second password will need to be set using walletpassphrase
-rpcport Should be set to 443 for https:// (when the -rpcssl is provided) or 80 for plain text http://
-rpcssl Set to use a secure connection (Recommended)

Security

This api is currently incompatible with two factor authentication and it must therefore be disabled. We HIGHLY recommend you enable double encryption which can be found on the My Wallet account details page.

If you will be accessing this API from a server with a static ip address is recommended you enable the IP Lock found in the Security Section of your My Wallet account.

Unlike when using the javascript wallet transaction signing is conducted server side which means your private keys are shared with the server. However many operations such as fetching a balance and viewing transactions are possible without needing to decrypt the private keys. The is possible through the use of double encryption only when the second password is provided does the server have ability to access the funds in a wallet. For merchants who need to only receive transactions it maybe possible to never provide a second password.

If transactions can be delayed and are able to be manually reviewed we highly recommend you do this. Have your server construct a list of transactions which need to be made and every so often an admin can login and review the list - if the transactions look ok they can manually supply the second password with a short timeout (don't store the second password on your server if possible). When the admin provides a second password you can start a job to call sendmany.

Notes

HTTP callbacks can be enabled in the notifications section of [Account Settings] in the web interface.

Host

The rpc host is rpc.blockchain.info. Plain http and SSL https are supported.

Connecting using Bitcoind

Bitcoind can be used as an RPC client for testing and debugging.

$ ./bitcoind -rpcconnect=rpc.blockchain.info -rpcport=443 -rpcssl -rpcuser=YourWalletIdentifier -rpcpassword=YourPassword getinfo

Wrapper Libraries

Shopping Cart Interfaces

Bitcoind Commands Not Available

Methods

{
    "balance" : 43.50100000,
    "errors" : "",
    "paytxfee" : 0.005,
    "proxy" : "",
    "connected" : 0,
    "testnet" : false,
    "difficulty" : 1733207.51384839,
    "blocks" : 179602
}
0.001
{
    "tx" : [
        "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b"
    ],
    "time" : 1231006505,
    "height" : 0,
    "nonce" : 2083236893,
    "hash" : "000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f",
    "bits" : 486604799,
    "difficulty" : 1,
    "merkleroot" : "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
    "version" : 1,
    "size" : 285
}
179729
000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f
2000
{
    "balance" : 43.29300000,
    "errors" : "",
    "paytxfee" : 0.005,
    "proxy" : "",
    "connected" : 3943,
    "testnet" : false,
    "difficulty" : 1733207.51384839,
    "blocks" : 179729
}
{
    "amount" : 0,
    "fee" : 0,
    "blockindex" : 179123,
    "details" : [
        {
            "fee" : 0,
            "amount" : 0.01000000,
            "blockindex" : 179123,
            "category" : "receive",
            "confirmations" : 0,
            "address" : "1APSgU92VV77GB2YMNNMMYz7Sock5gMgV1",
            "txid" : "5031738bc1f797e5e0f8b782989111d75106496c5dedea50d96e2ed1dc88190d",
            "block" : 1327599863,
            "blockhash" : "000000000000079bae4b877ad3810f03db249a6f239c2b69c18d44c141c470ee"
        },
        {
            "fee" : 0,
            "amount" : 0.00100000,
            "blockindex" : 179123,
            "category" : "receive",
            "confirmations" : 0,
            "address" : "15CDCKBLsvX3nZ3krMYNse6FkRcuMD1rmU",
            "txid" : "5031738bc1f797e5e0f8b782989111d75106496c5dedea50d96e2ed1dc88190d",
            "block" : 1327599863,
            "blockhash" : "000000000000079bae4b877ad3810f03db249a6f239c2b69c18d44c141c470ee"
        }
    ],
    "confirmations" : 15767,
    "txid" : "5031738bc1f797e5e0f8b782989111d75106496c5dedea50d96e2ed1dc88190d",
    "block" : 1327599863,
    "blockhash" : "000000000000079bae4b877ad3810f03db249a6f239c2b69c18d44c141c470ee"
}
{
    "1JArS6jzE3AJ9sZ3aFij1BmTcpFGgN86hA" : 0,
    "1NW6nextdRXhKZWxLB4KaU6e9WjBQ1LVrW" : 0.2
}
[
    {
        "amount" : 2558.40200000,
        "confirmations" : 55,
        "account" : "Savings",
        "label" : "Savings"
    }
]
[
    {
        "amount" : 255840224456,
        "confirmations" : 55,
        "address" : "145YPBBWRj4aquewvx59SAWNrSZFT5rvxr",
        "account" : "Savings"
    }
]
{
    "lastblock" : "00000000000009133d70c6282279bfc5fadfea07e27543445a199fe6ef84b51b",
    "transactions" : [
        {
            "fee" : 0.01000000,
            "amount" : 1,
            "blockindex" : 171984,
            "category" : "receive",
            "confirmations" : 0,
            "address" : "1A8JiWcwvpY7tAopUkSnGuEYHmzGYfZPiq",
            "txid" : "90992bc8ebff9774cfc91738863602010dab9ab2f5b0841cc4922786a2029725",
            "block" : 1323486876,
            "blockhash" : "00000000000003438e8c67500f34dd32bb1bf0d251a5c230c407641961c85b41",
            "account" : "My Wallet"
        }
	]
}
{
    "lastblock" : "00000000000009133d70c6282279bfc5fadfea07e27543445a199fe6ef84b51b",
    "transactions" : [
        {
            "fee" : 0.01000000,
            "amount" : 1,
            "blockindex" : 171984,
            "category" : "receive",
            "confirmations" : 0,
            "address" : "1A8JiWcwvpY7tAopUkSnGuEYHmzGYfZPiq",
            "txid" : "90992bc8ebff9774cfc91738863602010dab9ab2f5b0841cc4922786a2029725",
            "block" : 1323486876,
            "blockhash" : "00000000000003438e8c67500f34dd32bb1bf0d251a5c230c407641961c85b41",
            "account" : "My Wallet"
        }
	]
}
608e3bf3113aa195b21dd52e5389693117e263458ef10b151ab73c91b815470a
608e3bf3113aa195b21dd52e5389693117e263458ef10b151ab73c91b815470a
608e3bf3113aa195b21dd52e5389693117e263458ef10b151ab73c91b815470a
608e3bf3113aa195b21dd52e5389693117e263458ef10b151ab73c91b815470a
{
    "address" : "1BZZnJG6q95aJqPZweSCGnno2rxcXyfaLo",
    "iscompressed" : false,
    "account" : "Test",
    "pubkey" : "04572e60ecaa1dd7cb435dc8e04bb6c1729d69bb3916e3f4849b3ffcb02f01f5d94a03c266507245ff30c04dee99ceb711050003b6282ea72634d8f610878885e6",
    "ismine" : true,
    "isvalid" : true
}
1BZZnJG6q95aJqPZweSCGnno2rxcXyfaLo
GyLL9ps957O7gLGEWH4Q42WVDADXeHWeLhAQQIsI5m0pjGVDuEJLnK5RgI/7TwPU4UCzwo2BDVXyadBAMW0JKgc=
true