Are you an LLM? Read llms.txt for a summary of the docs, or llms-full.txt for the full context.
Skip to content

builderMeEarned

Returns paginated builder-fee earnings aggregated by order. Multiple fills for the same order are merged into one row; amounts and quantities are summed, and price is the order VWAP.

Pass the builder's own wallet address in user. Each row's user field is the masked trading-user address, not the builder.

total counts matching orders across all pages, not individual fills. Deep paging is capped at page × pageSize + pageSize ≤ 10000; narrow the time window when you need older pages.

POST/infotype builderMeEarned

List a builder’s earnings, one row per order.

Request body
typestringrequired
userstringrequired

Builder wallet address.

endTimeinteger · int64optional

Inclusive upper bound in milliseconds.

pageinteger · int32optional

Zero-based page index. Defaults to 0.

pageSizeinteger · int32optional

Defaults to 50 and is capped at 100.

startTimeinteger · int64optional

Inclusive lower bound in milliseconds.

Request example
curl -X POST https://rpc.txflow-testnet.xyz/info \
  -H "Content-Type: application/json" \
  -H "x-api-version: 2026-08-16" \
  -d '{
  "endTime": 1700000000000,
  "page": 0,
  "pageSize": 0,
  "startTime": 1700000000000,
  "type": "builderMeEarned",
  "user": "0x0000000000000000000000000000000000000000"
}'
Try it
POST https://rpc.txflow-testnet.xyz/info
Response · BuilderMeEarnedResponse 200
codeinteger

`0` on success.

dataBuilderMeEarnedResponse
itemsBuilderMeEarnedItem[]
pageinteger · int32
pageSizeinteger · int32
totalinteger · int64

Total matching orders across all pages.

successboolean

`false` on error, with `code` set and the text in `message` instead of `data`.

Response example
{
  "success": true,
  "code": 0,
  "data": {
    "items": [
      {
        "builderFee": "",
        "builderFeeRate": "",
        "builderFeeRateF": 0,
        "instrumentId": 9001,
        "instrumentName": "",
        "marketType": "perps",
        "notional": "",
        "orderId": 0,
        "price": "0",
        "qty": "",
        "role": "taker",
        "time": 1700000000000,
        "tradeId": 0,
        "txHash": "",
        "user": "0x0000000000000000000000000000000000000000"
      }
    ],
    "page": 0,
    "pageSize": 0,
    "total": 0
  }
}