Currencies

currency mirrors the CurrencyRegistry: one row per registered code, with the quote asset new launches in that currency use, whether it is a real stablecoin or a Windrose currency backed by a vault, and the most recent rate the keeper oracle posted for it.

Fields

Field	Type	Unit	Meaning
`code`	hex	bytes32	Currency code, hex encoded. Primary key.
`symbol`	text		Decoded code, for example `"INR"`.
`quoteAsset`	hex	address	ERC-20 that curves in this currency are quoted in.
`quoteDecimals`	int		Decimals of `quoteAsset`.
`tier`	int		`1` real stablecoin (the dollar, EURC), `2` synthetic (a Windrose currency minted by an `FxVault`).
`vault`	hex	address	The `FxVault` for tier 2, `null` for tier 1.
`synth`	hex	address	The synthetic token for tier 2 (equal to `quoteAsset`), `null` for tier 1.
`enabled`	boolean		New launches allowed. Existing launches keep trading regardless.
`lastRate`	bigint	units per USD, 1e18	Latest posted rate. `1e18` for USD, `null` until the oracle has posted one.
`lastRateAt`	bigint	unix seconds	`publishTime` of that rate. `null` for USD.

Indexes: vault, symbol.

Examples

Every currency, alphabetically:

{
  currencys(orderBy: "symbol", orderDirection: "asc", limit: 100) {
    items { code symbol quoteAsset quoteDecimals tier vault synth enabled lastRate lastRateAt }
  }
}

By readable code (no hex encoding needed on this table):

{ currencys(where: { symbol: "INR" }) { items { code quoteAsset vault synth lastRate lastRateAt } } }

By primary key, with the hex code:

{ currency(code: "0x494e520000000000000000000000000000000000000000000000000000000000") { symbol lastRate } }

Only Windrose currencies, with the latest vault snapshot of each (one nested query per row):

{
  currencys(where: { tier: 2 }, orderBy: "symbol", orderDirection: "asc", limit: 100) {
    items {
      symbol vault synth lastRate
      vaultSnapshots(orderBy: "timestamp", orderDirection: "desc", limit: 1) {
        items { assets liability equity crBps synthSupply timestamp }
      }
    }
  }
}

Real stablecoins only:

{ currencys(where: { tier: 1 }) { items { symbol quoteAsset quoteDecimals } } }

Which currencies have launches, and how many:

{
  currencys(orderBy: "symbol", orderDirection: "asc", limit: 100) {
    items {
      symbol
      launches(limit: 1) { totalCount }
    }
  }
}

Rates that look stale (older than two hours, the keeper oracle’s fresh window):

query Stale($cutoff: BigInt!) {
  currencys(where: { tier: 2, lastRateAt_lt: $cutoff }) { items { symbol lastRate lastRateAt } }
}

With curl:

curl -s https://api.windrose.market/graphql \
  -H 'content-type: application/json' \
  -d '{"query":"{ currencys(orderBy:\"symbol\", orderDirection:\"asc\", limit:100){ items { symbol tier quoteAsset vault lastRate lastRateAt } } }"}'

Reading the rate

lastRate is how many units of the currency one US dollar buys, in 1e18 fixed point: an INR rate of 83250000000000000000 means 83.25 INR per USD. To convert a price or amount:

Launch currency to USD: divide by lastRate (and multiply by 1e18 to stay in fixed point).
USD to launch currency: multiply by lastRate / 1e18.

The app uses the same rate to show a launch priced in INR as a dollar figure, and the rates table holds the full history behind lastRate.

How the table is maintained

The table is seeded from registry.allCodes() and registry.get(code) the first time a handler needs it, and updated by CurrencySet when the registry owner adds a synthetic, changes a tier or toggles enabled. lastRate and lastRateAt are written by every RatePosted for a code the registry lists; rates for unlisted codes only appear in rates. On Robinhood Chain and Robinhood testnet EUR is not registered, so there is no EUR row there; Arc testnet registers EURC as tier 1.

Overview

GraphQL queries

HTTP endpoints

Fields

Examples

Reading the rate

How the table is maintained

​Fields

​Examples

​Reading the rate

​How the table is maintained

Fields

Examples

Reading the rate

How the table is maintained