Factomize Everything

This document describes the data being put into the Factom Blockchain by the Factomize Everything Project and the way to access it using the Factom Oracle. Answers to inquiries that can be answered within 30 seconds will be determined. If the answer has not or cannot be resolved within that 30 seconds, a response will be given with a PENDING outcome and a QuestionHash to be used to query for an answer without creating a new transaction. The question will be polled periodically to see if it can be answered. When it is answerable the answer will be placed into the Factom Blockchain and a response containing the AnswerHash and Factom Entry Hash will be available. All Hashes are entry hashes in the Factom Blockchain.

(Currently a request will time out after searching 1000 blockchain entries. Question maintenance and back end blockchain answers will be released in August, 2016)

Data Sources

DataYes - Chinese Stock Quotes *

Intrinio - US Stock Quotes

Poloniex - Bitcoin to various digital currency prices *

Bitcoin Average - Bitcoin Price against multiple fiat currencies *

Bell Average - Gold and Silver Prices *

(* not yet activated)

Factom Oracle

Not all data sources are available through the Factom Oracle. As new data categories are added to Factom, the list of available queryable items will grow.

Request URL

https://trustedoracle.com/API


Requests can be sent via GET or POST. The data fields are the same. In a GET, the are query string fields. In a POST, they are in a JSON document.

GET

https://trustedoracle.com/API?DataType=INTRINIO&DataItem=AAPL

POST

https://trustedoracle.com/API


Post JSON Document

{

"DataType":"INTRINIO",
"DataItem":"AAPL",
"StartDate":"" ,
"EndDate":"",
"GreaterThan":"",
"EqualTo":"",
"LessThan":"",
"Outcome":"",
"OutcomeDate":"",
"Answered":"",
"QuestionHash":"",
"AnswerHash":"",
"FactomEntryHash":""
"APIKey":""

}

Data Formats

All data fields are passed as a string.

Date Format: YYYYMMDDHHmmSS

Request and Response documents are in the same JSON format. The response for a GET is the same JSON document

Example POST Request

curl -X POST -H 'Content-Type: application/json' -d '{"DataType":"INTRINIO","DataItem":"AAPL","StartDate":"","EndDate":"","GreaterThan":"","EqualTo":"","LessThan":"","Answered":"","Outcome":"","OutcomeDate":"","QuestionHash":"","AnswerHash":""}' https://trustedoracle.com/API

Response

{\"DataType\":\"INTRINIO\",\"DataItem\":\"AAPL\",\"StartDate\":\"\",\"EndDate\":\"\",\"GreaterThan\":\"\",\"EqualTo\":\"\",\"LessThan\":\"\",\"Answered\":\"true\",\"Outcome\":\"98.660000\",\"OutcomeDate\":\"20160724230920\",\"QuestionHash\":\"\",\"AnswerHash\":\"\",\"FactomEntryHash\":\"54205e890d24525a6f2f8a3c63a5f64b1995889965d6634bb8f65659d2ba88cb\",\"APIKey\":\"\"}"

Example Get Request

curl -X GET -H 'Content-Type: application/json' https://trustedoracle.com/API?DataType=INTRINIO&DataItem=AAPL

Response

{\"DataType\":\"INTRINIO\",\"DataItem\":\"AAPL\",\"StartDate\":\"\",\"EndDate\":\"\",\"GreaterThan\":\"\",\"EqualTo\":\"\",\"LessThan\":\"\",\"Answered\":\"true\",\"Outcome\":\"98.660000\",\"OutcomeDate\":\"20160724230920\",\"QuestionHash\":\"\",\"AnswerHash\":\"\",\"FactomEntryHash\":\"54205e890d24525a6f2f8a3c63a5f64b1995889965d6634bb8f65659d2ba88cb\",\"APIKey\":\"\"}"

Data Source Specific information

Bell Average

Bell Average has gold and silver spot prices obtained from bellaverage.com, anthemvault.com, and amagimetals.com. These prices are pulled once a minute and are generally up to date.

DataType = BELLAVERAGE

DataItem = GOLD or SILVER


Bitcoin Average

Bitcoin Average stores the average bitcoin price in various fiat currencies. It is pulled once a minute and is generally up to date

Currencies Followed: AUD, BRL, CAD, CNY, EUR, GBP, HKD, IDR, ILS, INR, JPY, MXN, NOK, NZD, PLN, RON, RUB, SEK, SGD, USD, ZAR

DataType=BITCOINAVERAGE

DataItem=Fiat Currency Abbreviation

DataYes (Not Yet Active. Expected 8/2016)

DataYes is information on the 2500+ stock in the Chinese Stock markets. They are pulled at 10 minute intervals and are delayed by one day. That delay may be removed in the near future.

DataType=DATAYES

DataType= stock ticker from Chinese exchanges

(DataType format 000017.XSHE or 600448.XSHG)



Intrinio


Intrinio is data that is pulled from Intrinio.com. It contains the stock tickers and prices for the Russell 3000 stocks. (Top 3000 stock in US market). It is kept at a 15 minute granularity and delayed by 24 hours. (This delay will be removed in the near future)


DataType = INTRINIO


DataItem = Stock Ticker for a Russell 3000 stock



Poloniex

These are the digital currency prices of various currencies being exchanged on the Poloniex Digital Currency Exchange (www.poloniex.com). They are pulled at one minute intervals and are generally up to date.

Currencies Followed: BTS, DASH, DOGE, ETH, FCT, MAID, NXT, OMNI, NXT, XMR, XRP, USDT

DataType=POLONIEX

DataItem=Digital Currency Abbreviation