API bộ trộn tiền mã hóa

Cách API bộ trộn hoạt động

1. Gọi POST /api/v1/mixes với coin, địa chỉ nhận và thời gian trễ từ 30 đến 1200 phút.
2. Gửi ít nhất mức tối thiểu đến send_to_address, rồi gọi /sent.
3. Coin được xác nhận on-chain. Thời gian trễ của bạn bắt đầu.
4. Khi hết thời gian trễ, coin mới được gửi đến địa chỉ nhận. Hãy truy vấn lượt trộn định kỳ cho đến khi trạng thái là complete.

URL gốc: https://bitcoinmix.io/api/v1. Đặc tả đầy đủ: OpenAPI 3.1. Thích dùng công cụ hơn HTTP? Hãy dùng MCP server bộ trộn tiền mã hóa.

Endpoint

Bắt đầu lượt trộn

Gửi JSON gồm coin, receiving_address và delay_minutes. Trường partner_code không bắt buộc, dùng để ghi nhận cho đối tác. Các trường không xác định sẽ bị từ chối.

curl -X POST https://bitcoinmix.io/api/v1/mixes \
  -H 'Content-Type: application/json' \
  -d '{
    "coin": "BTC",
    "receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
    "delay_minutes": 120
  }'

Phản hồi, đã rút gọn:

{
  "mix_id": "5f1c…64 hex characters…a9e0",
  "coin": "BTC",
  "status": "waiting_for_coins",
  "send_to_address": "bc1qgr7f3jfuzhpe45h3dnqxxjr3ml0de4ad2w3ysd",
  "receiving_address": "bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq",
  "minimum_amount": "0.0015",
  "delay_minutes": 120,
  "service_fee_percent": 3.36,
  "link_expires_at": "2026-10-17T14:49:04.943Z",
  "letter_of_guarantee": "…"
}

Theo dõi lượt trộn

# Coins sent: check the address now
curl -X POST https://bitcoinmix.io/api/v1/mixes/$MIX_ID/sent

# Follow the mix
curl https://bitcoinmix.io/api/v1/mixes/$MIX_ID

# Save the Letter of Guarantee
curl https://bitcoinmix.io/api/v1/mixes/$MIX_ID/letter > letter.txt

Coin, mức tối thiểu và số xác nhận

Phí dịch vụ được đặt ngẫu nhiên cho mỗi lượt trộn, từ 2.1% đến 5%, và có trong phản hồi khi lượt trộn được tạo. Bitcoin chấp nhận địa chỉ 1…, 3…, bc1q… và bc1p…. Chỉ hỗ trợ mainnet.

Lỗi

Mọi lỗi đều trả về JSON: { "error": { "code": "…", "message": "…" } }.

Giữ lượt trộn riêng tư

• Mix id là chìa khóa duy nhất của một lượt trộn. Đừng để nó xuất hiện trong log, URL bạn chia sẻ hay code công khai.
• Hãy gửi từ một địa chỉ do bạn tự quản lý để vẫn có thể hoàn tiền khi cần. Địa chỉ sàn giao dịch được nhiều người dùng chung.
• Lưu Thư bảo lãnh cho đến khi lượt trộn có trạng thái hoàn tất.

Câu hỏi thường gặp về API bộ trộn