Skip to main content
POST
/
api
/
v1
/
auth
/
offers
curl --request POST \
  --url https://crypto.westminister.tech/api/v1/auth/offers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "vendor_id": "5c81c005-1c52-4e0d-85e2-862ee1cdd4d0",
  "offer_type": "SELL",
  "asset": "USDT",
  "usdt_amount": "7999.99",
  "available_amount": "8000.00",
  "rate": "141.00",
  "min_order": "10",
  "max_order": "1500.00",
  "status": "active",
  "description": "Ethereum on-ramp offer - instant USDT delivery"
}
'
{
  "id": "7c9a9311-7e7d-4739-9abc-34f7db00ff19",
  "vendor_id": "5c81c005-1c52-4e0d-85e2-862ee1cdd4d0",
  "offer_type": "SELL",
  "asset": "USDT",
  "usdt_amount": "7999.99000000",
  "available_amount": "8000.00000000",
  "rate": "141.00",
  "min_order": "10.00000000",
  "max_order": "1500.00000000",
  "status": "active",
  "description": {
    "String": "Ethereum on-ramp offer - instant USDT delivery",
    "Valid": true
  },
  "created_at": "2025-12-12T10:30:00.000000Z",
  "updated_at": "2025-12-12T10:30:00.000000Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
vendor_id
string<uuid>
required
​
offer_type
enum<string>
required

SELL = Merchant sells USDT (on-ramp), BUY = Merchant buys USDT (off-ramp)

Available options:
SELL,
BUY
​
asset
string
required
​
usdt_amount
string
required
​
available_amount
string
required
​
rate
string
required

Exchange rate - KES per USDT

​
min_order
string
required
​
max_order
string
required
​
status
string

Optional: defaults to 'active' if omitted

​
description
string

Response

201 - application/json

Offer created

​
id
string<uuid>

Offer ID.

​
vendor_id
string<uuid>

Vendor ID.

​
offer_type
enum<string>

Offer type.

Available options:
SELL,
BUY
​
asset
string

Asset symbol (e.g.

​
usdt_amount
string

Offer amount in USDT.

​
available_amount
string

Available amount.

​
rate
string

Exchange rate (KES per USDT).

​
min_order
string

Minimum order size.

​
max_order
string

Maximum order size.

​
status
string

Offer status.

​
description
object
​
created_at
string<date-time>
​
updated_at
string<date-time>
​
deleted_at
object

Database-style nullable time wrapper