Skip to main content

Meta

Top-level non-domain reads: user identity, chain catalog, fee config, ownership state.

GET /v1/me​

Identifies the authenticated user behind a Rift access token. Requires Authorization: Bearer <rift-access-token> — see Auth.

GET /v1/chains​

Returns every chain BlockFinaX is deployed on.

curl https://api.blockfinax.com/v1/chains
{
  "data": [
    {
      "chainId": 8453,
      "name": "Base",
      "symbol": "BASE",
      "diamond": "0xbCC51E62C4948FD35ab505bd71804C849601e4Ef",
      "usdc":    "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "usdt":    null,
      "rpcUrl":  "https://mainnet.base.org",
      "paymentDecimals": { "USDC": 6 }
    },
    { "chainId": 1135, "name": "Lisk", ... },
    { "chainId": 56,   "name": "BNB Smart Chain", ..., "paymentDecimals": { "USDC": 18, "USDT": 18 } }
  ]
}

Use this to seed your front-end's chain selector. The Diamond + USDC addresses are the ones the protocol is actually deployed at — don't hardcode them in your app.

GET /v1/hedge/fees?chainId=​

The active platform fee config on a given chain.

curl "https://api.blockfinax.com/v1/hedge/fees?chainId=8453"
{
  "data": {
    "chainId": 8453,
    "creationFee":         "2000000",
    "hedgerFeeRate":       "5000",
    "payoutFeeRate":       "10000",
    "lpProfitFeeRate":     "10000",
    "creatorLoyaltyRate":  "50000"
  }
}
  • creationFee — flat amount in payment-token base units (so 2000000 = 2 USDC on a 6-decimal chain). Paid at createEvent.
  • hedgerFeeRate — applied to each hedger's premium (1e6 precision; 5000 = 0.5%).
  • payoutFeeRate — applied to each payout claim.
  • lpProfitFeeRate — applied to LP premium income.
  • creatorLoyaltyRate — applied to the platform fee, paid to the event creator.

GET /v1/governance/owner?chainId=​

Diamond owner + pending owner (two-step transfer).

curl "https://api.blockfinax.com/v1/governance/owner?chainId=8453"
{
  "data": {
    "chainId": 8453,
    "owner":        "0x1111111111111111111111111111111111111111",
    "pendingOwner": "0x0000000000000000000000000000000000000000"
  }
}

pendingOwner is non-zero during a two-step ownership handover — the named address must call acceptOwnership() for the transfer to complete.

GET /v1/governance/facets?chainId=​

EIP-2535 Diamond Loupe: every facet + the selectors it serves.

curl "https://api.blockfinax.com/v1/governance/facets?chainId=8453"
{
  "data": {
    "chainId": 8453,
    "facets": [
      {
        "facetAddress": "0xfacet1...",
        "functionSelectors": ["0xdeadbeef", "0xcafebabe", ...]
      },
      ...
    ]
  }
}

Useful for verifying you're calling against the deployed code you expect. The more granular Loupe endpoints live in Governance reads.