Chuyển tới nội dung chính

Cognivo Developer API

Cognivo Developer API cho phép bạn gọi chính trí tuệ on-chain đang vận hành Cognivo Chat, dApp và bot Telegram từ ứng dụng, bot, bảng điều khiển hoặc backend của riêng bạn.

  • Base URL: https://api.cognivolabs.io
  • Xác thực: các API key phân quyền theo scope mà bạn tự tạo trong cổng nhà phát triển
  • Các chain đang hoạt động hiện nay: Ethereum (eth), Base (base), BNB Smart Chain (bsc)
  • Solana: sắp ra mắt (chưa hoạt động)
  • Webhooks: đã lên kế hoạch (chưa hoạt động)
  • Đặc tả OpenAPI: cognivo-public-api.yaml - đặc tả đầy đủ mà máy đọc được; nhập vào Postman, Insomnia hoặc trình sinh SDK

Tôi có thể xây dựng gì?​

Bất cứ thứ gì cần một cách đọc nhanh và trung thực về một token hoặc một ví. Một vài ý tưởng cụ thể:

  • Bot kiểm tra độ an toàn của token - một bot nơi người dùng dán địa chỉ hợp đồng và nhận lại tín hiệu rủi ro, bối cảnh thanh khoản và khóa, cùng câu trả lời "vì sao token giảm giá" trong một tin nhắn
  • Bảng điều khiển giám sát ví - theo dõi một ví ngân quỹ, cá voi hoặc ví đội ngũ: mức phơi nhiễm approval, các dịch chuyển gần đây chính xác, PnL đã hiện thực hóa theo từng token
  • Công cụ cộng đồng cho Telegram hoặc Discord - cung cấp cho cộng đồng của bạn lệnh /check <token> được hỗ trợ bởi chính trí tuệ đang vận hành Cognivo Chat
  • Giao diện PnL danh mục - hiển thị cho người dùng lãi lỗ đã hiện thực hóa theo từng token, tính từ hoạt động on-chain có căn cứ thay vì các con số tự khai
  • Notebook nghiên cứu - kéo dữ liệu rủi ro, thanh khoản, ví đội ngũ và dịch chuyển vào notebook Python hoặc JavaScript để nghiên cứu token và phân tích hậu sự cố
  • Nguồn cấp khám phá - đưa các thẻ trí tuệ công khai chất lượng cao gần đây từ nguồn cấp Discover vào ứng dụng hoặc trang web của riêng bạn

API này không phải là gì​

  • Nó không phải quyền truy cập node/RPC thô. Bạn luôn gọi các endpoint trí tuệ được Cognivo tuyển chọn; RPC chain thô không bao giờ bị lộ ra hay bán lại.
  • Nó không bao gồm giao dịch, thực thi lệnh hay công cụ MEV.
  • Kết quả là các tín hiệu trí tuệ, không phải lời khuyên tài chính và không phải một sự bảo đảm. Kết quả sạch không bao giờ có nghĩa là "an toàn".

Mô hình truy cập và giá​

Live key hoạt động theo mô hình tự phục vụ và trả theo mức dùng (pay-as-you-go). Tạo một key và nó hoạt động ngay lập tức: không cần đơn đăng ký, không có hàng đợi phê duyệt, không phải gọi cho bộ phận bán hàng. Mỗi lệnh gọi thành công được tính bằng tín dụng Cognivo, trừ từ số dư tín dụng của tài khoản bạn theo giá đã công bố cho từng endpoint; các lệnh gọi thất bại không bao giờ bị tính phí.

  • Live key (cogv_live_) là cách tiêu chuẩn để dùng API. Chúng được tính phí trả theo mức dùng từ chính số dư tín dụng Cognivo mà bạn dùng ở những nơi khác. Nếu số dư không đủ cho một lệnh gọi, bạn nhận lỗi 402 với mã payment_required và không có gì bị tính phí: nạp thêm trên trang thanh toán của tài khoản Cognivo và thử lại.
  • Sandbox key (cogv_test_) được ghi nhãn rõ ràng là Sandbox và chỉ tồn tại cho các demo giới hạn và kiểm thử tích hợp. Chúng không thể chạy trí tuệ trực tiếp.
  • Trial là một hạn mức đánh giá tùy chọn do quản trị viên cấp. Bạn không bao giờ cần nó cho việc sử dụng trả phí thông thường.
  • Partner là một thỏa thuận do quản trị viên quản lý.
  • Enterprise là con đường duy nhất mà bạn phải yêu cầu quyền truy cập: giá tùy chỉnh, giới hạn tùy chỉnh và khối lượng lớn. Yêu cầu từ cổng nhà phát triển.
  • Một key bị đình chỉ (suspended) không thể thực thi bất cứ thứ gì; cổng nhà phát triển hiển thị lý do.

Giá tín dụng theo từng endpoint được công bố trên các trang Tham chiếu endpoint và Giới hạn tốc độ, lỗi và tính phí. GET /v1/api/health miễn phí và không cần key, GET /v1/api/me miễn phí với bất kỳ key hợp lệ nào, và GET /v1/api/discover miễn phí với giới hạn tốc độ chặt.

Quyền riêng tư và an toàn dữ liệu​

API chỉ trả về trí tuệ on-chain công khai. Các phản hồi không bao giờ chứa định danh tài khoản Cognivo, email, số dư hay dữ liệu tài khoản riêng tư khác - của bạn hay của bất kỳ ai. Ngoại lệ duy nhất là GET /v1/api/me, cho key đang gọi thấy số dư tín dụng của chính tài khoản nó, để bạn theo dõi mức chi tiêu.

Bắt đầu​

  1. Đăng nhập tại dapp.cognivolabs.io/en/developers bằng tài khoản Cognivo thông thường của bạn.
  2. Tạo một dự án và một live API key (key đầy đủ chỉ được hiển thị đúng một lần - hãy sao chép ngay). Nó hoạt động ngay lập tức.
  3. Làm theo Khởi động nhanh - lệnh gọi đầu tiên của bạn trong 30 giây.