SBOR

The benchmark borrow and supply rate for lending on Stacks, read from lending contract state. Use this to judge whether a lending offer is good: borrowing above the SBOR borrow rate means paying more than the market, supplying below the supply rate means earning less. Returns every currency index unless one is named. Always read the freshness line first.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "enum": [
        "SBOR-USD",
        "SBOR-BTC",
        "SBOR-STX",
        "BTC-COLLATERAL-USDC"
      ],
      "description": "Currency index, or BTC-COLLATERAL-USDC for borrowing USDC against bitcoin on Base, Ethereum or Arc. Omit for all of them."
    }
  },
  "additionalProperties": false
}

Given a rate you have been offered, say whether it is above or below the market for that currency, and by how much. This is the main reason SBOR exists. Recommended use: if a borrow offer is more than 50 basis points above the benchmark, stop and ask a human. Use SBOR to stop, never to start. For a USDC loan against bitcoin (cbBTC, WBTC or cirBTC) on Base, Ethereum or Arc, compare with BTC-COLLATERAL-USDC; for lending on Stacks, with the index for the currency. This tool refuses rather than guesses: an error result means there is no trustworthy answer, not that the rate is bad.

{
  "type": "object",
  "properties": {
    "rate": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "The rate offered, as a percentage between 0 and 100. 4.2 means 4.2%, not 0.042."
    },
    "side": {
      "type": "string",
      "enum": [
        "borrow",
        "supply"
      ],
      "description": "Whether you would be borrowing or supplying."
    },
    "index": {
      "type": "string",
      "enum": [
        "SBOR-USD",
        "SBOR-BTC",
        "SBOR-STX",
        "BTC-COLLATERAL-USDC"
      ],
      "description": "Which benchmark: a Stacks currency index, or BTC-COLLATERAL-USDC for borrowing USDC against bitcoin on Base, Ethereum or Arc."
    }
  },
  "required": [
    "rate",
    "side",
    "index"
  ],
  "additionalProperties": false
}

Every venue and asset in an index, with its borrow rate, supply rate, utilization, depth and weight. Utilization explains why a rate sits where it does.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "enum": [
        "SBOR-USD",
        "SBOR-BTC",
        "SBOR-STX",
        "BTC-COLLATERAL-USDC"
      ],
      "description": "Currency index, or BTC-COLLATERAL-USDC. Omit for the Stacks indices."
    }
  },
  "additionalProperties": false
}

Daily fixings since the index began. Use this to see whether a rate is unusual, or how the cost of capital has moved. Means are given per methodology version, never across a change in how the number is built.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "enum": [
        "SBOR-USD",
        "SBOR-BTC",
        "SBOR-STX"
      ],
      "description": "Which currency."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "How many days back, up to 200. Default 30."
    }
  },
  "required": [
    "index"
  ],
  "additionalProperties": false
}

The same asset classes on the largest lending markets on Ethereum, Base, Hyperliquid and Solana, plus SOFR, the US repo rate, and what it costs to borrow USDC against bitcoin on Base, Ethereum and Arc. Context only: none of these is ever a constituent of an SBOR index. Aave on Ethereum and Base and the bitcoin-collateral markets are read from contract state; the other venues come from DefiLlama, so small differences are expected for those.

{
  "type": "object",
  "properties": {
    "index": {
      "type": "string",
      "enum": [
        "SBOR-USD",
        "SBOR-BTC",
        "SBOR-STX"
      ],
      "description": "Only markets comparable to this index. Omit for all."
    }
  },
  "additionalProperties": false
}

The full methodology and integration policy: how the fixing is built, what is excluded and why, and what SBOR will and will not do. Read this before quoting a rate in anything that matters.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}