Finage is a leading real-time stock, forex, and cryptocurrency data provider. They offer market data for 60,000+ securities, and a broad selection of data such as financial statements, Ownership, News Sentiments, Earning Call Transcripts and Mergers and Acquisitions. This oracle will initially provide a given stock’s performance relative to its sector’s performance.

Steps For Using This Oracle

• Write and deploy your contract using the network details below
• Fund it with LINK
• Call your request method

Network Details

Ethereum Mainnet

Payment Amount: 1 LINK
LINK Token Address: 0x514910771AF9Ca656af840dff83E8264EcF986CA
Oracle Address: 0xE98dFc0C36408b54326Fa11235D573574B1e8eC3
JobID: 3e478404a3ca4cf5abd2820efe7c1913

Ethereum Kovan Testnet

Payment Amount: 0.1 LINK
LINK Token Address: 0xa36085F69e2889c224210F603D836748e7dC0088
Oracle Address: 0x56dd6586DB0D08c6Ce7B2f2805af28616E082455
JobID: 955810d193e144abb85ae2edea65344d

BNB Chain Mainnet

Payment Amount: 0.1 LINK
LINK Token address:0x404460C6A5EdE2D891e8297795264fDe62ADBB75
Oracle Address: 0xa80bEAEBf1955D8AA9B5f741388e5A43Ba309935
JobID: 55d23024c541439ca28b456044d01304

Create Your Contract

Import ChainlinkClient.sol into your contract so you can inherit the Chainlink behavior.

pragma solidity ^0.4.24;

import "@chainlink/contracts/v0.4/ChainlinkClient.sol";

contract FinageChainlink is ChainlinkClient {

  uint256 oraclePayment;

  constructor(uint256 _oraclePayment) public {
    setChainlinkToken(0xa36085F69e2889c224210F603D836748e7dC0088);
    oraclePayment = _oraclePayment;
  }
  // Additional functions here:

}

pragma solidity ^0.5.0;

import "@chainlink/contracts/v0.5/ChainlinkClient.sol";

contract FinageChainlink is ChainlinkClient {

  uint256 oraclePayment;

  constructor(uint256 _oraclePayment) public {
    setChainlinkToken(0xa36085F69e2889c224210F603D836748e7dC0088);
    oraclePayment = _oraclePayment;
  }
  // Additional functions here:

}

pragma solidity ^0.6.0;

import "@chainlink/contracts/v0.6/ChainlinkClient.sol";

contract FinageChainlink is ChainlinkClient {

  uint256 oraclePayment;

  constructor(uint256 _oraclePayment) public {
    setChainlinkToken(0xa36085F69e2889c224210F603D836748e7dC0088);
    oraclePayment = _oraclePayment;
  }
  // Additional functions here:

}

Tasks

• Finage external adapter
• Copy
• Multiply
• EthInt256
• EthTx

Request Parameters

symbol

• The symbol of the stock to query

Solidity Example

req.add("symbol", "AAPL");

Chainlink Examples

The examples below show how to create a request for the Chainlink node.

requestData function

function requestData
(
  address _oracle,
  bytes32 _jobId,
  string memory _symbol
)
  public
  onlyOwner
{
  Chainlink.Request memory req = buildChainlinkRequest(_jobId, this, this.fulfill.selector);
  req.add("symbol", _symbol);
  sendChainlinkRequestTo(_oracle, req, oraclePayment);
}

fulfill function

int256 public data;

function fulfill(bytes32 _requestId, int256 _data)
  public
  recordChainlinkFulfillment(_requestId)
{
  data = _data;
}

Documentation and Support

• The Finage Relative Stock Performance job depends on calls to the Finage Stock Market Aggregates API and the Stock Market Details API
• For assistance, reach out to Finage using this form