Skip to content

COR API

The COR API allows external developers to start building out applications using the data captured as part of the COR pipeline. Currently keys are free to generate for any non-commercial user. Simple head to https://reputation.link/developers/api and sign up with your email for a free key. If you are a commercial user who wishes to use the COR API, please get in touch at hello@reputation.link.

Requests Headers

In order to make requests, an X-API-KEY header is required. Attach this header with your API key as its value in order to make authenticated requests.

Oracle Info

Route

GET api.reputation.link/v1/oracle/ORACLE_ADDRESS/info

Details

This endpoint provides infomation on any oracle registered within our system. Returns the name, address, description and website of a oracle if that data is available to us. If the oracle is not yet reigstered, the name, website and description fields will be returned as null, and only the address will be returned. If an invalid oracle address is passed in, a error response will be returned.

Request and Responses

Example Request

curl -X GET \
  http://api.reputation.link/v1/oracle/0x2ed7e9fcd3c0568dc6167f0b8aee06a02cd9ebd8/info \
  -H 'X-API-KEY: API_KEY' \
  -H 'cache-control: no-cache'

Example Response (Oracle exists)

{
    "name": "Secure Data Links",
    "address": "0x2ed7e9fcd3c0568dc6167f0b8aee06a02cd9ebd8",
    "website": "https://www.securedatalinks.com",
    "description": "The official Secure Data Links Chainlink verified node. Providing high quality data to power decentralised protocols."
}

Example Response (Oracle exists but not registered)

{
    "name": null,
    "address": "0x992ef8145ab8b3dbfc75523281dad6a0981891bb",
    "website": null,
    "description": null
}

Example response (Error - oracle does not exist in our system)

{
    "error": "No data for oracle"
}

Oracle Latest Data

Route

GET api.reputation.link/v1/oracle/ORACLE_ADDRESS/latest

Details

This endpoint provides the latest cumulative data on a given oracle. This data is a full historic summary over the lifetime of the oracle. If the oracle is not yet registered, the name field returned will be null.

Request and Responses

Example Request

curl -X GET \
  http://api.reputation.link/v1/oracle/0x2ed7e9fcd3c0568dc6167f0b8aee06a02cd9ebd8/latest \
  -H 'X-API-KEY: API_KEY' \
  -H 'cache-control: no-cache'

Example Response (Oracle exists)

{
    "name": "Secure Data Links",
    "address": "0x2ed7e9fcd3c0568dc6167f0b8aee06a02cd9ebd8",
    "totalResponses": "67822",
    "totalLinkEarned": 21681.906666715,
    "avgSecResponseTime": 56.7329,
    "avgBlockResponseTime": 3.95022,
    "avgGasPrice": 15.6195541269794,
    "lastTransactionTime": 1590712931
}

Example Response (Oracle exists but not registered)

{
    "name": null,
    "address": "0x992ef8145ab8b3dbfc75523281dad6a0981891bb",
    "totalResponses": "65331",
    "totalLinkEarned": 21390.4666666412,
    "avgSecResponseTime": 74.2729,
    "avgBlockResponseTime": 5.0784,
    "avgGasPrice": 17.0036228462621,
    "lastTransactionTime": 1590712671
}

Example Response (Error - oracle does not exist in our system)

{
    "error": "No data for oracle"
}