GET
My trades (with market & user detail)

Authorizations

Authorization
string
header
required

The end user's JWT access token, sent as Authorization: Bearer <token>.

Obtain one from POST /partner/customers or POST /partner/customers/login — both return it as token. It identifies which of your users a call is made for, and is sent alongside your X-API-Key on every authenticated endpoint.

Event discovery, categories, subcategories and scores are public and need no token.

X-API-Key
string
header
required

ISV / partner credential — public half. Required on every request.

Identifies the integration partner (ISV) making the call. Issued by Dime Trades when the ISV is onboarded and sent on every /partner/* endpoint:

  • On the two partner endpoints that create accounts or issue tokens (POST /partner/customers, POST /partner/customers/login), it is accompanied by X-API-Secret and is the only authentication — there is no user token yet.
  • On every other partner endpoint it is sent alongside the user's Authorization: Bearer <token>: the API key says which platform is calling, the bearer token says which user it is calling for.

Credentials are scoped to one or more brands; using a key with a brandId outside that scope returns 403. Staging and production keys are separate. The key identifies your platform — treat it as a backend credential.

Query Parameters

marketId
string
Pattern: ^[0-9]+$
Example:

"60497"

predictionSide
enum<string>

Accepted by request validation but currently has no effect — GetUserTradesService does not apply it. Filter client-side on order.predictionSide (remembering to flip it when order.isConvertedOrder is true). Which side of the binary market the order is for.

Available options:
yes,
no
Example:

"yes"

isConvertedOrder
boolean

Accepted by request validation but currently has no effect — GetUserTradesService does not apply it. Filter client-side on order.isConvertedOrder.

since
string<date-time>

ISO-8601 timestamp. Returns only trades created or changed (busted or price-corrected) after it, filtered on updatedAt, ordered oldest change first (updatedAt ASC, id ASC) so you can page forward and resume from the last updatedAt you saw. Without it the order is newest first (createdAt DESC, id DESC); id breaks ties so rows never shuffle between pages.

Example:

"2026-10-01T00:00:00.000Z"

page
integer
default:1

1-based page number for paginated results.

Required range: x >= 1
limit
integer
default:15

Number of rows per page.

Required range: 1 <= x <= 100

Response

Trades returned.

data
object
errors
array