Fee claims

feeClaim records the two ways trading fees leave a bonding curve: CreatorFeesClaimed, when a creator withdraws their 30% share, and ProtocolFeesSwept, when anyone forwards the protocol’s 70% to the fee collector. Fees accrue inside the curve until then and are not rows here.

Fields

Field	Type	Unit	Meaning
`id`	text		`txHash-logIndex`. Primary key.
`curve`	hex	address	The bonding curve.
`launch`	hex	address	The launch token, for the relation.
`kind`	enum		`creator` or `protocol`.
`to`	hex	address	Recipient: the address the creator chose, or the factory’s fee collector.
`amount`	bigint	quote units	Amount paid out, in the launch’s quote asset scaled to 18 decimals.
`timestamp`	bigint	unix seconds
`blockNumber`	bigint
`txHash`	hex

Indexes: curve, launch.

Examples

Claims for a curve, newest first:

{
  feeClaims(where: { curve: "0x..." }, orderBy: "timestamp", orderDirection: "desc") {
    items { kind to amount timestamp txHash }
  }
}

Creator claims for a launch, through the relation:

{
  launch(token: "0x...") {
    symbol creator quoteDecimals
    feeClaims(where: { kind: "creator" }, orderBy: "timestamp", orderDirection: "desc") {
      items { to amount timestamp txHash }
    }
  }
}

Everything paid to one address (a creator’s wallet across their launches, or the fee collector):

query PaidTo($to: String!) {
  feeClaims(where: { to: $to }, orderBy: "timestamp", orderDirection: "desc", limit: 200) {
    items { kind amount timestamp txHash launchInfo { symbol currency } }
  }
}

Protocol sweeps in a window:

query Sweeps($since: BigInt!) {
  feeClaims(where: { kind: "protocol", timestamp_gte: $since }, orderBy: "timestamp", orderDirection: "asc", limit: 1000) {
    items { launch amount timestamp launchInfo { currency } }
  }
}

With curl:

curl -s https://api.windrose.market/graphql \
  -H 'content-type: application/json' \
  -d '{"query":"query($c:String!){ feeClaims(where:{curve:$c}, orderBy:\"timestamp\", orderDirection:\"desc\"){ items { kind to amount timestamp txHash } } }","variables":{"c":"0x..."}}'

Notes

amount is per launch currency, so sum claims per launchInfo.currency rather than across currencies. Convert to USD with the currency’s rate if you need one total.
Unclaimed fees are not in this table. Read creatorFeesAccrued() and protocolFeesAccrued() on the curve for the amounts still sitting in it; the app’s creator panel does exactly that.
Fees from trading on the Uniswap v4 pool after graduation go to the LiquidityLocker, not the curve, and are not indexed here.
Both claims are permissionless: claimCreatorFees() always pays the curve’s feeRecipient and sweepProtocolFees() the protocol fee collector, so either row can be sent by anyone. to is the address that was paid, not the caller.

Overview

GraphQL queries

HTTP endpoints

Fields

Examples

Notes