> ## Documentation Index > Fetch the complete documentation index at: https://docs.sx.bet/llms.txt > Use this file to discover all available pages before exploring further. # Get your bets > Query your bet history from the SX Bet API. `GET /trades-v3` returns **one row per bet**: everything that resulted from a single order you submitted. An order that matched against four resting orders is one row here with `fillCount: 4`. The individual matches are on [`GET /fills-v3`](/api-reference/get-fills-v3). `tradeId` identifies the bet — filter fills by that value, and look up one bet with [`GET /trades-v3/{tradeId}`](/api-reference/get-trade-v3). ## OpenAPI ````yaml GET /trades-v3 openapi: 3.0.1 info: title: SX Bet API version: 1.0.0 description: >- REST API for the SX Bet decentralized sports betting exchange. Retrieve sports data, markets, and orderbook information. Post, cancel, and fill orders with signed payloads. Base URLs: - **Mainnet**: `https://api.sx.bet` - **Testnet**: `https://api.toronto.sx.bet` servers: - url: https://api.sx.bet description: Mainnet (SX Network, chainId 4162) - url: https://api.toronto.sx.bet description: Testnet (Toronto, chainId 79479957) security: [] tags: - name: Connection description: Server metadata and heartbeat management - name: Sports Data description: Sports, leagues, teams, fixtures, and live scores - name: Markets description: Active, specific, and popular betting markets - name: Trades description: Matched trades and portfolio history - name: Orders description: Orderbook queries, posting, cancelling, and filling orders paths: /trades-v3: get: tags: - Trades summary: Get your trades description: >- Your bets, at BET grain — one row per bet regardless of how many orders filled it. Scoped to the authenticated address. operationId: getTradesV3 parameters: - name: marketHash in: query required: false schema: type: string description: Market ID to filter by. - name: status in: query required: false schema: type: string enum: - PENDING - LOCKED - SETTLED - FAILED description: Status to filter by. - name: startDate in: query required: false schema: type: string format: date-time example: '2026-06-01T00:00:00Z' description: Only include bets placed at or after this time (ISO-8601). - name: endDate in: query required: false schema: type: string format: date-time example: '2026-06-08T00:00:00Z' description: >- Only include bets placed at or before this time (ISO-8601). Must not be earlier than `startDate`. - name: sortAsc in: query required: false schema: type: boolean default: true description: Sort oldest-first. Defaults to true. - name: perPage in: query required: false schema: type: integer minimum: 1 maximum: 100 default: 50 description: Rows per page. - name: nextKey in: query required: false schema: type: string description: Cursor from the previous response to continue pagination. responses: '200': description: '' content: application/json: schema: type: object properties: status: type: string description: '`success` or `failure` if the request succeeded or not' data: type: object properties: trades: type: array items: $ref: '#/components/schemas/TradeV3' nextKey: type: string description: >- Pass as `nextKey` to retrieve the next page. Absent — not null — on the last page. example: status: success data: trades: - tradeId: >- 0xac6bb30bba6ea82d8717219a4fa49d15b58fd638fba479f294b4d402376d14d6 userAddress: '0xbcc6D643e4159A75ED1dB4e13330230B82F2AEe5' wallet: '0x4361123dbdc1D812fdf7D27045aF358C9C8AA70A' marketHash: >- 0x1fec4ed9b71c2f812db900af7d12446158a0eda56041106f99551c496efd3266 isBettingOutcomeOne: false isParlay: false totalStake: '1000000' totalReturn: '2500000' weightedAverageOdds: '40000000000000000000' ceRefundAmount: '0' ceRefundFeeAmount: '0' usedBetCredits: false fillCount: 2 status: LOCKED betTime: '2026-07-31T18:47:09.577Z' gameTime: '2040-01-01T00:00:00.000Z' createdAt: '2026-07-31T18:47:09.575Z' updatedAt: '2026-07-31T18:47:12.837Z' settlement: null '400': description: '' content: application/json: schema: oneOf: - $ref: '#/components/schemas/ErrorNestArray' - $ref: '#/components/schemas/ErrorNest' example: message: Invalid nextKey error: Bad Request statusCode: 400 '401': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorNest' example: message: BAD_AUTH error: Unauthorized statusCode: 401 '503': description: '' content: application/json: schema: $ref: '#/components/schemas/ErrorNest' example: message: Service Unavailable statusCode: 503 security: - SxApiKey: [] components: schemas: TradeV3: description: >- Bet grain: one row per bet. Carries `isParlay` but no quarter-line flag, so `/trades-v3` alone cannot distinguish a quarter-line bet from a single — drill into `/fills-v3`. type: object properties: tradeId: type: string description: Identifies the bet. Filter `GET /fills-v3` by this value. userAddress: type: string description: Your user address — the proxy owner. wallet: type: string description: >- The proxy wallet the funds moved from. A different address from `userAddress`. marketHash: type: string description: >- The market hash for this trade. For a quarter-line bet, this is the parent hash — leg hashes are on the fills. See [Quarter-line markets](/developers/quarter-line-markets) for how the parent and leg hashes relate. isBettingOutcomeOne: type: boolean description: Which outcome you backed. isParlay: type: boolean description: True when `marketHash` is a parlay parent. totalStake: type: string description: What you risked, in base units. totalReturn: type: string description: >- Gross return if this bet wins, in base units, stake included. Profit is `totalReturn - totalStake`. weightedAverageOdds: type: string description: Implied odds. Stake-weighted mean of the fill odds. ceRefundAmount: type: string description: >- In base units. On a parlay row (`isParlay: true`), this is an early stake refund rather than a capital-efficiency refund — see [Your bets](/developers/which-grain#bets). ceRefundFeeAmount: type: string description: >- In base units. Same caveat as `ceRefundAmount` — see [Your bets](/developers/which-grain#bets). usedBetCredits: type: boolean description: Whether bet credits funded this bet. fillCount: type: integer description: How many `fill_v3` rows exist under this `tradeId`. status: type: string enum: - PENDING - LOCKED - SETTLED - FAILED description: >- See [Bet lifecycle](/developers/bet-lifecycle) for what each status means. externalUserId: type: string description: >- Optional partner tag from the order that produced this bet, present only when set. betTime: type: string description: >- ISO 8601 timestamp of when the bet was placed. This route sorts by this field. gameTime: type: string description: ISO 8601. Scheduled start of the fixture. createdAt: type: string description: ISO formatted date string of when this trade record was created updatedAt: type: string description: ISO formatted date string of when this trade record was last updated settlement: allOf: - $ref: '#/components/schemas/TradeV3Settlement' nullable: true description: Null until the bet settles. ErrorNestArray: description: >- Validation errors. Same envelope as ErrorNest but `message` is an array — normalise both. type: object properties: message: type: array items: type: string example: - 'range must be one of the following values: 1, 7, 30' error: type: string example: Bad Request statusCode: type: integer example: 400 ErrorNest: description: Most common shape. type: object properties: message: type: string example: INVALID_USER error: type: string example: Unauthorized statusCode: type: integer example: 401 TradeV3Settlement: type: object properties: outcome: type: integer description: >- 0 = void (or a corrupt row — there is no enum guarding this), 1 = outcome one, 2 = outcome two. settleReturnAmount: type: string description: >- Paid out at settlement, as a base-unit decimal string (USDC has 6 decimals). settleFeeAmount: type: string description: >- Fee taken at settlement, in base units. Always a string at bet grain; the same field on a fill may be null. settleCeRefundAmount: type: string description: Capital-efficiency refund snapshotted at settlement, in base units. settleDate: type: string description: ISO 8601. When settlement was recorded. securitySchemes: SxApiKey: type: apiKey in: header name: x-sx-api-key description: >- API key, sent as the `x-sx-api-key` header. Generate one from the API keys section of your account page on sx.bet. ````