Orders
Создание, отмена и просмотр ордеров. Требуется L2 авторизация.
POST /order
Размещает новый ордер в книге заявок. Ордер должен быть подписан вашим приватным ключом. Поля makerAmount/takerAmount задают соотношение цены (например, 100/65 = покупка по 0.65). На практике используйте SDK, который формирует и подписывает ордер автоматически.
{
"order": {
"salt": 123456789,
"maker": "0xYourAddress...",
"signer": "0xSignerAddress...",
"taker": "0x0000000000000000000000000000000000000000",
"tokenId": "71321...",
"makerAmount": "100000000",
"takerAmount": "65000000",
"expiration": 0,
"nonce": 0,
"feeRateBps": 0,
"side": "BUY",
"signatureType": 2,
"signature": "0x..."
},
"owner": "0xYourAddress...",
"orderType": "GTC"
}
Order Types
| Тип | Описание |
|---|---|
GTC | Good Till Cancel — активен до отмены |
GTD | Good Till Date — активен до даты |
FOK | Fill Or Kill — исполнить полностью или отменить |
DELETE /order
Отменяет конкретный ордер по его ID. Используйте для отмены отдельных заявок без влияния на остальные. ID ордера возвращается при создании и в списке ордеров.
{"orderID": "0x123..."}
DELETE /cancel-all
Отменяет все активные ордера пользователя. Полезно для экстренного выхода из рынка или перед перезапуском торговой стратегии. Можно ограничить отмену конкретным рынком через параметры.
GET /orders
Возвращает список ордеров пользователя с возможностью фильтрации по рынку, токену и статусу. Используйте для мониторинга активных заявок и истории исполнения.
| Параметр | Описание |
|---|---|
market | Condition ID рынка |
asset_id | Token ID |
state | LIVE, MATCHED, CANCELLED |
GET /trades
Возвращает историю исполненных сделок пользователя. Каждая запись содержит цену, объём, комиссию и timestamp. Используйте для расчёта P&L, аудита и налоговой отчётности.
Рекомендации
Для работы с ордерами рекомендуется использовать официальные SDK:
• py-clob-client (Python)
• clob-client (TypeScript)