---
updatedAt: 2026-06-02T20:06:00.000Z
agentTools:
  projectIndex: https://docs.zerohash.com/llms.txt
---

# List news articles

Retrieves a list of market news articles filtered using given parameters.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "zerohash API",
    "description": "\n### Authentication\n\nzerohash Uses HMAC SHA-256 verification to ensure the authenticity of API requests, follow instructions by link [https://docs.zerohash.com/reference/api-authentication](https://docs.zerohash.com/reference/api-authentication)\n\n<a href=\"/zh-swagger.json\">Download zerohash OpenAPI Schema as JSON</a>\n",
    "version": "1.7.0"
  },
  "servers": [
    {
      "url": "https://api.cert.zerohash.com",
      "description": "Certification API server"
    }
  ],
  "x-readme": {
    "proxy-enabled": false
  },
  "tags": [
    {
      "name": "Market Data",
      "description": "Market Data Services"
    }
  ],
  "paths": {
    "/market_data/news/latest": {
      "get": {
        "tags": [
          "Market Data"
        ],
        "summary": "List news articles",
        "description": "Retrieves a list of market news articles filtered using given parameters.",
        "parameters": [
          {
            "$ref": "#/components/parameters/Signature"
          },
          {
            "$ref": "#/components/parameters/Timestamp"
          },
          {
            "name": "news_source",
            "in": "query",
            "description": "Sources (feeds) of news articles, options can be fetched from the response of `GET /news/feeds` endpoint.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "coindesk",
                "coindesk_es",
                "bitcoinmagazine",
                "coingape",
                "blockworks",
                "dailyhodl",
                "cryptoslate",
                "decrypt",
                "cryptopotato",
                "cryptobriefing",
                "theblock",
                "bitcoin.com",
                "newsbtc",
                "utoday",
                "bitcoinist",
                "coinpedia",
                "crypto_watch_com_br",
                "coinrepublic",
                "chaintimes",
                "ambcrypto_es",
                "cryptonewsreview",
                "ccn",
                "financemagnates",
                "espaciobit",
                "cointelegraph_fr",
                "ethnews.com",
                "cryptovest",
                "cryptoinsider",
                "coinspeaker",
                "coinjoker",
                "cointelligence",
                "okexinsights",
                "cryptocoremedia",
                "bitcoinerx",
                "criptonoticias",
                "weisscrypto",
                "cryptonaute",
                "coinpaprika",
                "cointurken",
                "coinpaper",
                "bloomberg_crypto_",
                "thecryptobasic",
                "coinotag",
                "cryptointelligence",
                "bitcoincore",
                "diariobitcoin",
                "bitcoinworld",
                "blokt",
                "ambcrypto",
                "cointelegraph_es",
                "cointelegraph",
                "financialtimes_crypto_",
                "seekingalpha",
                "bitdegree",
                "trustnodes",
                "timestabloid",
                "krakenblog",
                "investing_comcryptoopinionandanalysis",
                "forbes",
                "finbold",
                "bitzo",
                "cryptoast",
                "bitfinexblog",
                "ethereumfoundation",
                "invezz",
                "investing_comcryptonews",
                "huobi",
                "cryptonewsz",
                "zerohash",
                "coinquora",
                "coinacademy",
                "cryptonews",
                "cryptocoinnews",
                "journalducoin",
                "cryptodaily",
                "chainwire",
                "coinotag",
                "themerkle",
                "cointurk",
                "zycrypto",
                "cryptopolitan",
                "bitcoinsistemi",
                "cardanoofficialblog",
                "btcpulse",
                "thecoinrise",
                "cryptoknowmics",
                "crypto_news",
                "tipranks",
                "beincrypto",
                "thedefiant",
                "thenewscrypto",
                "ccdata",
                "cryptoglobe",
                "nft_news",
                "coincu",
                "cryptonewsfr",
                "coinnounce",
                "livebitcoinnews",
                "timesnext",
                "ethereumworldnews",
                "vauld_insights",
                "cryptonomist",
                "chaindd",
                "dailycoin",
                "99bitcoins",
                "yahoofinance"
              ],
              "example": "coindesk"
            }
          },
          {
            "name": "categories",
            "in": "query",
            "description": "Categories of news articles, options can be fetched from the response of `GET /news/categories` endpoint.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "TIA",
                "APT",
                "RON",
                "ALGO",
                "LINK",
                "MATIC",
                "DOT",
                "EGLD",
                "ZRX",
                "LTC",
                "BTC",
                "DOGE",
                "SOL",
                "MKR",
                "AAVE",
                "XRP",
                "SUI",
                "BCH",
                "XLM",
                "ETH",
                "NEAR",
                "ETC",
                "TON",
                "SHIB",
                "USDC",
                "BNB",
                "GRT",
                "DAI",
                "SEI",
                "TRX",
                "KNC",
                "ATOM",
                "FIL",
                "ADA",
                "XTZ",
                "COMP",
                "LUNA",
                "AVAX",
                "SAND",
                "UNI",
                "HBAR",
                "USDT"
              ],
              "example": "BTC"
            }
          },
          {
            "name": "exclude_categories",
            "in": "query",
            "description": "Categories of news articles to be excluded from result, options can be fetched from the response of `GET /news/categories` endpoint.",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "TIA",
                "APT",
                "RON",
                "ALGO",
                "LINK",
                "MATIC",
                "DOT",
                "EGLD",
                "ZRX",
                "LTC",
                "BTC",
                "DOGE",
                "SOL",
                "MKR",
                "AAVE",
                "XRP",
                "SUI",
                "BCH",
                "XLM",
                "ETH",
                "NEAR",
                "ETC",
                "TON",
                "SHIB",
                "USDC",
                "BNB",
                "GRT",
                "DAI",
                "SEI",
                "TRX",
                "KNC",
                "ATOM",
                "FIL",
                "ADA",
                "XTZ",
                "COMP",
                "LUNA",
                "AVAX",
                "SAND",
                "UNI",
                "HBAR",
                "USDT"
              ],
              "example": "BTC"
            }
          },
          {
            "name": "lookback",
            "in": "query",
            "description": "A lookback time defined as a UNIX timestamp, used to fetch articles from the given time.",
            "required": false,
            "schema": {
              "type": "string",
              "example": "1654041600"
            }
          },
          {
            "name": "language",
            "in": "query",
            "description": "Language of articles to be fetched. Format: `EN` (English) or `PT` (Portuguese)",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "EN",
                "PT",
                "ES",
                "FR",
                "JP",
                "TR"
              ],
              "example": "EN"
            }
          },
          {
            "name": "sort_by",
            "in": "query",
            "description": "Sorting order of news articles. Can be either `popular` or `latest`",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "popular",
                "latest"
              ],
              "example": "latest"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved list of market news articles.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetLatestNewsResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code400"
                }
              }
            }
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code403"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code404"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code500"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Code503"
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "apiKey": [],
      "apiPassphrase": []
    }
  ],
  "components": {
    "securitySchemes": {
      "apiKey": {
        "type": "apiKey",
        "description": "Your API public key. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for how to obtain keys.",
        "in": "header",
        "name": "X-SCX-API-KEY"
      },
      "apiPassphrase": {
        "type": "apiKey",
        "description": "The passphrase associated with your API key, set when the key was created.",
        "in": "header",
        "name": "X-SCX-PASSPHRASE"
      }
    },
    "parameters": {
      "Signature": {
        "name": "X-SCX-SIGNED",
        "in": "header",
        "description": "HMAC-SHA256 signature of the request, base64-encoded. See the [Authentication guide](https://docs.zerohash.com/reference/api-authentication) for the exact signing formula.",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "Timestamp": {
        "name": "X-SCX-TIMESTAMP",
        "in": "header",
        "description": "Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.",
        "required": true,
        "schema": {
          "type": "string",
          "example": "1678901234"
        }
      }
    },
    "schemas": {
      "Code400": {
        "type": "object",
        "description": "Request was rejected by validation or a downstream service. `errors` is an array of human-readable messages; each entry describes a single validation failure or business-rule violation.",
        "required": [
          "errors"
        ],
        "properties": {
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "example": [
              "body/amount must be >= 0",
              "body/asset is required"
            ]
          }
        }
      },
      "Code403": {
        "type": "object",
        "description": "Authentication or authorization failed. `error` is always `true`; `message` explains which check failed (missing API key, bad signature, insufficient permission, etc.).",
        "required": [
          "error",
          "message"
        ],
        "properties": {
          "error": {
            "type": "boolean",
            "example": true
          },
          "message": {
            "type": "string",
            "example": "This api key does not have write permission to this endpoint"
          }
        }
      },
      "Code404": {
        "type": "object",
        "description": "The requested resource does not exist or is not visible to the caller.",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "example": "Not Found"
          }
        }
      },
      "Code500": {
        "type": "object",
        "description": "An unexpected error occurred on the server. The request can be retried after a short delay, but the same inputs may reproduce the error.",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "example": "Internal Server Error"
          }
        }
      },
      "Code503": {
        "type": "object",
        "description": "A downstream dependency was unavailable, timed out, or returned a retryable error. Safe to retry; the response carries an `x-zh-allowretry: true` header. Every error response also carries an `x-zh-errorcode` header with a machine-readable error code (`unknown` when the failing service does not supply one).",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "string",
            "example": "Service Unavailable"
          }
        }
      },
      "GetLatestNewsResponse": {
        "type": "array",
        "description": "List of market news articles.",
        "items": {
          "$ref": "#/components/schemas/GetLatestNewsArticle"
        }
      },
      "GetLatestNewsArticle": {
        "properties": {
          "published_on": {
            "description": "Timestamp when the article was published",
            "type": "object",
            "properties": {
              "seconds": {
                "type": "number",
                "example": 1684928
              },
              "nanos": {
                "type": "number",
                "example": 819000000
              }
            },
            "example": {
              "seconds": 1684928,
              "nanos": 819000000
            }
          },
          "image_url": {
            "example": "/resources/news/21/example.jpeg",
            "description": "The image URL for the market data",
            "type": "string"
          },
          "title": {
            "example": "Example Title",
            "description": " Article title",
            "type": "string"
          },
          "url": {
            "example": "https://www.externalsource.com/all/article_url/",
            "description": "Link to news article",
            "type": "string"
          },
          "body": {
            "example": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur",
            "description": "Text of the article",
            "type": "string"
          },
          "tagsList": {
            "description": "Associated tags",
            "type": "array",
            "example": [
              "All"
            ]
          },
          "language": {
            "example": "EN",
            "description": "English (EN) or Portuguese (PT)",
            "type": "string"
          },
          "up_votes": {
            "example": 2,
            "description": "Number of upvotes for article ",
            "type": "number"
          },
          "down_votes": {
            "example": 5,
            "description": "Number of downvotes for article     ",
            "type": "number"
          },
          "categoriesList": {
            "description": "Associated categories with the article",
            "type": "array",
            "example": [
              "MARKET|BTC"
            ]
          },
          "sourceInfo": {
            "description": "Information about the source of the article",
            "type": "object",
            "example": {
              "name": "ExampleSource",
              "img": "/images/news/default/example.png",
              "language": "EN"
            }
          },
          "source": {
            "example": "exampleSource",
            "description": "Source of the article",
            "type": "string"
          }
        }
      }
    }
  }
}
```