Mọi pool HeroMiners đều trả lời cùng một bộ endpoint HTTP chỉ đọc. Không cần khóa, không cần tài khoản và không cần đăng ký: gửi yêu cầu tới một URL và bạn nhận lại JSON, với Access-Control-Allow-Origin: * được đặt sẵn để một trang trong trình duyệt có thể gọi trực tiếp. Hãy dùng nó để xây dựng công cụ theo dõi dàn máy (rig), công cụ báo thanh toán, bảng điều khiển của riêng bạn, hoặc để đưa dữ liệu pool vào bảng tính.
Mỗi coin có pool riêng với số liệu riêng và định dạng địa chỉ riêng, vì vậy hãy chọn coin trước rồi nhập địa chỉ của chính coin đó. Những gì bạn nhập ở đây không được gửi đi đâu ngoài chính pool, và chỉ khi bạn nhấn Chạy.
URL gốc
https://alephium.herominers.com
Endpoint
GET/api/stats
Mọi thông tin pool biết về chính nó ngay lúc này: hashrate của pool và của mạng, số thợ đào và worker đang kết nối, khối gần nhất, phí, cổng và thiết lập thanh toán.
Tham số truy vấn
address
Một địa chỉ nhận thanh toán. Thêm thợ đào đó dưới miner, và dưới solo_miner nếu họ cũng đào solo. Bỏ qua tham số này thì không khóa nào trong hai khóa đó được gửi.
Đây là endpoint nên bắt đầu. Trang pool, trang thợ đào và mọi biểu đồ trên trang này đều được xây dựng từ nó.
Yêu cầu
curl "https://alephium.herominers.com/api/stats"
Phản hồi
Một đối tượng gồm pool, network, config, charts, lastblock, payments và visitors, tức số người đang ở trên trang lúc này, dưới dạng { windowMinutes, activeVisitors, activeLookups }. Được tính lại mỗi chu kỳ thống kê một lần, nên hỏi nhanh hơn thế sẽ chỉ nhận lại cùng các số liệu.
GET/api/live_stats
Cùng nội dung như /api/stats, nhưng được giữ mở cho đến khi chu kỳ thống kê tiếp theo hoàn tất rồi mới trả lời. Mỗi lần cập nhật chỉ cần một yêu cầu thay vì hỏi định kỳ theo bộ hẹn giờ.
Tham số truy vấn
address
Đưa một thợ đào vào nội dung trả về, giống như với /api/stats.
Mở một kết nối và mở lại khi nó trả lời. Nhiều kết nối mở cùng lúc từ cùng một IP sẽ bị từ chối với mã 503, vì vậy đừng mở song song nhiều kết nối.
Cùng cấu trúc như /api/stats, ngoại trừ miner và solo_miner luôn được gửi, để trống khi không có địa chỉ nào được cung cấp. Yêu cầu được giữ mở tối đa một chu kỳ thống kê.
GET/api/stats_address
Một thợ đào: hashrate hiện tại và trung bình, share hợp lệ và share cũ (stale), số dư, số tiền đã trả, và các số liệu tương tự cho từng worker.
Nhập address ở trên để chạy yêu cầu này. Lệnh có hiển thị trường đó vì pool sẽ trả về lỗi nếu thiếu nó.
Phản hồi
Một đối tượng gồm stats (tổng số liệu của thợ đào), payments, charts, unlocked và workers, một mảng có một phần tử cho mỗi worker, được đặt tên theo name của nó. Một địa chỉ chưa từng đào ở đây sẽ nhận về lỗi thay vì một thợ đào trống.
GET/api/get_blocks
Các khối pool đã tìm được và không còn ở trạng thái chờ: đã thanh toán, hoặc đã thành khối mồ côi (orphan). status cho biết là loại nào.
Tham số truy vấn
heightbắt buộc
Trả về các khối có độ cao thấp hơn giá trị này. Truyền một số lớn hơn nhiều so với đỉnh chuỗi để lấy trang mới nhất, rồi truyền độ cao thấp nhất bạn đã nhận để lùi về các trang trước.
Địa chỉ người tìm được che bớt trước khi rời khỏi pool, vì vậy không thể dùng endpoint này để thu thập địa chỉ. time tính bằng giây Unix, reward tính bằng đơn vị nhỏ nhất của coin, và một khối solo mang score là s0 khi đã được thanh toán hoặc s1 khi đã thành khối mồ côi.
Các khoản thanh toán pool đã gửi, cho toàn pool hoặc cho một địa chỉ.
Tham số truy vấn
timebắt buộc
Trả về các khoản thanh toán trước dấu thời gian Unix này, tính bằng giây. Dùng thời gian hiện tại để lấy trang mới nhất, rồi dùng dấu thời gian cũ nhất bạn đã nhận để lùi về các trang trước.
address
Giới hạn ở một địa chỉ nhận thanh toán. Bỏ qua để lấy mọi khoản thanh toán pool đã thực hiện.
limit
Số lượng cần trả về. Bị giới hạn ở kích thước trang của chính pool, nên một số lớn hơn sẽ chỉ trả về chừng đó.
format
Truyền parsed để nhận các đối tượng { tx, amount, time } thay vì mảng thô.
conversions
Khi có address, truyền 1 để nhận thêm bản ghi quy đổi của mọi khoản thanh toán trên trang đã được quy đổi sang coin khác. Khi đó nội dung trả về trở thành { payments, conversions }. Bị bỏ qua khi dùng format=parsed.
Khi không có format, đây là một mảng phẳng xen kẽ giá trị và dấu thời gian, mỗi giá trị có dạng txid:amount. Số tiền là chuỗi tính bằng đơn vị nhỏ nhất của coin và phải giữ nguyên là chuỗi: chuyển nó thành số sẽ mất độ chính xác trên chuỗi khối có 18 chữ số thập phân.
GET/api/get_miners_stats
Mười thợ đào lớn nhất trên pool, cùng với phân bố theo phần mềm đào và theo khu vực đứng sau trang thợ đào.
Một đối tượng gồm miners, agents, regions, regionHistory và statsDisplay. Các địa chỉ được che bớt. Khi một bảng không được bật, mảng của nó trả về rỗng và statsDisplay cho biết điều đó.
GET/api/get_blocks_search
Tìm khối của pool theo độ cao, hash khối hoặc địa chỉ người tìm, trên cả khối đang chờ lẫn khối đã thanh toán cùng một lúc.
Tham số truy vấn
qbắt buộc
Một độ cao, một hash khối hoặc một địa chỉ.
offset
Bỏ qua chừng này kết quả. Nội dung trả về có hasMore để bạn biết có cần hỏi tiếp hay không.
Việc tìm kiếm bị giới hạn tần suất theo IP, và vượt quá giới hạn sẽ trả về rateLimited kèm thời gian chờ chính xác trong retryMs thay vì chỉ một lỗi. Hãy gọi /api/get_blocks_search_config trước để biết giới hạn độ dài và liệu tính năng tìm kiếm có được bật hay không.
Nhập q ở trên để chạy yêu cầu này. Lệnh có hiển thị trường đó vì pool sẽ trả về lỗi nếu thiếu nó.
Phản hồi
Một đối tượng gồm pending và matured, cả hai đều xen kẽ giá trị và độ cao giống như /api/get_blocks, cùng với totalMatched, offset, limit và hasMore. Một khối matured có định dạng của /api/get_blocks; một khối pending vẫn đang chờ đáo hạn và dùng định dạng chờ dài hơn, nên các trường của nó theo thứ tự khác.
GET/api/get_blocks_search_config
Tính năng tìm khối có được bật hay không, và các giới hạn mà một truy vấn phải nằm trong đó, để có thể thiết lập ô tìm kiếm trước lần tìm đầu tiên.
{ enabled, minQueryLength, maxQueryLength, frontendCooldownMs }. Độ dài tính bằng ký tự, và frontendCooldownMs là thời gian cần chờ giữa hai lần tìm kiếm.
GET/api/get_miner_payout_level
Ngưỡng thanh toán hiện đang được đặt cho một địa chỉ, tính bằng coin nguyên.
Tham số truy vấn
addressbắt buộc
Địa chỉ nhận thanh toán.
Endpoint tương ứng /api/set_miner_payout_level dùng để ghi giá trị này, và không phải ai cũng dùng được: yêu cầu phải đến từ chính IP đào của địa chỉ đó. Việc kiểm tra đó, và giới hạn tần suất đi kèm, được mô tả ở tab cài đặt của bảng điều khiển thay vì ở đây.
Nhập address ở trên để chạy yêu cầu này. Lệnh có hiển thị trường đó vì pool sẽ trả về lỗi nếu thiếu nó.
Phản hồi
{ banned, minerMessage }, và khi bị chặn thì có thêm blockMining, blockPayments và reason. Đây là thông báo mà trang thợ đào hiển thị cho địa chỉ này: bị chặn đào, bị chặn nhận thanh toán, hoặc không bị chặn. minerMessage là tin nhắn của nhà vận hành gửi tới địa chỉ này, dưới dạng { message, type, createdAt, expiresAt }, hoặc null khi không có.
Dùng cho hiệu quả
Hỏi theo đúng nhịp của pool. Các số liệu được tính lại mỗi chu kỳ thống kê một lần, và config.updateInterval trong phản hồi của /api/stats cho biết chu kỳ đó dài bao nhiêu giây. Hỏi thường xuyên hơn thế sẽ chỉ nhận lại cùng một câu trả lời và tốn băng thông của cả hai bên.
Ưu tiên /api/live_stats thay vì bộ hẹn giờ nhanh. Nó trả lời ngay khi có dữ liệu mới, vừa nhanh hơn cho bạn vừa nhẹ hơn cho pool so với hỏi định kỳ.
Giữ số tiền ở dạng chuỗi. Phần thưởng và số dư được trả về bằng đơn vị nhỏ nhất của coin. Trên chuỗi khối có 18 chữ số thập phân, các số nguyên đó vượt quá mức mà một số JavaScript có thể biểu diễn chính xác, nên chuyển chúng thành số sẽ âm thầm làm tròn một khoản thanh toán.
Địa chỉ sẽ bị che bớt. Các danh sách công khai ẩn phần giữa của mọi địa chỉ. Địa chỉ đầy đủ của bạn chỉ có bạn cần đến, và chỉ ở nơi bạn tự cung cấp nó.
Coi giới hạn tần suất là lệnh chờ, không phải lỗi. Ở nơi có áp dụng giới hạn, phản hồi sẽ có retryMs. Hãy chờ đúng khoảng thời gian đó rồi thử lại, thay vì gửi yêu cầu dồn dập.
Cho chúng tôi biết bạn là ai. Một User-Agent ghi tên công cụ của bạn không bắt buộc, nhưng nhờ đó chúng tôi có thể báo cho bạn khi có thay đổi thay vì để bạn phải đoán cái gì bị hỏng.