按币种获取文章列表

HTTP request 分页获取与指定币种关联的 Web3 内容列表。

• GET /api/v3/content/articles/listByCoin

权重(IP): 1

请求头

请求头	是否必须	描述
locale	否	内容语言，默认 en_US。可选值：ar_AR、az_AZ、de_DE、en_US、es_419、es_AR、es_ES、fa_IR、fr_FR、in_ID、it_IT、ja_JP、pl_PL、pt_BR、pt_PT、ru_RU、uk_UK、vi_VN、zh_CN、zh_TW。

请求参数

参数名	类型	是否必须	适用板块	描述
section	String	是	全部	内容板块：wiki、news、learn、questions。
symbol	String	条件必填	全部	币种符号，例如 BTC；与 slug 至少传一个。
slug	String	条件必填	全部	币种 slug，例如 btc；与 symbol 至少传一个。
startEnableDate	String	否	news	enabledDate 区间起始值（含），支持 Unix 秒或毫秒时间戳；其他板块忽略。
endEnableDate	String	否	news	enabledDate 区间结束值（含），支持 Unix 秒或毫秒时间戳；不传时结果默认不超过当前时间，其他板块忽略。
withCount	Boolean	否	全部	是否返回总数和总页数，默认 false。
page	Integer	否	全部	页码，从 1 开始，默认 1。
pageSize	Integer	否	全部	每页数量，默认 25，最大 200。
populateThumbnail	Boolean	否	wiki、news、learn	是否返回 thumbnail，默认 false；questions 板块忽略。
populateTagLists	Boolean	否	全部	是否返回 tagLists，默认 false。
populateCoins	Boolean	否	全部	是否返回 coinsMaps，默认 false。

请求示例

curl "https://api-spot.weex.com/api/v3/content/articles/listByCoin?section=learn&symbol=BTC&page=1&pageSize=10&withCount=true&populateThumbnail=true&populateTagLists=true&populateCoins=true" \
   -H "ACCESS-KEY:*******" \
   -H "ACCESS-SIGN:*******" \
   -H "ACCESS-PASSPHRASE:*****" \
   -H "ACCESS-TIMESTAMP:1659076670000" \
   -H "locale: en_US" \
   -H "Content-Type: application/json"

返回参数

字段名	类型	描述
total	Long	总记录数。withCount=false 时可能为 null。
page	Integer	当前页码。
pageSize	Integer	每页数量。
pages	Integer	总页数。withCount=false 时可能为 null。
hasNextPage	Boolean	是否存在下一页。
items	ArticleListItem[]	文章列表，字段定义请参见获取文章列表。

列表不返回文章正文。每条记录固定包含获取文章列表中定义的 30 个 ArticleListItem 字段；不适用于当前 section 的字段返回 null，不会省略。

返回示例

{
  "total": 154,
  "page": 1,
  "pageSize": 10,
  "pages": 16,
  "hasNextPage": true,
  "items": [
    {
      "id": 1714,
      "documentId": "vvcry6rt2d8bt5e4kgaaxkv7",
      "v4Id": null,
      "section": "learn",
      "title": "什么是比特币？",
      "summary": null,
      "level": "Beginner",
      "contentKey": "learn-bitcoin",
      "titleEn": "What Is Bitcoin?",
      "thumbnail": null,
      "tagLists": [],
      "coinsMaps": [
        {
          "id": 1,
          "documentId": "btc-coin-map",
          "slug": "btc",
          "symbol": "BTC",
          "name": "Bitcoin",
          "icon": "https://example.com/btc.png",
          "type": "Tokens",
          "locale": "en_US"
        }
      ],
      "publishedAt": 1780993501641,
      "createdAt": 1780993356022,
      "updatedAt": 1780993519507
    }
  ]
}