USD / JPY, spot

# For a pack you already bought. Make a key in the dashboard, under API keys.
curl https://orvyn.me/gw/v1/feeds/orvyn/usd-jpy-spot/latest \
  -H "Authorization: Bearer <your API key>"

# The calls left in your packs.
curl https://orvyn.me/gw/v1/packs \
  -H "Authorization: Bearer <your API key>"

# 1. Ask. The answer is 402 with the price, in the PAYMENT-REQUIRED header.
curl -i https://orvyn.me/gw/v1/feeds/orvyn/usd-jpy-spot/latest

# 2. Sign the USDG authorization it describes, then ask again.
curl https://orvyn.me/gw/v1/feeds/orvyn/usd-jpy-spot/latest \
  -H "PAYMENT-SIGNATURE: <base64 payment payload>"

import {Orvyn} from '@orvyn/sdk'

const orvyn = new Orvyn({gatewayUrl: 'https://orvyn.me/gw', account, maxSpendUsdg: 5_000_000n})

const report = await orvyn.read('orvyn/usd-jpy-spot') // pays, or spends a pack, by itself
report.value      // 3 decimals, a bigint
report.checks     // already verified: signer, kind, decimals, payload, age

import {Orvyn} from '@orvyn/sdk'

// No wallet on the server: the key spends calls you bought ahead and cannot buy more.
const orvyn = new Orvyn({gatewayUrl: 'https://orvyn.me/gw', apiKey: process.env.ORVYN_API_KEY})

const report = await orvyn.read('orvyn/usd-jpy-spot') // one call from your pack, nothing signed
report.value      // 3 decimals, a bigint
report.callsLeft  // what the pack still holds

import {OrvynConsumer} from "@orvyn/contracts/src/OrvynConsumer.sol";

contract Example is OrvynConsumer {
    bytes32 constant USD_JPY_SPOT = 0x2a85d479ad7d32cb7dcab98e0d08d3613439d3b737a49792bf3155067219036c;

    function settle(bytes calldata report, bytes calldata sig) external {
        int256 value = _readOnce(USD_JPY_SPOT, report, sig, Policy({
            maxAgeSec: 240,
            allowedKinds: KIND_MANAGED,
            minValue: 0,
            maxValue: type(int256).max
        }));
        // use value, scaled by 3 decimals
    }
}

{
  "mcpServers": {
    "orvyn": {
      "command": "npx",
      "args": ["-y", "@orvyn/mcp"],
      "env": {"ORVYN_GATEWAY_URL": "https://orvyn.me/gw", "ORVYN_PRIVATE_KEY": "<a wallet made for this agent>", "ORVYN_MAX_SPEND_USDG": "1000000"}
    }
  }
}

{
  "mcpServers": {
    "orvyn": {
      "command": "npx",
      "args": ["-y", "@orvyn/mcp"],
      "env": {"ORVYN_GATEWAY_URL": "https://orvyn.me/gw", "ORVYN_API_KEY": "<your API key>"}
    }
  }
}

{
  "type": "object",
  "title": "USD / JPY, spot",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "value",
    "observedAtMs"
  ],
  "properties": {
    "value": {
      "type": "string"
    },
    "observedAtMs": {
      "type": "string"
    }
  }
}