API cho nhà phát triển

REST v1

Dữ liệu thị trường CryptoJam qua REST API.

Tiền mã hóa

Giá USD, vốn hóa và khối lượng giao dịch.

GET/api/v1/developer/coins

Tham số yêu cầu

Tham số	Kiểu	Mô tả
`page`	integer	Số trang, bắt đầu từ 1
`pageSize`	integer	Số kết quả, 1–250
`search`	string	Tên hoặc ký hiệu đồng tiền
`sort`	string	rank, price, marketCap, volume24h, change24h
`order`	string	asc hoặc desc

Trường phản hồi và phân trang

Phản hồi chứa data và meta. Các trường chính: id, slug, name, symbol, rank, priceUsd, change24h, marketCapUsd, volume24h, updatedAt và source. Giá không khả dụng là null. Kích thước trang mặc định là 50. Ký hiệu không duy nhất: hãy dùng id hoặc slug.

Lịch sử giá

Giá được lưu trữ của một loại tiền mã hóa cụ thể.

GET/api/v1/developer/history/{slug}

Tham số yêu cầu

Tham số	Kiểu	Mô tả
`range`	string	24h, 7d, 30d, 90d, 1y, all, max
`from / to`	string	Khoảng tùy chỉnh, ISO 8601
`granularity`	string	1d hoặc tick

Phạm vi lịch sử và nguồn

Mỗi điểm chứa timestamp, priceUsd và các chỉ số bổ sung có sẵn. Ngày giờ dùng UTC. Khoảng all là toàn bộ lịch sử lưu trữ cục bộ; ngày bắt đầu có thể khác ngày ra mắt đồng tiền.

Kiểm tra meta.coverageStart, meta.coverageEnd, meta.source, meta.gaps, meta.truncated và meta.isDemo. Yêu cầu khoảng ngắn hơn khi phản hồi bị cắt. Giá USD và USDT được lưu riêng.

Về dữ liệu thị trường

Ủy quyền và ví dụ yêu cầu

Gửi khóa trong tiêu đề X-API-Key. Giữ khóa trên máy chủ ứng dụng.

curl -H "X-API-Key: YOUR_API_KEY" \
  "https://cryptojam.net/api/v1/developer/history/bitcoin?range=30d"

market:readDanh mục tiền mã hóahistory:readLịch sử giá

Thử yêu cầu

OpenAPI

Cấu trúc mẫuJSON

{
  "data": [
    {
      "timestamp": "2025-01-01T00:00:00.000Z",
      "priceUsd": 93429.20,
      "source": "coingecko"
    }
  ],
  "meta": {
    "source": "coingecko",
    "coverageStart": "2025-01-01T00:00:00.000Z",
    "gaps": [],
    "isDemo": false
  }
}

Khóa API của tôi

Đăng nhập để tạo khóa

Quản lý quyền truy cập dữ liệu thị trường và lịch sử.

Tiếp tục bằng email

hoặc

Tạo tài khoản

Điều khoản·Quyền riêng tư

Liên hệ [email protected]

Truy cập và giới hạn

Truy cập bị hạn chế

Việc cung cấp dữ liệu hiện bị tắt. Yêu cầu trả về 503; vẫn có thể tạo khóa.

Chi tiết truy cập và lỗi

Việc cung cấp dữ liệu được bật sau khi xác nhận quyền phân phối lại của nhà cung cấp. CoinGecko là nhà cung cấp được phép theo mặc định. Dữ liệu Coin Metrics Community không được đưa vào API cho nhà phát triển.

Hạn mức hằng ngày dùng UTC. Giới hạn và số yêu cầu còn lại được hiển thị trong X-RateLimit-Limit và X-RateLimit-Remaining.

400: Tham số không hợp lệ
401: Thiếu khóa hoặc khóa không hợp lệ
403: Không đủ quyền
404: Không tìm thấy tài nguyên
429: Vượt giới hạn yêu cầu
503: Dữ liệu không khả dụng

Lỗi chứa code và message trong đối tượng error. Sau phản hồi 429, tuân theo tiêu đề Retry-After nếu có.

Liên hệ [email protected]