Skip to main content
GET
/
offline-rates
cURL
curl --request GET \
  --url https://api.grainfinance.co/v1/offline-rates \
  --header 'Authorization: Basic <encoded-value>'
{
  "tenorCalculationDate": "2023-12-21",
  "validUntilTs": 1703770471,
  "rates": {
    "USDEUR": {
      "7": 1.11293728,
      "14": 1.12093476,
      "30": 1.10384729,
      "60": 1.09723456,
      "90": 1.08576234,
      "120": 1.07456321,
      "150": 1.06781234,
      "180": 1.05678901,
      "210": 1.0456789,
      "240": 1.03456789,
      "270": 1.02345678,
      "300": 1.01234567,
      "330": 1.00987654,
      "360": 0.99876543
    },
    "USDGBP": {
      "7": 1.27987654,
      "14": 1.26876543,
      "30": 1.28123456,
      "60": 1.29345678,
      "90": 1.30098765,
      "120": 1.31456789,
      "150": 1.32456789,
      "180": 1.33678901,
      "210": 1.34789012,
      "240": 1.35890123,
      "270": 1.36901234,
      "300": 1.37123456,
      "330": 1.38234567,
      "360": 1.39456789
    }
  },
  "revision": 156
}

Documentation Index

Fetch the complete documentation index at: https://docs.grainfinance.co/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Basic authentication using the partner API keys from https://console.grainfinance.co/api-keys

Query Parameters

​
pairs
string

Optional query parameter specifying currency pairs. Multiple pairs can be provided as a comma-separated list. Please encode the query param beforehand. For example, ?pairs=EURUSD%2CGBPEUR represents ?pairs=EURUSD,GBPEUR

Response

Offline Rates Retrieved

Represents the response of an offline rates request, including a revision snapshot with a time-to-live (TTL) indicating validity. Rates are organized by currency pair, with each pair associated with rates for various tenors.

​
tenorCalculationDate
string
required

Date in ISO 8601 format yyyy-MM-dd. This is the date that will be used to calculate the difference in days between the offline revision creation date and the hedge future endAt date. The difference in days will be used to find the right tenor in the offline table.

Example:

"2023-12-21"

​
validUntilTs
number<double>
required

Unix timestamp of expiration for the specific revision. Indicates the maximum duration during which this revision is valid for accepting hedge requests.

Example:

1703770471

​
rates
object
required

Rates information organized by currency pairs and tenors. The structure includes currency pairs as keys, each associated with a nested object containing tenors and corresponding rate.

Example:
{
  "USDEUR": {
    "7": 1.11293728,
    "14": 1.12093476,
    "30": 1.10384729,
    "60": 1.09723456,
    "90": 1.08576234,
    "120": 1.07456321,
    "150": 1.06781234,
    "180": 1.05678901,
    "210": 1.0456789,
    "240": 1.03456789,
    "270": 1.02345678,
    "300": 1.01234567,
    "330": 1.00987654,
    "360": 0.99876543
  },
  "USDGBP": {
    "7": 1.27987654,
    "14": 1.26876543,
    "30": 1.28123456,
    "60": 1.29345678,
    "90": 1.30098765,
    "120": 1.31456789,
    "150": 1.32456789,
    "180": 1.33678901,
    "210": 1.34789012,
    "240": 1.35890123,
    "270": 1.36901234,
    "300": 1.37123456,
    "330": 1.38234567,
    "360": 1.39456789
  }
}
​
revision
number<double>
required

Unique identifier for the offline rates revision. This id is used later to accept an offline rate.

Example:

156