Internet News

Retrieve market news from Internet.

Endpoint

GET /news/market

Parameters

Parameter	Type	Required	Description
orbit_entity_id	string[]	No	Filter news for specific companies
keywords	string[]	No	Additional keywords to filter
source	string	No	google_news, google_finance, all
language	string	No	ISO language code (default: en)
date_range	object	No	{"start": "2024-12-01", "end": "2024-12-08"}
limit	integer	No	Max articles (default: 100, max: 100)

Example Request

bash

curl -X GET "https://api.orbitfin.ai/v1/news/market?orbit_entity_id=ent_2vxp8q3n&limit=50" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

json

{
  "status": "success",
  "credits_used": 2.0,
  "data": {
    "article_count": 50,
    "articles": [
      {
        "article_id": "news_8kp3m9xn",
        "title": "Apple Announces New AI Features",
        "source": "Reuters",
        "url": "https://...",
        "published_at": "2024-12-08T08:30:00Z",
        "author": "John Doe",
        "summary": "Apple Inc. unveiled...",
        "companies_mentioned": ["ent_2vxp8q3n"],
        "sentiment": {
          "score": 0.72,
          "label": "positive"
        },
        "relevance_score": 0.95
      }
    ]
  }
}

---

Error Handling

All endpoints return consistent error responses:

json

{
  "status": "error",
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Your account has insufficient credits for this request",
    "details": {
      "credits_required": 10.0,
      "credits_available": 3.5
    }
  }
}