> ## Documentation Index
> Fetch the complete documentation index at: https://docs.4casters.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 獲取未撮合訂單
> 列出你在交易所上掛著的未成交訂單
回傳呼叫方當前掛在交易所上、可供撮合的全部**未成交訂單**。
請求
`GET /user/getUnmatched`
不接受參數。
```bash curl theme={null}
curl https://api.4casters.io/user/getUnmatched \
-H "Authorization: Bearer YOUR_TOKEN"
```
回應
未成交訂單陣列，按開賽時間升序排列。
訂單 ID。
訂單建立的事務 ID。
`moneyline`、`spread`、`total` 或 `moneyline1x2`。
原始 `bet`（風險額）。
美式賠率。
出現在 `spread` 上。
出現在 `total` 上。
出現在 `moneyline` 和 `spread` 上 — 所支援的參賽方。
對方參賽方 ID（被掛出的一側）。
已被撮合的風險額。
原始掛單金額（已撮合 + 剩餘）。
該訂單上仍可成交的可贏金額（吃單方支付風險額以獲取）。
訂單已撮合的比例，介於 `0` 和 `1` 之間。
取消時間戳記（ISO 8601）。未設定過期時間時為 `null`。
ISO 8601 時間戳記。
`offer` 或 `wager`。
下單時保留的用戶端自定義識別碼。
伺服器生成的 ID，將原始下單請求產生的每一筆成交 / 掛單歸為一組。
始終為 `false`。
示例
```json JSON theme={null}
{
"data": {
"unmatched": [
{
"id": "62851e3bd54b74e52c39953c",
"txID": "62851e3bd54b74e52c39953b",
"type": "moneyline",
"bet": 100,
"odds": 165,
"spread": null,
"total": null,
"participantID": "6165e6e23c65e61a09bf1f73",
"otherParticipantID": "626dca8a83899580a06ba87e",
"filled": 0,
"offered": 100,
"remaining": 100,
"takenRatio": 0,
"expiry": "2022-05-18T23:08:00.000Z",
"createdAt": "2022-05-18T16:26:35.601Z",
"origin": "offer",
"graded": false,
"closed": false,
"adminRefund": false,
"game": {
"id": "62823d9d75d894042dfee218",
"league": "NHL",
"sport": "hockey",
"start": "2022-05-18T23:08:00.000Z",
"ended": false,
"eventName": "NEW YORK RANGERS VS CAROLINA HURRICANES",
"isFutures": false,
"participants": [/* ... */]
}
}
]
}
}
```
## OpenAPI
````yaml GET /user/getUnmatched
openapi: 3.1.0
info:
title: 4casters REST API
version: 1.0.0
description: >-
Public REST API for the 4casters peer-to-peer betting exchange. Use this API
to manage your account, query the orderbook and games, and place / edit /
cancel orders.
All responses (unless noted otherwise) are JSON envelopes of the form `{
"data": ... }`.
contact:
name: 4casters
url: https://4casters.io
servers:
- url: https://api.4casters.io
description: Production
security:
- bearerAuth: []
tags:
- name: Authentication
description: Login and account session management
- name: User
description: Read account info, bets, and orders
- name: Orders
description: Place, edit, look up, and cancel orders
- name: Markets
description: Browse leagues, games, participants, and orderbooks
- name: Affiliate
description: Affiliate / referral commission
paths:
/user/getUnmatched:
get:
tags:
- User
summary: Get unmatched orders
description: >-
Return all of the caller's open (unmatched) orders that are currently
resting on the exchange and available to be matched.
responses:
'200':
description: Unmatched orders list
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
unmatched:
type: array
items:
$ref: '#/components/schemas/UnmatchedOrder'
'401':
$ref: '#/components/responses/Unauthorized'
components:
schemas:
UnmatchedOrder:
type: object
description: An open order that is currently resting on the exchange.
properties:
id:
type: string
txID:
type: string
type:
$ref: '#/components/schemas/MarketType'
bet:
type: number
odds:
type: integer
spread:
type: number
nullable: true
total:
type: number
nullable: true
participantID:
type: string
description: Present for `moneyline` / `spread`.
otherParticipantID:
type: string
description: The opposite participant id (the one whose side is being offered).
expiry:
type: string
format: date-time
nullable: true
filled:
type: number
offered:
type: number
remaining:
type: number
takenRatio:
type: number
createdAt:
type: string
format: date-time
origin:
type: string
description: '`offer` or `wager`.'
graded:
type: boolean
closed:
type: boolean
adminRefund:
type: boolean
userReference:
type: string
wagerRequestID:
type: string
game:
$ref: '#/components/schemas/GameSummary'
MarketType:
type: string
enum:
- moneyline
- spread
- total
- moneyline1x2
description: >-
Market type. `moneyline1x2` is **soccer-only** (three-way money line:
home / away / draw).
GameSummary:
type: object
properties:
id:
type: string
league:
type: string
sport:
type: string
start:
type: string
format: date-time
ended:
type: boolean
eventName:
type: string
nullable: true
isFutures:
type: boolean
participants:
type: array
items:
$ref: '#/components/schemas/Participant'
Participant:
type: object
properties:
id:
type: string
longName:
type: string
shortName:
type: string
homeAway:
type: string
enum:
- home
- away
mainPitcher:
type: string
nullable: true
rotationNumber:
type: string
nullable: true
futuresSide:
type: string
nullable: true
score:
type: number
description: Final score; only present for ended games.
responses:
Unauthorized:
description: Missing or invalid auth token
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Pass your auth token in the `Authorization` header. The `Bearer` prefix
is optional; the server also accepts a signed `auth` cookie or a `token`
field in the request body.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.