Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,20 @@

## 2026-05-21

### Added

#### `POST /aster-chain/v3/transfer` — Transfer to Address / 转账至地址

A new WITHDRAW-authenticated endpoint for transferring assets to another registered Aster Chain user address. Returns `transferId`, `asset`, `amount`, `toAddress`, `timestamp`, and `status`.

#### STP Mode APIs / 自成交防止模式接口

- `POST /fapi/v3/stpMode` — Change STP Mode / 更改STP模式 (TRADE, weight 1)
- `GET /fapi/v3/stpMode` — Get Current STP Mode / 查询STP模式 (USER_DATA, weight 30)

Supports `EXPIRE_TAKER`, `EXPIRE_MAKER`, `EXPIRE_BOTH`. Added `stpMode` optional parameter to `POST /fapi/v3/order` for per-order STP override.


### Added

#### `POST /fapi/v3/stpMode` — Change STP Mode / 更改STP模式
Expand All @@ -20,6 +34,21 @@ Added `stpMode` (ENUM, optional) to the place-order parameter list. When specifi

---

## 2026-05-20

### Added

#### Strategy Order APIs / 策略订单接口

- `POST /fapi/v3/placeStrategyOrder` — Place Strategy Order / 策略下单
- `POST /fapi/v3/updateStrategyOrder` — Update Strategy Order / 更新策略订单
- `GET /fapi/v3/strategyOrder` — Query Strategy Open Order / 查询策略当前挂单
- `GET /fapi/v3/strategyOrder/history` — Query Strategy History Order / 查询策略历史订单

Supports OTO, OCO, and OTOCO strategy types.

---

## 2026-05-19

### Added
Expand Down
94 changes: 94 additions & 0 deletions V3(Recommended)/EN/aster-chain.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,94 @@
# Aster-Chain API Overview

* This document lists the base URL for the API endpoints: **https://chainapi.asterdex.com**
* All API responses are in JSON format.

---

- [Aster-Chain Account Endpoints](#aster-chain-account-endpoints)
- [Get Account Status (USER_DATA)](#get-account-status-user_data)
- [Modify Account Status (TRADE)](#modify-account-status-trade)
- [Transfer to Address (WITHDRAW)](#transfer-to-address-withdraw)

---

# Aster-Chain Account Endpoints

## Get Account Status (USER_DATA)

> **Response:**

```javascript
{
"status": "PRIVATE" // "PUBLIC" or "PRIVATE"
}
```

`GET /aster-chain/v3/account/status`

Get the current account's privacy status.

**Weight:** 1

**Parameters:**

None

---

## Modify Account Status (TRADE)

> **Response:**

```javascript
{
"status": "PRIVATE" // "PUBLIC" or "PRIVATE"
}
```

`POST /aster-chain/v3/account/modify-status`

Modify the account's privacy status. After a successful update, the change is broadcast to the Aster Chain.

**Weight:** 5

**Parameters:**

| Name | Type | Mandatory | Description |
|------|------|-----------|-------------|
| status | STRING | YES | Account privacy mode: `"PUBLIC"` or `"PRIVATE"` |

---

## Transfer to Address (WITHDRAW)

> **Response:**

```javascript
{
"transferId": "123456789",
"asset": "USDT",
"amount": "10.00",
"toAddress": "0xAbCd1234...",
"timestamp": 1699900800000,
"status": "SUCCESS" // "SUCCESS" or "PENDING"
}
```

`POST /aster-chain/v3/transfer`

Transfer assets to another Aster Chain address. The recipient address must belong to a registered Aster Chain user.

**Weight:** 50

**Parameters:**

| Name | Type | Mandatory | Description |
|------|------|-----------|-------------|
| asset | STRING | YES | Asset name to transfer (e.g. `"USDT"`) |
| amount | DECIMAL | YES | Transfer amount, must be greater than 0 |
| toAddress | STRING | YES | Recipient's Aster Chain wallet address |
| clientTranId | STRING | NO | Client-defined transfer ID; auto-generated if not provided |
| nonce | LONG | YES | Microsecond timestamp |
| user | STRING | YES | Source account wallet address |
| signature | STRING | YES | EIP-712 signature, signed with the `user` account's wallet private key |
Loading