LogoLogo
Join DiscordFollow on XBridge FundsLong $BERA
  • Doc Bros v1
    • Overview
    • Key Features
      • Speed & Liquidity is Key
      • Bropetual Markets
      • A Hub for Berachain DeFi
    • Proof-of-Liquidity
      • Reward Vault
    • Power of Points
    • Partners & Integrations
    • Campaigns
      • bro.trade Em Up
  • bullish bros
    • SuperBros NFT
  • Technicals
    • What is Proof-of-Liquidity?
    • One-Click Trading
    • Funding Rates
  • Liquidations & Insurance Fund
  • Vertex Edge Sequencer
  • Fees
  • PnL Settlements
  • Withdrawals
  • Pricing (Oracles)
  • links & resources
    • bro.trade Links
      • Website
      • Trade Bropetuals
      • Discord
      • X (Twitter)
      • Medium
      • Swap on OogaBooga
    • Berachain Links
      • Berachain.com
      • Official Bridge
      • BeraHub
      • Berascan
      • Bera Discord
      • Berachain X (Twitter)
      • Berachain Docs
    • FAQ
  • developer bros
    • API
      • Gateway
        • Executes
          • Place Order
          • Cancel Order
          • Cancel and Place
          • Cancel Product Order
          • Withdraw Colleteral
          • Transfer Quote
          • Liquidate Subaccount
          • Mint LP
          • Burn LP
          • Link Signer
        • Queries
          • All Products
          • Contracts
          • Fee Rates
          • Health Groups
          • Insurance
          • Linked Signer
          • Market Liquidity
          • Market Prices
          • Max Lp Mintable
          • Max Order Size
          • Max Withdrawable
          • Min Deposit Rates
          • Nonces
          • Order
          • Orders
          • Status
          • Subaccount Info
          • Symbols
        • Signing
          • Examples
          • Q A
      • Subscriptions
        • Authentication
        • Streams
        • Events
        • Rate Limits
      • Archive (indexer)
        • Candlesticks
        • Events
        • Funding Rate
        • Interest Funding Payments
        • Linked Signer Rate Limit
        • Liquidation Feed
        • Maker Statistics
        • Market Snapshots
        • Matches
        • Merkle Proofs
        • Oracle Price
        • Orders
        • Perp Prices
        • Product Snapshots
        • Rewards
        • Signatures
        • Subaccounts
        • Summary
        • HONEY Price
      • Trigger
        • Executes
          • Place Order
          • Cancel Orders
          • Cancel Product Orders
        • Queries
          • List Trigger Orders
      • V2
        • Apr
        • Assets
        • Contracts
        • Orderbook
        • Pairs
        • Tickers
        • Trades
      • Rate limits
      • Errors
      • Symbols
      • Depositing
      • Withdrawing (on-chain)
      • Integrate via Smart Contracts
      • Definitions / Formulas
    • On-Chain Contracts
Powered by GitBook
On this page
  • Rate limits
  • Request
  • Request Parameters
  • Response
  • Response Fields
  1. developer bros
  2. API
  3. Archive (indexer)

Rewards

PreviousProduct SnapshotsNextSignatures

Last updated 3 months ago

Rate limits

  • 240 requests/min or 40 requests/10secs per IP address. (weight = 10)

See more details in .

Request

POST [ARCHIVE_ENDPOINT]

Body

{
  "rewards": {
    "address": "0xf8d240d9514c9a4715d66268d7af3b53d6196425"
  }
}

Request Parameters

Parameter
Type
Required
Description

address

string

Yes

A wallet address sent as a hex string.

Response

{
  "rewards": [
    {
      "epoch": 6,
      "start_time": "1694610000",
      "period": "2419200",
      "address_rewards": [
        {
          "product_id": 1,
          "q_score": "0",
          "sum_q_min": "0",
          "uptime": 0,
          "maker_volume": "0",
          "taker_volume": "0",
          "maker_fee": "0",
          "taker_fee": "0",
          "maker_tokens": "0",
          "taker_tokens": "0",
          "rebates": "0"
        },
        {
          "product_id": 2,
          "q_score": "0",
          "sum_q_min": "0",
          "uptime": 0,
          "maker_volume": "0",
          "taker_volume": "0",
          "maker_fee": "0",
          "taker_fee": "0",
          "maker_tokens": "0",
          "taker_tokens": "0",
          "rebates": "0"
        }
      ],
      "global_rewards": [
        {
          "product_id": 1,
          "reward_coefficient": "0",
          "q_scores": "0",
          "maker_volumes": "0",
          "taker_volumes": "0",
          "maker_fees": "0",
          "taker_fees": "0",
          "maker_tokens": "0",
          "taker_tokens": "0",
          "uptimes": 0
        },
        {
          "product_id": 2,
          "reward_coefficient": "0",
          "q_scores": "0",
          "maker_volumes": "0",
          "taker_volumes": "0",
          "maker_fees": "0",
          "taker_fees": "0",
          "maker_tokens": "0",
          "taker_tokens": "0",
          "uptimes": 0
        }
      ],
      "num_eligible_addresses": 0
    },
    ...
    {
      "epoch": 2,
      "start_time": "1684933200",
      "period": "2419200",
      "address_rewards": [
        {
          "product_id": 1,
          "q_score": "37767803328173777000000000000",
          "sum_q_min": "15183828332461.346",
          "uptime": 16311,
          "maker_volume": "406414865.604",
          "taker_volume": "30243186.22",
          "maker_fee": "121940.82961903868",
          "taker_fee": "9073.98456253261",
          "maker_tokens": "2034872.7032979282",
          "taker_tokens": "140041.7857941628",
          "taker_referral_fee": "0",
          "taker_referral_tokens": "0",
          "rebates": "30485.20740475967"
        },
        {
          "product_id": 2,
          "q_score": "0",
          "sum_q_min": "0",
          "uptime": 0,
          "maker_volume": "0",
          "taker_volume": "0",
          "maker_fee": "0",
          "taker_fee": "0",
          "maker_tokens": "0",
          "taker_tokens": "0",
          "taker_referral_fee": "0",
          "taker_referral_tokens": "0",
          "rebates": "0"
        }
      ],
      "global_rewards": [
        {
          "product_id": 1,
          "reward_coefficient": "1.4534809874648702",
          "q_scores": "37767815933440308000000000000",
          "maker_volumes": "439361298.873",
          "taker_volumes": "439426304.803",
          "maker_fees": "131826.55223490787",
          "taker_fees": "131849.28737060472",
          "maker_tokens": "2034873.3824508183",
          "taker_tokens": "2034873.3824508183",
          "uptimes": 16468
        },
        {
          "product_id": 2,
          "reward_coefficient": "0.92151901253513",
          "q_scores": "28633774205909980000000000000",
          "maker_volumes": "417882690.476",
          "taker_volumes": "417920882.996",
          "maker_fees": "83583.8915119906",
          "taker_fees": "83593.54277701337",
          "maker_tokens": "1290126.6175491821",
          "taker_tokens": "1290126.6175491821",
          "uptimes": 16468
        }
      ],
      "num_eligible_addresses": 35
    }
  ],
  "update_time": "1688581269",
  "total_referrals": "0"
}

Response Fields

Field Name
Description

rewards.epoch

Number of the corresponding epoch for the associated rewards.

rewards.start_time

Unix epoch start time (in seconds).

rewards.duration

Epoch duration in seconds.

rewards.address_rewards

Rewards per product of the corresponding address in the corresponding epoch.

rewards.global_rewards

Total rewards per product for this epoch.

update_time

Unix epoch time (in seconds) of when the rewards were last updated.

total_referrals

Total accounts this user has referred.

API Rate limits