Published in


Getting started with Oraclize

While receiving lot of compliments for the work we have done in building a strong oracle solution, our company inbox is also filled with users’ emails encountering technical issues when they first approach Ethereum and our oracle service. We understand that the information we are sharing are spread on different locations and it is therefore difficult for interested parties to find them. As the interest in Oraclize keeps growing, improving that aspect become more and more important for us!

We are going to dedicate more resources in that direction during the coming months, aiming to create a more user-friendly environment for developers interested in using the Oraclize technology.

In the following paragraphs there is a list of useful resources for people keen to find out more about Oraclize and for the developers willing to build on top of our service.


First of all, it is important to learn more about a few concepts underneath the Oraclize solution. We would suggest to start from the definition of “blockchain oracle” followed by an overview of the Oraclize approach.

Hint: a fundamental piece of the puzzle sits in our authenticity proofs! You can find a general introduction here, a technical introduction here and a more practical examples-driven tutorial here.

Stay updated

Our software engineers are always busy improving the service and adding new features: we keep our community posted via our blog, our twitter account (@OraclizeIT) and our talks at a variety of conferences around the world. You can find most of our presentations on Youtube, here are the links to a few relevant ones (many more are available online though, look for them!): Devcon1, Devcon2, EDCON and Devcon3.

We are also hosting our own Oraclize Meetup in London, where we deep-dive into multiple themes related to our technology!

We do alternate high-tech meetings (where we discuss about the technical details underneath the Oraclize technology and where we deep-dive into new features/developments) with more general talks exploring projects based on top of such technology.

# Newbie

Our documentation is a good starting point for developers. Other useful resources while approaching Oraclize for the first time are our GitHub repositories and our Web IDE including a few basic code-examples (Ethereum specific).

The (amazing) community has produced a variety of tutorials on how to integrate Oraclize into Ethereum smart contracts, some of those follow:,, and johnhckuo. These information should provide you with a better understanding of the Oraclize solution.

# Beginner

Before getting their hands dirty, developers should decide what kind of blockchain they want to use. Oraclize is integrated with multiple ones and we offer different tools for each of those.

When using our service on Ethereum (on either the Mainnet or any testnet), developers just have to integrate our APIs (Ethereum APIs) within their smart contract and use the service straight away. A similar approach has to be followed while using Oraclize on R3 Corda (Corda APIs).

Different configurations are available when using RSK, Monax and Ethereum-based private networks, that require developers to install the Rootstock Bridge, the Eris (Monax) Bridge and the Ethereum Bridge respectively.

Once the setup is completed, hackers can actually start coding: for that purpose, our Test Query tool and Remix-based Web IDE (Ethereum specific) might result useful.

As for Bitcoin, the approach is completely different and requires users to design “conditional escrow addresses”: the oraclize-lib is a simple interface for developers willing to leverage Oraclize on the Bitcoin protocol.

# Intermediate

At this point developers will start encountering difficulties: if this doesn’t happen, you may be doing something wrong! :)

In case you are using Oraclize on Ethereum, the fastest way to address your issues is to look for suggestions on Stack Exchange as it contains discussions on almost 400 Oraclize-related topics.

An alternative (currently for Ethereum and Corda only) is leveraging our public Gitter channels, where 450+ developers actively discuss Oraclize issues and support each other (we do offer support there as well!).

While building Oraclize-based projects, developers might find useful to leverage our Network Monitor tool (this is a client-side tool available on our Github) as well as our Proof Verification tool to verify both the integrity and the correctness of the Oraclize authenticity proofs. Another interesting feature is our “nested” datasource, enabling developers to design more complex Oraclize queries, including multiple sub-queries.

If you are using Oraclize within a different blockchain protocol, finding information will be more complex. In such situation, feel free to get in touch with us by email and we will try to help you.

# Advanced

Developers willing to design more complex applications might be interested in a few features of ours that cover specific use-cases: we have a dedicated area for advanced topics on our documentation and a few examples on our GitHub. These features include:

# Oraclize expert

To all developers who successfully managed to leverage all our tools and features while building Oraclize-based projects and have scrolled down to reach this level: congratulations, you are amazing guys!

Should those projects have specific needs that are not addressed by our current set of tools, please let us know, we would be happy to help!

Also, we are always looking for developers and software engineers to expand our team — feel free to reach out if you are interested.

Note: The company has now rebranded into Provable.



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store