Links
Comment on page

Blockchain

Note zachys (atomic units) are 10^6 in X-Cash

Stats

This method gets the stats
Method: GET
Inputs: None.
Results:
  • height - unsigned int; The current block height.
  • hash - string; The current block hash.
  • reward - unsigned long long; The current block reward in zachys (atomic units).
  • size - unsigned long long; The size of the blockchain in bytes.
  • version - unsigned int; The hard fork version.
  • versionBlockHeight - unsigned int; The block height the hard fork version started on.
  • nextVersionBlockHeight - unsigned int; The block height of the next hard fork version.
  • totalPublicTx - unsigned int; The total public tx.
  • totalPrivateTx - unsigned int; The total private tx.
  • circulatingSupply - unsigned long long; The circulating supply in zachys (atomic units).
  • generatedSupply - unsigned long long; The generated supply in zachys (atomic units).
  • totalSupply - unsigned long long; The total supply in zachys (atomic units).
  • emissionReward - unsigned long long; The estimated constant block reward in zachys (atomic units).
  • emissionHeight - unsigned int; The estimated block height that will start the emission (when the constant block reward is hit).
  • emissionTime - unsigned int; The estimated time when the emission will start (when the constant block reward is hit).
  • inflationHeight - unsigned int; The estimated block height that will start the inflation (when the total supply increases).
  • inflationTime - unsigned int; The estimated time when the inflation will start (when the total supply increases).
$ curl -X GET https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/stats/ -H 'Accept: application/json'
{
"height": 810000,
"hash":"c7aa6eb38c47e7f013a5f8042477d1734ff9808fdc8608fb088085d624d2d509",
"reward": 20000000,
"size": 20000,
"version": 13,
"versionBlockHeight": 1000000,
"nextVersionBlockHeight": 0,
"totalPublicTx": 100000,
"totalPrivateTx": 100000,
"circulatingSupply": 10000000,
"generatedSupply": 100000000,
"totalSupply": 100000000,
"emissionReward": 1000000000,
"emissionHeight": 1000000000,
"emissionTime": 1000000000,
"inflationHeight": 1000000000,
"inflationTime": 1000000000
}

Block Data

This method gets the block data
Method: GET
Resources:
  • blockHeight - Not required - The block height (default is current block height).
Inputs: None.
Results:
  • height - unsigned int; The block height.
  • hash - string; The block hash.
  • reward - unsigned long long; The block reward in zachys (atomic units).
  • time - unsigned int; The time the block was produced.
  • xcashDPOPS - bool;
  • delegateName - string; The delegate name who produced the block.
  • tx - an array of transactions; The list of all transactions included in the block.
$ curl -X GET https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/blocks/810000/ -H 'Accept: application/json'
{
"height": 810000,
"hash": "c7aa6eb38c47e7f013a5f8042477d1734ff9808fdc8608fb088085d624d2d509",
"reward": 47903837995,
"time": 1615984630,
"xcashDPOPS": false,
"delegateName": "",
"tx": ["c7aa6eb38c47e7f013a5f8042477d1734ff9808fdc8608fb088085d624d2d509","b7aa6eb38c47e7f013a5f8042477d1734ff9808fdc8608fb088085d624d2d509"]
}

Transaction Data

This method gets the transaction data
Method: GET
Resources:
  • tx - Required - The tx hash.
Inputs: None.
Results:
  • height - unsigned int; The block height (0 if not added to a block).
  • confirmations - unsigned int; The block confirmations.
  • time - unsigned int; The time.
  • type - string; "private | public".
  • sender - string; The sender, if public.
  • receiver - string; The receiver, if public.
  • amount - unsigned long long; The amount, if public.
$ curl -X GET https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/tx/18a5046994bec4e75d46fd17de3315592aa69d11f4b1a530717ea45a01d49312/ -H 'Accept: application/json'
{
"height": 87004,
"confirmations": 851116,
"time": 1538097417,
"type": "public",
"sender": "XCA1kzoR3ZLNg5zxNmxrY8FYKtgEvPZqC2xoRpm1axCpQcrrZfoKTSkSNsASDspdt3j1WcEnQJyuuB5VPSB56WWy36A4sQtQhe",
"receiver": "XCA1cH8Qs5hLYnzQTDuJqkJiQEZbgQsUM3BgA6vBod5T5Eindas5sikKJaLbkhM3YBW7PtoJY6BtNLkZuahksLFX5eSPDcmCLL",
"amount": 5000000
}

Prove Transaction

This method proves a tx and its amount
Method: POST
Inputs (All are required):
  • tx - The tx hash.
  • address - The destination public address.
  • key - The tx key or tx proof.
Results:
  • valid - bool; Confirms that some amount was sent to the destination public address in this tx.
  • amount - unsigned long long; The amount sent to the destination public address.
$ curl -X POST https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/tx/prove/ -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"tx":"18a5046994bec4e75d46fd17de3315592aa69d11f4b1a530717ea45a01d49312","address":"XCA1cH8Qs5hLYnzQTDuJqkJiQEZbgQsUM3BgA6vBod5T5Eindas5sikKJaLbkhM3YBW7PtoJY6BtNLkZuahksLFX5eSPDcmCLL","key": "c10a439b706949e86146ca17c2fc41e24e4348d6b7a6d6af0623cfc5037fe20c"}'
{
"valid": true,
"amount": 5000000
}

Prove Balance

This method proves that a wallet has at least a certain balance
Method: POST
Inputs (All are required):
  • address - The public address to prove has a certain balance.
  • signature - The signature.
Results:
  • amount - unsigned long long; The amount that the address has proven that it holds. Note the address can hold more than this amount, but not less than this amount.
$ curl -X POST https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/address/prove/ -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"address":"XCA1a9usG2UKajV1Dqzp8fL1BbN3hzuaaJMYjCo7qDoC4C3Vvc5owiLAqKbVw2cRbwRqx3mgrau1Z7LkX6cxR2NC4ZmFBLe2Mf","signature": "ReserveProofV1a15005880f5f88b19fc88bdec29faaf57489ba85dd02d41ec87043a5eddf95a9"}'
{
"amount": 10000000
}

Transaction History

This method gets the public transaction history of an address
Method: GET
Resources:
  • type - Required - "sender | receiver".
  • address - Required - The address.
Inputs: None.
Results:
An array of objects with the following structure:
  • tx - string; The tx.
  • key - string; The tx key.
  • sender - string; The sender.
  • receiver - string; The receiver.
  • amount - unsigned long long; The amount.
  • height - unsigned int; The block height.
  • time - unsigned int; The block timestamp.
$ curl -X GET https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/address/history/sender/XCA1kzoR3ZLNg5zxNmxrY8FYKtgEvPZqC2xoRpm1axCpQcrrZfoKTSkSNsASDspdt3j1WcEnQJyuuB5VPSB56WWy36A4sQtQhe/ -H 'Accept: application/json'
[
{
"tx": "865fa7eeea471c99b85ff05f018ee315df0c95e64c11241a5ca0a40ab9b9909f",
"key": "6b71ee1752c1228c8e239841071ef4b3a37b39d1c42b9ca801827aff5c2c3507",
"sender": "XCA1kzoR3ZLNg5zxNmxrY8FYKtgEvPZqC2xoRpm1axCpQcrrZfoKTSkSNsASDspdt3j1WcEnQJyuuB5VPSB56WWy36A4sQtQhe",
"receiver": "XCA1i6Lbx9JfZCE4di25V8VLwecPAHaH1CA37kC4k3S3gktV9i84R2G4jGnRqjJVMtPMA1GUKYZZCCPct7XGCPUh5qhSR89GUw",
"amount": 15000000,
"height": 524735,
"time": 1579561606
},
{
"tx": "7ecd79d7ead6c2f23cb404409aca01f8c9e30d7b07bcd4e9332a1c4872d1dd93",
"key": "4a5fb3c39caf223eacfe4bcc2db84811c333b52ea30df5c16a6d62b0163cce0b",
"sender": "XCA1kzoR3ZLNg5zxNmxrY8FYKtgEvPZqC2xoRpm1axCpQcrrZfoKTSkSNsASDspdt3j1WcEnQJyuuB5VPSB56WWy36A4sQtQhe",
"receiver": "XCA1cH8Qs5hLYnzQTDuJqkJiQEZbgQsUM3BgA6vBod5T5Eindas5sikKJaLbkhM3YBW7PtoJY6BtNLkZuahksLFX5eSPDcmCLL",
"amount": 5000000,
"height": 160269,
"time": 1542988620
},
{
"tx": "961b0ded408fc94f79014ea15eb5844c79953e34d62905752b3e328c46cc3c15",
"key": "8f68bb4aebe2f95f1a429611d15a57cff525e64478f2709eaadc0abdfc881302",
"sender": "XCA1kzoR3ZLNg5zxNmxrY8FYKtgEvPZqC2xoRpm1axCpQcrrZfoKTSkSNsASDspdt3j1WcEnQJyuuB5VPSB56WWy36A4sQtQhe",
"receiver": "XCA1cH8Qs5hLYnzQTDuJqkJiQEZbgQsUM3BgA6vBod5T5Eindas5sikKJaLbkhM3YBW7PtoJY6BtNLkZuahksLFX5eSPDcmCLL",
"amount": 9746442,
"height": 137722,
"time": 1541632326
},
{
"tx": "18a5046994bec4e75d46fd17de3315592aa69d11f4b1a530717ea45a01d49312",
"key": "c10a439b706949e86146ca17c2fc41e24e4348d6b7a6d6af0623cfc5037fe20c",
"sender": "XCA1kzoR3ZLNg5zxNmxrY8FYKtgEvPZqC2xoRpm1axCpQcrrZfoKTSkSNsASDspdt3j1WcEnQJyuuB5VPSB56WWy36A4sQtQhe",
"receiver": "XCA1cH8Qs5hLYnzQTDuJqkJiQEZbgQsUM3BgA6vBod5T5Eindas5sikKJaLbkhM3YBW7PtoJY6BtNLkZuahksLFX5eSPDcmCLL",
"amount": 5000000,
"height": 87004,
"time": 1538097417
},
{
"tx": "c87228611c6db287a447b421cac5002867e27bc5d9976f451fa02700e9969142",
"key": "60e1631d0f1095c833aba8963190a6ff22d450883b797a0e1543d6ee879d560a",
"sender": "XCA1kzoR3ZLNg5zxNmxrY8FYKtgEvPZqC2xoRpm1axCpQcrrZfoKTSkSNsASDspdt3j1WcEnQJyuuB5VPSB56WWy36A4sQtQhe",
"receiver": "XCA1cH8Qs5hLYnzQTDuJqkJiQEZbgQsUM3BgA6vBod5T5Eindas5sikKJaLbkhM3YBW7PtoJY6BtNLkZuahksLFX5eSPDcmCLL",
"amount": 1000000,
"height": 72893,
"time": 1537243575
}
]

Validate Address

This method validates an address
Method: GET
Resources:
  • address - Required - The address.
Inputs: None.
Results:
An array of objects with the following structure:
  • valid - bool; The validation status.
$ curl -X GET https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/address/validate/XCA1a9usG2UKajV1Dqzp8fL1BbN3hzuaaJMYjCo7qDoC4C3Vvc5owiLAqKbVw2cRbwRqx3mgrau1Z7LkX6cxR2NC4ZmFBLe2Mf/ -H 'Accept: application/json'
{
"valid": true
}

Create Integrated Address

This method creates an integrated address
Method: POST
Inputs:
  • address - Required - The public address.
  • paymentId - Not required - The payment id (either encrypted or long format).
Results:
  • integratedAddress - string; The integrated address
  • paymentId - string; The payment id
$ curl -X POST https://api.xcash.foundation/v1/xcash/blockchain/unauthorized/address/createIntegrated/ -H 'Accept: application/json' -H 'Content-Type: application/json' -d '{"address":"XCA1a9usG2UKajV1Dqzp8fL1BbN3hzuaaJMYjCo7qDoC4C3Vvc5owiLAqKbVw2cRbwRqx3mgrau1Z7LkX6cxR2NC4ZmFBLe2Mf","paymentId": "0000000000000000"}'
{
"integratedAddress": "XCBzxaX4V6yZMYzmKuEPrmZBws3NCxUVEcMtybS5KY6UPbPjTiW7dbdPHVgDmgU5gpRX1g1DYysUY2N3hafhYd6jBw9V9bSQqSo111116d3rEy",
"paymentId": "0000000000000000"
}