Developers

REST APIFee Events

Get referral fee events

GET
/referral-fees

Returns paginated on-chain referral fee earnings for the authenticated wallet, newest first.

The occurred_after and occurred_before filters are unix timestamps in milliseconds and both bounds are exclusive: only events that occurred strictly after occurred_after and strictly before occurred_before are returned. Neither bound is carried in the pagination cursor, so send the same filters again when requesting the next page.

Authorization

ApiKeyAuthBearerAuth
headerx-api-key<token>

API key authentication via the x-api-key header.

headerAuthorizationBearer <JWT>

Bearer authentication via the Authorization: Bearer <token> header.

Query Parameters

first?integer

Page size, from 1 to 150. Defaults to 50. A value outside that range is clamped.

Formatint32
after?string

The cursor from the previous page, to get the next one.

Lengthlength <= 1024
fee_in_collateral*boolean

Set to true for the amounts paid in USDT, or false for those paid in outcome tokens.

occurred_after?integer

Only include events that occurred strictly after this unix timestamp (milliseconds)

Formatint64
occurred_before?integer

Only include events that occurred strictly before this unix timestamp (milliseconds)

Formatint64

Response Body

application/json; charset=utf-8
  1. response

Paginated fee event response.

success*boolean
cursor?string
data*array<>
Example Request
curl -X GET 'https://api.predict.fun/v1/referral-fees?fee_in_collateral=true'
Example Response
{  "success": true,  "cursor": "string",  "data": [    {      "transactionHash": "string",      "createdAt": "string",      "takerFeeTokenId": "string",      "amount": "string",      "marketQuestion": "string",      "marketOutcomeName": "string",      "price": "string"    }  ]}

Get maker rebate events GET

Returns paginated on-chain maker rebate earnings for the authenticated wallet, newest first. The occurred_after and occurred_before filters are unix timestamps in milliseconds and both bounds are exclusive: only events that occurred strictly after occurred_after and strictly before occurred_before are returned. Neither bound is carried in the pagination cursor, so send the same filters again when requesting the next page.

Get positions GET

Get data about your positions. Requires JWT authentication.