Maker Rebates

Endpoint

GET /rebates

Server: https://api.openfish.fun

Authentication: None required

---

Query Parameters

Parameter	Type	Required	Default	Description
address	string	Yes	—	Ethereum address of the maker
date	string	No	—	Restrict to a single day (YYYY-MM-DD)
market	string	No	—	Condition ID. When provided, the response contains a per-market volume breakdown from individual trades rather than aggregate rebate entries
limit	integer	No	30	Maximum entries to return (1-365)
offset	integer	No	0	Pagination offset

---

Responses

200 — Rebate data returned

The body is an array of RebateEntry objects.

RebateEntry Schema:

Field	Type	Required	Description
address	string	Yes	Maker’s Ethereum address
periodStart	string	Yes	Start of rebate period (YYYY-MM-DD)
periodEnd	string	Yes	End of rebate period (YYYY-MM-DD)
makerVolume	string	Yes	Maker volume for this period
rebateRateBps	integer	Yes	Rebate rate in basis points
rebateAmount	string	Yes	Rebate amount in USDC
status	string	Yes	Rebate status (e.g. "PENDING", "PAID")

Volume Tier Schedule:

Maker Volume	Rebate (bps)
>= 1,000,000 USDC	4 (0.04%)
>= 100,000 USDC	3 (0.03%)
>= 10,000 USDC	2 (0.02%)
>= 1,000 USDC	1 (0.01%)
< 1,000 USDC	0

Sample Response (aggregate):

[
  {
    "address": "0xFeA4cB3dD4ca7CefD3368653B7D6FF9BcDFca604",
    "periodStart": "2026-04-08",
    "periodEnd": "2026-04-09",
    "makerVolume": "150000.00",
    "rebateRateBps": 3,
    "rebateAmount": "45.00",
    "status": "PENDING"
  }
]

Sample Response (with market param — per-market breakdown):

[
  {
    "address": "0xFeA4cB3dD4ca7CefD3368653B7D6FF9BcDFca604",
    "market": "0xabc123...",
    "makerVolume": "50000.00",
    "rebateRateBps": 2,
    "rebateAmount": "10.00"
  }
]

400 — Bad request

{ "error": "invalid address" }

500 — Internal server error

{ "error": "Internal server error" }