Skip to content
Live news Screener Coverage Pricing Docs REST API WebSocket API MCP server Company Use cases Blog Changelog Status Compare Contact
OXSQ$1.31-0.02(-1.62%)Oxford Square Capital Corp. Schedules Third Quarter 2026 Earnings Release and Conference Call for October 30, 2026[4:37:45 PM ET]CSV$35.41-1.57(-4.25%)Carriage Services Announces 2026 Third Quarter Earnings Release and Conference Call Schedule[4:31:58 PM ET]GD$349.36-1.43(-0.41%)Amy Johnson Appointed President of GDIT General Dynamics (NYSE:GD) announced today that Amy Johnson has been appointed as president of GDIT, effective November 3. Johnson is a 27-year...[4:30:00 PM ET]ACRE$3.35+0.09(+2.76%)Ares Commercial Real Estate Corporation Schedules Earnings Release and Conference Call for the Third Quarter Ended September 30, 2026 Ares Commercial Real Estate Corporation (NYSE: ACRE) announced today that it will report earnings for the third quarter ended September 30, 2026 on...[4:30:00 PM ET]ESOA$9.26+0.12(+1.31%)ENERGY SERVICES OF AMERICA COMPLETES FAMCO ACQUISITION Energy Services of America Corporation (the "Company" or "Energy Services") (Nasdaq: ESOA) today announced that its subsidiary, FAMCO Acquisition,...[4:30:00 PM ET]AVTGF$0.240.00(0.00%)Avanti Gold Announces Results of Annual General and Special Meeting[4:30:00 PM ET]AWK$142.75-0.48(-0.34%)California American Water Submits Monterey Desalination Project Financing and Cost Updates to the California Public Utilities Commission Today, California American Water submitted an application to the California Public Utilities Commission (CPUC) updating the project cost estimates, a ...[4:21:00 PM ET]PBT$33.68+0.41(+1.23%)PERMIAN BASIN ROYALTY TRUST ANNOUNCES RECORD DATE AND MEETING DATE FOR SPECIAL MEETING TO CONSIDER SOFTVEST PROPOSALS Argent Trust Company, as trustee ("Trustee") of the Permian Basin Royalty Trust (NYSE: PBT) ("Permian" or the "Trust"), today announced that it has...[4:20:00 PM ET]MMT$4.15-0.05(-1.19%)Aberdeen Multi-Market Income Fund (MMT) Announces Upcoming 1-for-4 Reverse Stock Split The Board of Trustees of Aberdeen Multi-Market Income Fund (NYSE: MMT) has approved a 1-for-4 reverse stock split of the Fund's issued and...[4:17:00 PM ET]FICO$749.00-74.27(-9.02%)FICO Holds Mortgage Score Pricing at $10 for Lenders Enrolled in Preferred Program[4:15:00 PM ET]CIVB$28.29+0.14(+0.50%)Civista Bancshares, Inc. Appoints Jeremy Normington-Slay to Board of Directors Civista Bancshares, Inc. (NASDAQ: CIVB) ("Civista") today announced the appointment of Jeremy Normington-Slay, DPT, MBA, FACHE, to the Boards of...[4:15:00 PM ET]NKTR$37.22-1.43(-3.70%)Nektar Therapeutics Reports Inducement Grants Under Nasdaq Listing Rule 5635(c)(4) Nektar Therapeutics (NASDAQ: NKTR) today announced that, on October 20, 2026, the Organization and Compensation Committee of Nektar's Board of...[4:15:00 PM ET]YMAT$2.13+0.21(+10.95%)J-Star Holding Co., Ltd. Files Interim Financial Report on Form 6-K[4:15:00 PM ET]MFI$8.390.00(0.00%)mF International to Wind Down Legacy Financial Trading Business, Shift Focus Completely to Digital Asset Strategy mF International Limited (NASDAQ:MFI) ("mF International" or the "Company") today announced that its Board of Directors has approved the wind-down...[4:15:00 PM ET]DTCFF$0.28-0.02(-5.28%)Defence Therapeutics Announces Convertible Debenture Interest Payment[4:15:00 PM ET]NKE$37.37-0.95(-2.48%)NIKE, Inc. Announces 2026 Investor Day Webcast[4:15:00 PM ET]
WebSocket

WebSocket stream

View as markdown

One connection, filtered on the server. Sources are polled every second, and articles are pushed as soon as they are ingested. The summary is not on this socket yet. Included in the Pro plan.

Endpoints

SocketWhen the article arrives
wss://ws.marketnewsapi.com/v1/streamAs soon as the article is ingested. summary is null.
wss://ws.marketnewsapi.com/v1/stream/summariesA few seconds later, after the AI summary is written. The welcome message says this socket is delayed.

Both sockets use the same channels, the same message types, and the same connection limit. A summaries connection counts as one of the 3 connections on the account.

wss://ws.marketnewsapi.com/v1/stream?api_key=YOUR_KEY
summaries
wss://ws.marketnewsapi.com/v1/stream/summaries?api_key=YOUR_KEY

Authentication

Pass your key as the api_key query parameter. Or connect without it and send an auth message as your first message within 10 seconds:

{
  "action": "auth",
  "api_key": "mna-live-..."
}

On success you get a welcome message. stream and message say which socket you opened:

/v1/stream
{
  "type": "welcome",
  "authenticated": true,
  "plan": "pro",
  "connection_id": "c_7Hk2pQ9x",
  "max_subscriptions": 200,
  "heartbeat_seconds": 30,
  "stream": "immediate",
  "message": "Articles are sent as soon as they are ingested. This socket does not wait for an AI summary. summary is null until it is written. GET /v1/news/{id} returns the summary once it is stored."
}
/v1/stream/summaries
{
  "type": "welcome",
  "authenticated": true,
  "plan": "pro",
  "connection_id": "c_7Hk2pQ9x",
  "max_subscriptions": 200,
  "heartbeat_seconds": 30,
  "stream": "summaries",
  "message": "This stream waits for the AI summary, so articles arrive a few seconds after they are ingested. The same article is already on /v1/stream and on GET /v1/news without waiting."
}

Subscribe

{
  "action": "subscribe",
  "channels": [
    "ticker:AAPL",
    "type:press_release",
    "keyword:guidance"
  ]
}
server reply
{
  "type": "subscribed",
  "channels": [
    "ticker:AAPL",
    "type:press_release",
    "keyword:guidance"
  ],
  "total": 3
}

Then articles arrive as they're published:

article message
{
  "type": "article",
  "matched": [
    "ticker:AAPL"
  ],
  "data": {
    "id": "art_9f2c1d7e4b8a6035",
    "title": "Apple unveils new on-device AI features, shares rise in premarket trading",
    "url": "https://www.example-publisher.com/markets/apple-ai-features",
    "source": {
      "name": "Example Publisher",
      "domain": "example-publisher.com"
    },
    "publisher": "Example Publisher",
    "published_at": "2026-10-06T12:31:04Z",
    "ingested_at": "2026-10-06T12:31:09Z",
    "category": "stocks",
    "type": "news",
    "tickers": [
      "AAPL"
    ],
    "listings": [
      {
        "symbol": "AAPL",
        "exchange": "NASDAQ"
      }
    ],
    "snippet": "Apple on Tuesday introduced a set of on-device AI features for iPhone and Mac, sending the stock higher before the open.",
    "summary": "Apple announced new on-device AI features for iPhone and Mac. Shares rose about 2% in premarket trading as analysts called the update a catalyst for the upgrade cycle.",
    "body": null,
    "entities": [
      {
        "type": "company",
        "name": "Apple Inc.",
        "symbol": "AAPL"
      },
      {
        "type": "product",
        "name": "iPhone"
      }
    ],
    "language": "en"
  }
}

Complete examples

# brew install websocat  (or: cargo install websocat)
websocat "wss://ws.marketnewsapi.com/v1/stream?api_key=$MARKETNEWSAPI_KEY"

# then paste:
{"action":"subscribe","channels":["ticker:AAPL","type:press_release","keyword:guidance"]}

Limits

  • 3 concurrent connections per account on the Pro plan. A 4th connection is closed with code 4008.
  • Up to 200 channels per connection.
  • Unlimited messages. No per-message billing.
  • Up to 20 control messages (subscribe, ping and so on) per second.

Next: channels, message reference, best practices.