Skip to content

Lock Order

Endpoint Information

Endpoint: POST /api/v1/orders/lock

Description: Lock order for filling

Authentication: API Key credential authentication

Request Parameters

FieldTypeRequiredDescription
order_hashstringYesOrder hash
taker_addressstringYesTaker address

Response Parameters

FieldTypeDescription
successbooleanWhether lock succeeded
order_hashstringOrder hash
locked_bystringLocked by
locked_atstringLock time
expires_atstringLock expiration time

Request Example

bash
curl -X POST "/api/v1/orders/lock" \
     -H "X-API-Key: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "order_hash": "0x1234567890abcdef...",
       "taker_address": "0xabcdef1234567890..."
     }'

Response Example

json
{
    "code": 0,
    "data": {
        "success": true,
        "order_hash": "0x1234567890abcdef...",
        "locked_by": "0xabcdef1234567890...",
        "locked_at": "2025-01-17T03:00:24Z",
        "expires_at": "2025-01-17T04:00:24Z"
    }
}

Notes

  • After locking, other Takers cannot operate on this order
  • Lock has time limit, automatically unlocks after expiration
  • Order filling operations can be performed during lock period