Kolmarket API 文档

欢迎使用 Kolmarket API！我们提供完整的 RESTful API 接口，帮助开发者集成 KOL 影响力资产交易功能。

快速集成

简单易用的 RESTful API，支持多种编程语言

安全可靠

企业级安全保障，支持 OAuth 2.0 和 API Key 认证

实时数据

实时市场数据和 WebSocket 推送服务

基础信息

API 基础地址: https://api.kolmarket.io/v1

WebSocket 地址: wss://ws.kolmarket.io/v1

支持格式: JSON

API 版本: v1.0

身份验证

Kolmarket API 支持两种身份验证方式：API Key 和 OAuth 2.0。

API Key 认证

在请求头中包含您的 API Key：

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     https://api.kolmarket.io/v1/kols

OAuth 2.0 认证

获取访问令牌：

POST /oauth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "scope": "read write"
}

请求限制

免费用户

1000 请求/小时
基础市场数据
KOL 基础信息

专业用户

10000 请求/小时
实时数据推送
高级分析数据
交易接口权限

GET

获取KOL列表

/api/v1/kols

获取平台上所有KOL的列表信息，支持分页和筛选。

请求参数

参数名	类型	必填	说明
page	integer	否	页码，默认为1
limit	integer	否	每页数量，默认20，最大100
platform	string	否	平台筛选：youtube, tiktok, instagram
category	string	否	分类筛选：tech, gaming, lifestyle等
sort	string	否	排序方式：followers, avm_score, price

响应示例

200 OK application/json

{
  "success": true,
  "data": {
    "kols": [
      {
        "id": "kol_001",
        "username": "TechReviewer",
        "display_name": "科技评测师",
        "avatar": "https://cdn.kolmarket.io/avatars/001.jpg",
        "platform": "youtube",
        "category": "tech",
        "followers": 1250000,
        "avm_score": 8.7,
        "token_symbol": "TECH",
        "token_price": 12.45,
        "price_change_24h": 5.2,
        "market_cap": 15600000,
        "verified": true,
        "created_at": "2024-01-15T10:30:00Z"
      },
      {
        "id": "kol_002",
        "username": "GameMaster",
        "display_name": "游戏大师",
        "avatar": "https://cdn.kolmarket.io/avatars/002.jpg",
        "platform": "twitch",
        "category": "gaming",
        "followers": 890000,
        "avm_score": 7.9,
        "token_symbol": "GAME",
        "token_price": 8.32,
        "price_change_24h": -2.1,
        "market_cap": 7400000,
        "verified": true,
        "created_at": "2024-01-10T14:20:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 156,
      "total_pages": 8
    }
  },
  "timestamp": "2024-01-15T12:00:00Z"
}

POST

创建交易订单

/api/v1/orders

创建新的买入或卖出订单。

请求体

{
  "token_symbol": "TECH",
  "order_type": "buy",
  "quantity": 100,
  "price": 12.45,
  "order_method": "limit"
}

响应示例

201 Created application/json

{
  "success": true,
  "data": {
    "order_id": "order_123456789",
    "token_symbol": "TECH",
    "order_type": "buy",
    "quantity": 100,
    "price": 12.45,
    "total_amount": 1245.00,
    "status": "pending",
    "created_at": "2024-01-15T12:00:00Z",
    "expires_at": "2024-01-15T12:30:00Z"
  },
  "message": "订单创建成功",
  "timestamp": "2024-01-15T12:00:00Z"
}

GET

获取NFT权益卡列表

/api/v1/nfts

获取平台上所有NFT权益卡的列表信息。

响应示例

200 OK application/json

{
  "success": true,
  "data": {
    "nfts": [
      {
        "token_id": "nft_001",
        "name": "TechReviewer 专属权益卡",
        "description": "持有此NFT可享受专属内容访问权限",
        "image": "https://cdn.kolmarket.io/nfts/001.jpg",
        "kol_id": "kol_001",
        "kol_name": "TechReviewer",
        "rarity": "legendary",
        "price": 0.5,
        "currency": "ETH",
        "benefits": [
          "专属视频内容",
          "月度直播互动",
          "产品评测优先权"
        ],
        "total_supply": 100,
        "remaining": 23,
        "auction_end": "2024-01-20T18:00:00Z",
        "highest_bid": 0.75,
        "created_at": "2024-01-15T10:00:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 45,
      "total_pages": 3
    }
  },
  "timestamp": "2024-01-15T12:00:00Z"
}

POST

计算AVM估值

/api/v1/avm/calculate

基于多维度数据计算KOL的AVM估值分数。

请求体

{
  "kol_id": "kol_001",
  "platform_data": {
    "followers": 1250000,
    "avg_views": 85000,
    "engagement_rate": 4.2,
    "content_quality_score": 8.5
  },
  "market_data": {
    "brand_collaborations": 15,
    "avg_deal_value": 25000,
    "market_sentiment": 0.75
  }
}

响应示例

200 OK application/json

{
  "success": true,
  "data": {
    "kol_id": "kol_001",
    "avm_score": 8.7,
    "score_breakdown": {
      "audience_value": 8.5,
      "content_quality": 8.8,
      "market_performance": 8.9,
      "engagement_strength": 8.6
    },
    "estimated_value": {
      "min": 12000000,
      "max": 18000000,
      "currency": "USD"
    },
    "confidence_level": 0.92,
    "last_updated": "2024-01-15T12:00:00Z",
    "next_update": "2024-01-16T12:00:00Z"
  },
  "timestamp": "2024-01-15T12:00:00Z"
}

错误代码

状态码	错误代码	说明
400	INVALID_REQUEST	请求参数无效
401	UNAUTHORIZED	未授权访问
403	FORBIDDEN	权限不足
404	NOT_FOUND	资源不存在
429	RATE_LIMIT_EXCEEDED	请求频率超限
500	INTERNAL_ERROR	服务器内部错误