Chainlink Developers

Welcome to the Chainlink documentation site. You'll find comprehensive guides and documentation to help you start working with Chainlink as quickly as possible, as well as support if you get stuck. Click here for an introductory walkthrough on how to create a Chainlink request on the Ropsten test network!

Building on Chainlink? Click here to get started!

Get Started

Addresses and Job IDs

In order for a contract to make use of the Chainlink network, you'll need to have the address of the LINK token contract and our oracle contract.

Ropsten (faucet)

LINK token address: "0x20fE562d797A42Dcb3399062AE9546cd06f63280"
Oracle address: "0xc99B3D447826532722E41bc36e644ba3479E4365"

Rinkeby (faucet)

LINK token address: "0x01BE23585060835E02B77ef475b0Cc51aA1e0709"
Oracle address: "0x7AFe1118Ea78C1eae84ca8feE5C65Bc76CcF879e"

Kovan (faucet)

LINK token address: "0xa36085F69e2889c224210F603D836748e7dC0088"
Oracle address: "0x2f90A6D021db21e1B2A077c5a37B3C7E75D15b7e"

constructor() public {
  setLinkToken(0x20fE562d797A42Dcb3399062AE9546cd06f63280);
  setOracle(0xc99B3D447826532722E41bc36e644ba3479E4365);
}
constructor() public {
  setLinkToken(0x01BE23585060835E02B77ef475b0Cc51aA1e0709);
  setOracle(0x7AFe1118Ea78C1eae84ca8feE5C65Bc76CcF879e);
}
constructor() public {
  setLinkToken(0xa36085F69e2889c224210F603D836748e7dC0088);
  setOracle(0x2f90A6D021db21e1B2A077c5a37B3C7E75D15b7e);
}

You will need the JobID as bytes when requesting data from Chainlink. We have pre-made jobs available for you. Types with a Multiplier indicate that the value received from the given endpoint will be multiplied by the specified "times" value before being written to the blockchain. If you use a JobId with a Multiply adapter without specifying a "times" parameter, the result will be multiplied by 0. The string value of the JobIDs will need to be given to the Request as bytes.

Tasks
JobID
Required Parameters

Ropsten: 5b280bfed77646d297fdb6e718c7127a
Rinkeby: b0bde308282843d49a3a8d2dd2464af1
Kovan: 50fc4215f89443d185b061e5d7af9490

get(string)
path(dot-delimited string or array of strings)

Ropsten: 469e74c5bca740c0addba9ea67eecc51
Rinkeby: c28c092ad6f045c79bdbd54ebb42ce4d
Kovan: b9fd06bb42dd444db1b944849cbffb11

post(string)
path(dot-delimited string or array of strings)

Ropsten: 93032b68d4704fa6be2c3ccf7a23c107
Rinkeby: 648f1b4629324c7ab41b7980b3091138
Kovan: f9d13102fb90482f992fc06e15ed373b

get(string)
path(dot-delimited string or array of strings)

Ropsten: e055293deb37425ba83a2d5870c57649
Rinkeby: c8084988f0b54520ba17945c4a2ab7bc
Kovan: ad752d90098243f8a5c91059d3e5616c

get(string)
path(dot-delimited string or array of strings)
times(int)

Ropsten: fb5fb7b18921487fb26503cb075abf41
Rinkeby: 367c3cb39ab34bccad27deea5e37f365
Kovan: 2c6578f488c843588954be403aba2deb

get(string)
path(dot-delimited string or array of strings)

Ropsten: 493610cff14346f786f88ed791ab7704
Rinkeby: 6d1bfe27e7034b1d87b5270556b17277
Kovan: 29fa9aa13bf1468788b7cc4a500a45b8

get(string)
path(dot-delimited string or array of strings)
times(int)

Ropsten: 7ac0b3beac2c448cb2f6b2840d61d31f
Rinkeby: 4ce9b71a1ac94abcad1ff9198e760b8c
Kovan 6d914edc36e14d6c880c9c55bda5bc04

get(string)
path(dot-delimited string or array of strings)

Pricing Information

All Chainlink jobs on all test networks require 1 LINK as payment. You may set up a payment as a constant available in the contract or as an input variable, like the example below.

function createRequest(bytes32 _jobId, uint256 _payment) 
  public
  onlyOwner
{
  Chainlink.Request memory req = newRequest(_jobId, this, this.fulfill.selector);
  // request parameters go here
  chainlinkRequest(req, _payment);
}

Addresses and Job IDs


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.