> For the complete documentation index, see [llms.txt](https://docs.unibook.site/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unibook.site/zh/kai-fa-zhe-zhi-nan/quickstart.md).

# 快速接入

先用公开只读接口确认网络、市场和精度，再接签名交易。下面的请求不需要私钥，也不会创建订单或移动资金。

## 设置 API 地址

向运营方取得目标环境的 HTTPS API 基础地址，并设置 `DEXOS_API_URL`，末尾不要带 `/`。本页不预设测试网或主网域名；不同环境的钱包余额、签名域和市场可能不同。示例需要 Bash 和 curl。

```bash
: "${DEXOS_API_URL:?请设置目标环境的 API 基础地址}"
curl --fail-with-body --silent --show-error "$DEXOS_API_URL/v1/time"
curl --fail-with-body --silent --show-error "$DEXOS_API_URL/v1/exchange"
```

`/v1/time` 返回毫秒时间戳 `serverTime`。`/v1/exchange` 返回签名所需的 `chainId`、`domain`，以及入金系统地址、资产表、版本和数值约定。每个环境都应重新读取这些信息；不要把示例中的签名域或合约地址写死。

## 获取可交易市场

```bash
curl --fail-with-body --silent --show-error "$DEXOS_API_URL/v1/markets"
```

从结果选择一个 `symbol`，再运行：

```bash
: "${DEXOS_SYMBOL:?请设置市场列表中的 symbol}"
curl --fail-with-body --silent --show-error \
  "$DEXOS_API_URL/v1/markets/$DEXOS_SYMBOL"
curl --fail-with-body --silent --show-error \
  "$DEXOS_API_URL/v1/markets/$DEXOS_SYMBOL/book"
```

记录市场的 `priceDecimals`、`sizeDecimals`、`tickSize`、`lotSize`、`signingMarketId` 和交易状态。业务请求使用 `symbol`；`signingMarketId` 仅用于签名结构中的市场编号。价格、数量和金额用十进制字符串处理，避免经过浮点数。

## 查询自己的账户

已注册账户可使用公开只读接口查余额和下单 nonce。设置主钱包地址；查询不需要连接钱包。

```bash
: "${DEXOS_ADDRESS:?请设置自己的主钱包地址}"
curl --fail-with-body --silent --show-error --get \
  "$DEXOS_API_URL/v1/account" \
  --data-urlencode "address=$DEXOS_ADDRESS"
curl --fail-with-body --silent --show-error --get \
  "$DEXOS_API_URL/v1/account/nonce" \
  --data-urlencode "address=$DEXOS_ADDRESS"
```

地址不存在时可能返回 404；这不表示 API 离线。子账户查询加 `subaccount`，其中 `0` 表示主账户。金库账户查询改用 `vault`，与 `address`、`subaccount` 互斥。

## 接下来接交易

阅读[签名与授权](/zh/kai-fa-zhe-zhi-nan/authentication.md)，实现对应端点的 EIP-712 签名，然后在测试环境验证完整流程：获取 nonce → 签名 → 提交 → 检查业务回执 → 查询订单或成交。本文不提供未经验证的签名代码或可直接执行的资金写请求。

不要把 HTTP 200 一律当作成交成功。批量回执要逐项检查；HTTP 202 表示结果尚未返回，应查询 `requestId`，不要盲目重发。回执、分页和错误处理见 [REST API 使用约定](/zh/kai-fa-zhe-zhi-nan/rest-api.md)。