The following section outlines a system for how Uphold will provide the transparency our members require in order to ascertain the solvency of the reserve we operate to protect the value entrusted to us by our Members.
We will provide our members with access to two different resources. The first is the Uphold Ledger, or "Reserveledger" as we call it. The Reserveledger is a real-time listing of all the company's assets and liabilities. Each entry in the ledger can reference one or more transactions that a user can inquire about and obtain the details of via the second key resource: the Reservechain.
curl https://api.uphold.com/v0/reserve/statisticsWhich returns the following:
[{
"currency": "BTC",
"values": [{
"assets": "287.24725",
"currency": "BTC",
"liabilities": "133.789096",
"rate": "1.00"
}, {
"assets": "592404.25",
"currency": "CNY",
"liabilities": "275919.87",
"rate": "2062.34967"
}, {
"assets": "76787.16",
"currency": "EUR",
"liabilities": "35764.61",
"rate": "267.31889"
}, {
"assets": "60512.35",
"currency": "GBP",
"liabilities": "28184.40",
"rate": "210.66168"
}, {
"assets": "10591340.78",
"currency": "JPY",
"liabilities": "4933052.69",
"rate": "36871.86292"
}, {
"assets": "96843.97",
"currency": "USD",
"liabilities": "45106.32",
"rate": "337.14500"
}],
"totals": {
"commissions": "7.47763",
"transactions": "1755.86701",
"assets": "493.75857302",
"liabilities": "335.82190088"
}
}, {
"currency": "CNY",
"values": [{
"assets": "0.00",
"currency": "BTC",
"liabilities": "1.02929007",
"rate": "0.00048486"
}, {
"assets": "0.00",
"currency": "CNY",
"liabilities": "2122.73",
"rate": "1.00"
}, {
"assets": "0.00",
"currency": "EUR",
"liabilities": "275.15",
"rate": "0.12962"
}, {
"assets": "0.00",
"currency": "GBP",
"liabilities": "216.83",
"rate": "0.10214"
}, {
"assets": "0.00",
"currency": "JPY",
"liabilities": "37939.77",
"rate": "17.87310"
}, {
"assets": "0.00",
"currency": "USD",
"liabilities": "347.02",
"rate": "0.16347"
}],
"totals": {
"commissions": "16282.33",
"transactions": "3823508.63",
"assets": "1018302.81",
"liabilities": "692583.22"
}
}, {
"currency": "EUR",
"values": [{
"assets": "0.00",
"currency": "BTC",
"liabilities": "12.99977754",
"rate": "0.00374082"
}, {
"assets": "0.00",
"currency": "CNY",
"liabilities": "26809.95",
"rate": "7.71485"
}, {
"assets": "0.00",
"currency": "EUR",
"liabilities": "3475.11",
"rate": "1.00"
}, {
"assets": "0.00",
"currency": "GBP",
"liabilities": "2738.56",
"rate": "0.78805"
}, {
"assets": "0.00",
"currency": "JPY",
"liabilities": "479323.83",
"rate": "137.93055"
}, {
"assets": "0.00",
"currency": "USD",
"liabilities": "4382.81",
"rate": "1.26120"
}],
"totals": {
"commissions": "2093.29",
"transactions": "491498.28",
"assets": "131991.93",
"liabilities": "89772.20"
}
}, {
"currency": "GBP",
"values": [{
"assets": "0.00",
"currency": "BTC",
"liabilities": "6.66475849",
"rate": "0.00474691"
}, {
"assets": "0.00",
"currency": "CNY",
"liabilities": "13745.15",
"rate": "9.78985"
}, {
"assets": "0.00",
"currency": "EUR",
"liabilities": "1781.64",
"rate": "1.26895"
}, {
"assets": "0.00",
"currency": "GBP",
"liabilities": "1404.02",
"rate": "1.00"
}, {
"assets": "0.00",
"currency": "JPY",
"liabilities": "245743.23",
"rate": "175.02830"
}, {
"assets": "0.00",
"currency": "USD",
"liabilities": "2246.99",
"rate": "1.60040"
}],
"totals": {
"commissions": "1648.42",
"transactions": "387091.81",
"assets": "104016.64",
"liabilities": "70745.21"
}
}, {
"currency": "JPY",
"values": [{
"assets": "0.00",
"currency": "BTC",
"liabilities": "1.78214122",
"rate": "0.0000271"
}, {
"assets": "0.00",
"currency": "CNY",
"liabilities": "3676.53",
"rate": "0.05595"
}, {
"assets": "0.00",
"currency": "EUR",
"liabilities": "476.41",
"rate": "0.00725"
}, {
"assets": "0.00",
"currency": "GBP",
"liabilities": "375.43",
"rate": "0.00571"
}, {
"assets": "0.00",
"currency": "JPY",
"liabilities": "65710.91",
"rate": "1.00"
}, {
"assets": "0.00",
"currency": "USD",
"liabilities": "600.84",
"rate": "0.00914"
}],
"totals": {
"commissions": "286882.91",
"transactions": "67366825.69",
"assets": "18205797.97",
"liabilities": "12382365.53"
}
}, {
"currency": "USD",
"values": [{
"assets": "206.51132302",
"currency": "BTC",
"liabilities": "179.55683756",
"rate": "0.00296608"
}, {
"assets": "425898.56",
"currency": "CNY",
"liabilities": "370308.99",
"rate": "6.11710"
}, {
"assets": "55204.77",
"currency": "EUR",
"liabilities": "47999.28",
"rate": "0.79289"
}, {
"assets": "43504.29",
"currency": "GBP",
"liabilities": "37825.97",
"rate": "0.62484"
}, {
"assets": "7614457.19",
"currency": "JPY",
"liabilities": "6620595.10",
"rate": "109.36500"
}, {
"assets": "69624.26",
"currency": "USD",
"liabilities": "60536.69",
"rate": "1.00"
}],
"totals": {
"commissions": "2652.43",
"transactions": "622844.43",
"assets": "166468.23",
"liabilities": "113220.67"
}
}]To assist developers with tracking the overall status of our Reserve, we provide a summary of all the obligations and assets within it. Then for convenience's sake we compute the value of each our holdings in all of the currencies we support, making it easy for example to display our total US dollar liabilities, but expressed in Euros. For example, a request to fetch a summary will return an array of assets with the following properties:
| Property | Description |
|---|---|
| currency | The asset class of the holding being summarized. |
| values | Expresses the value of held in the associated currency in all supported forms. |
| totals | Lists the commissions, transaction volume, assets and liabilities. |
Each normalized holding has the following properties:
| Property | Description |
|---|---|
| assets | The quantity of assets held for the corresponding holding, but converted to a different currency. |
| liabilities | The quantity of liabilities for the corresponding holding, but converted to a different currency. |
| currency | The currency we are computing the current holding in. |
| rate | The rate we used when computing the holding to the corresponding currency. |
GET https://api.uphold.com/v0/reserve/statistics
Our ledger provides a detailed record of the obligations (a.k.a. "liabilities") flowing into our network via our members, and the resulting changes we as a company make to the assets in our reserve to secure the value of those obligations.
The ledger is made up of "entries," each of which contains information about the change to an asset, a liability, or both, and references the related transactions that affected the change whenever possible.
Frequently one may find that changes to the Reserve's assets and liabilities are not made in lock step with one another, and that the Reserve may accrue liabilities of one asset type or another, and then have those liabilities offset by a single change to the Reserve's assets.
curl https://api.uphold.com/v0/reserve/ledgerGET https://api.uphold.com/v0/reserve/ledger
This endpoint supports Pagination.
The following entry shows how a deposit of 0.5 bitcoin by a user would be encoded on the Reserveledger. Every deposit results in two entries in the ledger. The first records the acquisition of a liability, and the second the genesis of an asset. Specifically, it shows the creation of 0.5 bitcoin as an obligation to the user, plus the acquisition of 0.5 bitcoin as an asset.
{
"type": "liability",
"out": {
"amount": "0.00",
"currency": "BTC"
},
"in": {
"amount": "0.5",
"currency": "BTC"
},
"TransactionId": "e205b50e-6649-416d-82c1-98f0ba44dcd9",
"createdAt": "2014-10-08T12:26:29.844Z"
},
{
"type": "asset",
"out": {
"amount": "0.00",
"currency": "BTC"
},
"in": {
"amount": "0.5",
"currency": "BTC"
},
"createdAt": "2014-10-08T12:26:29.844Z"
}
The entry below shows how a user transferring 1.3 bitcoin to a "dollar card," effectively exchanging bitcoin for dollars, would be encoded on the ledger. In this entry, two liabilities are affected. The first is a loss of 1.3 BTC as an obligation, and the second is a gain of $507.51 USD as an obligation. Which makes sense: when a user transfers the bitcoin to their dollar card, Uphold no longer owes them that bitcoin. Instead, Uphold owes them the $507.51 they exchanged for that bitcoin.
{
"type": "liability",
"out": {
"amount": "1.3",
"currency": "BTC"
},
"in": {
"amount": "507.51",
"currency": "USD"
},
"TransactionId": "1571fbef-d34e-447c-9b6e-4ad775953082",
"createdAt": "2014-09-30T20:29:36.575Z"
}
This transfer of value affects our liabilities immediately and in real-time, and thus is reflected in real-time in the ledger. But when our obligations to our members change a possible imbalance in our Reserve is introduced. To compensate for this, we must make changes to the assets as well. These changes to our assets may or may not happen in real-time. This would therefore be recorded in our ledger at some point in the future as follows:
{
"type": "asset",
"out": {
"amount": "1.3",
"currency": "BTC"
},
"in": {
"amount": "507.51",
"currency": "USD"
},
"createdAt": "2014-09-30T20:29:36.575Z"
}
The examples above are nearly identical from one another due to the simplicity of the use case it elucidates. Consider however that when operating normally it is likely that a series of changes to our liabilities will be aggregated and accounted for in a single change to our assets in order to restore balance to the reserve.
When value is removed from the Reserve, two entries are added. One accounting for the change in assets, and the other for the change in liabilities. The following entry shows how a user transmitting some bitcoin to an external network/wallet would be encoded on the ledger. It shows the removal of a liability of bitcoin to the user, and the subsequent removal of bitcoin as an asset.
{
"type": "asset",
"out": {
"amount": "0.10359178",
"currency": "BTC"
},
"in": {
"amount": "0.00",
"currency": "BTC"
},
"createdAt": "2014-10-08T06:53:51.080Z"
},
{
"type": "liability",
"out": {
"amount": "0.10359178",
"currency": "BTC"
},
"in": {
"amount": "0.00",
"currency": "BTC"
},
"TransactionId": "6ab1f3e8-3b84-40b0-aec7-8008117c9f86",
"createdAt": "2014-10-08T06:53:51.080Z"
}
Uphold may decide to secure the value of its Reserve by holding value in asset classes which may or may not correlate to how our liabilities are denominated among our members. For example, Uphold may wish to convert $1,000,000 in cash into a security of equal value. These changes to the Reserve do not relate to any specific transaction, but need to be accounted for nonetheless. What follows is how we could encode shifting 1M dollars into a US Treasury Bill. Take note that we can optionally include additional data relating to the asset class.
{
"type": "asset",
"out": {
amount: "1000000",
currency: "USD"
},
"in": {
"amount": "1",
"currency": "T-Bill"
"meta": {
"maturityDate": '2016-05-01 00:00:00 UTC',
"principal": 1000000,
"rate": 1.5,
"cusip": 345370860
}
},
"createdAt": "2014-10-08T06:53:51.080Z"
}
Uphold's Reservechain is a record of all of the transactions made by its Members that move value through the network. It is a "chain" in that any value moved in a transaction can be easily traced back to it's origin.
At a high level, each transaction in the Reservechain contains the following key pieces of information:
- a unique ID
- the entity initiating the transaction
- the entity receiving the value being moved
- a collection of value stored on the network from which the value for current transaction is derived
- all relevant exchange data associated with the transaction, including the quoted exchange rates, Uphold's commission, etc.
Just like a block chain, the Reservechain is both completely transparent, and traceable. For a transaction to be traceable, the value encapsulated by the transaction must reference all the places within the chain where that value is drawn from. This is done by providing a list of transaction IDs, and the value drawn from each. By following these transactions you walk backwards down different paths of the Reservechain until you ultimately find a genesis point for all value accounted for in the transaction.
All transactions are made public, but specific details about the transaction may be withheld from parties who were not a party to said transaction. To control this we would require developers to authenticate prior to retrieving privileged information relating to a transaction.
A deposit relates to two things: the adding of value into the Reservechain from the outside, and the creation of a new obligation to a user.
Given that this is a point in the chain at which there is a genesis of value, there are no subsequent transactions within the Reservechain to link backwards to. However, we will provide a link to the external authority documenting the source of the value whenever possible.
{
"id": "e205b50e-6649-416d-82c1-98f0ba44dcd9",
"type": "deposit",
"params": {
"currency": "BTC",
"margin": "0.00",
"pair": "BTCBTC",
"rate": "1.00",
"txid": "ffb51cc62944f334aa56ef7339a8df9ba08c712d9db609207f2f1f2105b914b2"
},
"denomination": {
"amount": "0.5",
"currency": "BTC"
},
"origin": {
"amount": "0.5",
"base": "0.5",
"commission": "0.00",
"currency": "BTC",
"fee": "0.00",
"rate": "1.00",
"sources": []
},
"destination": {
"amount": "0.5",
"base": "0.5",
"commission": "0.00",
"currency": "BTC",
"fee": "0.00",
"rate": "1.00"
},
"status": "completed",
"createdAt": "2014-10-08T12:26:29.807Z"
}
Withdrawal documents the flow of assets out of the system. The destination of the transaction would refer as completely as it can to any external sources that the Uphold transaction can be correlated against/with.
Withdrawals also account for value leaving the Reservechain, and is thus a terminus point with regards to traceability.
{
"id": "6ab1f3e8-3b84-40b0-aec7-8008117c9f86",
"type": "withdrawal",
"params": {
"currency": "BTC",
"margin": "0.00",
"pair": "BTCBTC",
"rate": "1.00",
"txid": "5ee2a05a4af8bef5090ee8974798c097a7d6a75be7564d17e6a330bc1c434bab"
},
"denomination": {
"amount": "34.00",
"currency": "USD"
},
"origin": {
"amount": "0.10359178",
"base": "0.10349178",
"commission": "0.00",
"currency": "BTC",
"fee": "0.0001",
"rate": "1.00",
"sources": [{
"id": "33eef226-1c1e-4b38-be2f-28d9a57aecdb",
"amount": "0.10359178"
}]
},
"destination": {
"address": "1BSrDxeTL9ViJBrAb1QHjK2wsGShjSGVeb",
"amount": "0.10349178",
"base": "0.10349178",
"commission": "0.00",
"currency": "BTC",
"fee": "0.00",
"rate": "1.00",
},
"status": "completed",
"createdAt": "2014-10-08T06:53:51.060Z"
}
A transfer documents movement of value within our network, either between two parties or two denominations, or both.
{
"id": "1571fbef-d34e-447c-9b6e-4ad775953082",
"type": "transfer",
"params": {
"currency": "USD",
"margin": "0.45",
"pair": "BTCUSD",
"rate": "392.16000",
"txid": "1946783b396998f8f91c984431ecfecff6d0a72db68b32d0873c1024c7279254"
},
"denomination": {
"amount": "1.3",
"currency": "BTC"
},
"origin": {
"amount": "1.3001",
"base": "1.3",
"commission": "0.00",
"currency": "BTC",
"fee": "0.0001",
"rate": "0.00255",
"sources": [{
"id": "61cdccdf-cb6e-414e-aafc-7c42dc375cf6",
"amount": "0.73327414"
}, {
"id": "34f87520-49a4-4f46-8ee0-ba0522c06aa1",
"amount": "0.56682586"
}]
},
"destination": {
"amount": "507.51",
"base": "509.81",
"commission": "2.30",
"currency": "USD",
"fee": "0.00",
"rate": "392.16000"
},
"status": "completed",
"createdAt": "2014-09-30T20:29:36.458Z"
}
The Reservechain is a public resource, and is 100% anonymous. At no point does the Reservechain expose any personally identifiable information, or any information that could be directly tied to an identity with our network.
We may disclose personally identifiable information to those who were a party to a transaction by way of the protected List User Transactions and List Card Transactions endpoints.