Summary API

You can obtain summary information about all our explorers at the following URL :

http://xplor.2Give.info/xplor/api/summary

It returns .

API Calls Root URL for explorers

API shares a normalized root URL which is:

http://xplor.2Give.info/coin/api

So for instance the url root for 2GiveCoin (2Give) will be "http://xplor.2Give.info/2Give/api".

Query API

The API function to call is specified through the q parameter.
For instance you can ask the current difficulty of 2GiveCoin with "http://xplor.2Give.info/2Give/api?q=getdifficulty".

Real-Time Simple Queries

• addresses: returns a JSON object with the number of known and non-zero addresses (with funds)
• circulating: returns the number of circulating coins (minus reserve, Prime holdings...)
• getblockcount: returns the current block height as a plain text string
• getdifficulty: returns the difficulty as a plain text string
• hashrate: returns the hashrate in GH/s (when supported, blockchain.info API compatible)
• nethashps: returns the hashrate in H/s (when supported)
• netmhashps: returns the hashrate in MH/s (when supported)
• rich: returns the rich list top 1000 (JSON format)
• summary: returns summary information for all explorers
• ticker.btc: returns the last market ticker in BTC, as tracked by the explorer, only one market is tracked and this value can be several minutes behind the market. Use market APIs directly for more accurate quotations.
• ticker.usd: returns the last market ticker in USD, as tracked by the explorer and BitPay rate, only one market is tracked and this value can be several minutes behind the market. Use market APIs directly for more accurate quotations.
• totalbc: returns the outstanding number of coins in satoshis (x 1e8, for compatibility with blockhain.info API)
• totalcoins: returns the outstanding number of coins

Address Queries

Pass the address in the a parameter.

• addressfirstseen: returns the date and time of the block in which the address was first seen, or a string begining with "ERROR:" otherwise.
• getbalance: returns the balance of the address. For incorrect addresses or addresses never seen on the network, the returned balance is zero. Can be delayed by up to 6 hours unless you specify an API Key.
• getreceivedbyaddress: returns the amount received by the address (sum of vout). For incorrect addresses or addresses never seen on the network, the returned amount is zero. Can be delayed by up to 1 hour.
• richrank: returns the rich list rank for the address.

Block Queries

Block APIs only consider blocks in the "main" chain (as determined by the explorer wallet).

• getblockhash: takes a height parameter and returns corresponding block hash.
• getblockheight: takes a hash parameter and returns corresponding block height.

Transaction Queries

Pass the transaction hash in the t parameter.

• lasttxs: returns the last ten transactions (with at least one confirmation), excluding coinbase and stake transactions
• txinfo: returns summary information about a transaction (confirmations, fees, inputs & output addresses and amounts).

API Keys

API Keys can be requested for free, when passed to the API (in the key parameter) they lift some restriction and give access to "live" data with no cache latencies.
API Keys are only used to protect more CPU intensive queries from potential abuse. An API Key is valid for all our explorers.

• getbalance returns the current value, with no delays.
• multiaddr becomes available, this API is similar to blockchain.info's, it has a single active parameter in which you can pass multiple addresses separated by '|'. It returns summary information about those addresses (balance, total sent/receive and latest transactions). By default returns the last 50 transactions, but this number can be adjusted by the optional n parameter.
• unspent becomes available, this API is similar to blockchain.info's, it has a single active parameter in which you can pass multiple addresses separated by '|'. It returns information about unspent outputs of those addresses.
• txbymessage becomes available, pass it an m parameter with the text to be searched in transaction messages (it uses full text search). It will return a list of recent transactions matching the search. You can optionally pass a before parameter with the block height (excluded) before which to search.

Undocumented APIs

The various pages of the site use "undocumented" APIs for their own purpose.
You are free to use them (use, not abuse!), but be aware they can change at any time without notice.