Skip to main content
GET
Get user earnings and markets configuration

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

date
string<date>

Date in YYYY-MM-DD format. Defaults to current date if not provided.

favorite_markets
boolean
default:false

If true, only show markets favorited by the user (requires auth)

maker_address
string

Maker address to query data for

next_cursor
string

Pagination cursor from previous response

no_competition
boolean
default:false

Filter for markets with no competition

only_mergeable
boolean
default:false

Filter for only mergeable markets

only_open_orders
boolean
default:false

Filter for markets where user has open orders

only_open_positions
boolean
default:false

Filter for markets where user has open positions

order_by
enum<string>

Field to sort by

Available options:
max_spread,
min_size,
end_date,
earning_percentage,
rate_per_day,
earnings,
spread,
competitiveness,
question,
price,
market,
volume_24hr
page_size
integer
default:100

Number of items per page (max 500, values above are capped)

Required range: x <= 500
position
enum<string>

Sort direction

Available options:
ASC,
DESC
q
string

Search query to filter markets by question/description

signature_type
enum<integer>

Signature type for address derivation (required for API KEY auth):

  • 0: EOA
  • 1: POLY_PROXY
  • 2: POLY_GNOSIS_SAFE
Available options:
0,
1,
2
sponsored
boolean
default:false

If true, returns sponsored reward earnings

tag_slug
string

Filter by tag slug (can be repeated for OR logic)

Response

Successfully retrieved user earnings and market configurations

Paginated list of user rewards markets

limit
integer
required

Maximum number of items per page

count
integer
required

Number of items in the current response

next_cursor
string
required

Cursor for the next page. "LTE=" indicates the last page.

data
object[]
required
total_count
integer

Total number of items across all pages