Skip to content

Latest commit

 

History

History
165 lines (131 loc) · 4.84 KB

README.md

File metadata and controls

165 lines (131 loc) · 4.84 KB

Chainlink External Adapter for 1Forge

1.4.33

Base URL https://api.1forge.com/

This document was generated automatically. Please see README Generator for more info.

Environment Variables

Required? Name Description Type Options Default
✅ API_KEY An API key that can be obtained from the 1Forge dashboard string
API_ENDPOINT string https://api.1forge.com/

Input Parameters

Every EA supports base input parameters from this list

Required? Name Description Type Options Default
endpoint The endpoint to use string convert, forex, price, quotes quotes

Quotes Endpoint

Returns a batched price comparison from a list currencies to a list of other currencies.

/quotes - Convert from one currency to another.

NOTE: the price endpoint is temporarily still supported, however, is being deprecated. Please use the quotes endpoint instead.

Supported names for this endpoint are: forex, price, quotes.

Input Params

Required? Name Aliases Description Type Options Default Depends On Not Valid With
✅ base base, from
✅ quote quote, to
quantity

Example

Request:

{
  "id": "1",
  "data": {
    "endpoint": "quotes",
    "base": "USD",
    "quote": "EUR"
  },
  "debug": {
    "cacheKey": "7bgmviEbqyIiUCIfawMxKPrtU7Y=",
    "batchCacheKey": "sd6ZPVkDqkZ6Jd06Y/63s1xaO58=",
    "batchChildrenCacheKeys": [
      [
        "7bgmviEbqyIiUCIfawMxKPrtU7Y=",
        {
          "id": "1",
          "data": {
            "endpoint": "quotes",
            "base": "USD",
            "quote": "EUR"
          }
        }
      ]
    ]
  },
  "rateLimitMaxAge": 38400
}

Response:

{
  "jobRunID": "1",
  "data": {
    "payload": [
      {
        "p": 0.8828,
        "a": 0.8828,
        "b": 0.8827,
        "s": "USD/EUR",
        "t": 1641851954307
      }
    ],
    "result": 0.8828
  },
  "result": 0.8828,
  "statusCode": 200,
  "debug": {
    "batchablePropertyPath": [
      {
        "name": "base"
      },
      {
        "name": "quote"
      }
    ]
  },
  "providerStatusCode": 200
}

Convert Endpoint

/convert - Convert from one currency to another.

convert is the only supported name for this endpoint.

Input Params

Required? Name Aliases Description Type Options Default Depends On Not Valid With
✅ base from The symbol of the currency to query string
✅ quote to The symbol of the currency to convert to string
quantity An additional amount of the original currency number 1

Example

Request:

{
  "id": "1",
  "data": {
    "endpoint": "convert",
    "base": "USD",
    "quote": "EUR",
    "quantity": 1
  },
  "debug": {
    "cacheKey": "EbMPGiWl2oE1AmSzqMaVAMCtj3I="
  },
  "rateLimitMaxAge": 19200
}

Response:

{
  "jobRunID": "1",
  "data": {
    "value": "0.862701",
    "text": "1 USD is worth 0.862701 EUR",
    "timestamp": 1636478097478,
    "result": 0.862701
  },
  "result": 0.862701,
  "statusCode": 200,
  "providerStatusCode": 200
}

MIT License