tensorfeed 1.26.0__tar.gz → 1.28.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tensorfeed
3
- Version: 1.26.0
3
+ Version: 1.28.0
4
4
  Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, agent payments via USDC on Base (optional web3 auto-send)
5
5
  Author-email: "TensorFeed.ai" <feedback@tensorfeed.ai>
6
6
  License-Expression: MIT
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "tensorfeed"
7
- version = "1.26.0"
7
+ version = "1.28.0"
8
8
  description = "Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, agent payments via USDC on Base (optional web3 auto-send)"
9
9
  readme = "README.md"
10
10
  license = "MIT"
@@ -21,4 +21,4 @@ __all__ = [
21
21
  "PaymentRequired",
22
22
  "RateLimited",
23
23
  ]
24
- __version__ = "1.26.0"
24
+ __version__ = "1.28.0"
@@ -425,6 +425,106 @@ class TensorFeed:
425
425
  """
426
426
  return self._get(f"/history/{date}/{snapshot_type}")
427
427
 
428
+ def history_pricing_series(
429
+ self,
430
+ model: str,
431
+ *,
432
+ days: int | None = None,
433
+ from_date: str | None = None,
434
+ to_date: str | None = None,
435
+ ) -> dict[str, Any]:
436
+ """Free pricing time series for a single model. 7-day cap.
437
+
438
+ For up to 90 days, use ``pricing_series()`` (premium, 1 credit).
439
+
440
+ Args:
441
+ model: model id or name (e.g. "claude-sonnet-4")
442
+ days: rolling window length in days (1 to 7). Wins over from/to.
443
+ from_date: optional YYYY-MM-DD start, used if ``days`` is None.
444
+ to_date: optional YYYY-MM-DD end, defaults to today UTC.
445
+ """
446
+ params: dict[str, Any] = {"model": model}
447
+ if days is not None:
448
+ params["days"] = days
449
+ if from_date is not None:
450
+ params["from"] = from_date
451
+ if to_date is not None:
452
+ params["to"] = to_date
453
+ return self._get("/history/pricing/series", params=params)
454
+
455
+ def history_benchmarks_series(
456
+ self,
457
+ model: str,
458
+ benchmark: str,
459
+ *,
460
+ days: int | None = None,
461
+ from_date: str | None = None,
462
+ to_date: str | None = None,
463
+ ) -> dict[str, Any]:
464
+ """Free benchmark score time series for a model. 7-day cap.
465
+
466
+ For up to 90 days, use ``benchmark_series()`` (premium, 1 credit).
467
+ """
468
+ params: dict[str, Any] = {"model": model, "benchmark": benchmark}
469
+ if days is not None:
470
+ params["days"] = days
471
+ if from_date is not None:
472
+ params["from"] = from_date
473
+ if to_date is not None:
474
+ params["to"] = to_date
475
+ return self._get("/history/benchmarks/series", params=params)
476
+
477
+ def history_status_uptime(
478
+ self,
479
+ provider: str,
480
+ *,
481
+ days: int | None = None,
482
+ from_date: str | None = None,
483
+ to_date: str | None = None,
484
+ ) -> dict[str, Any]:
485
+ """Free uptime rollup for a provider. 7-day cap.
486
+
487
+ For up to 90 days, use ``status_uptime()`` (premium, 1 credit).
488
+ """
489
+ params: dict[str, Any] = {"provider": provider}
490
+ if days is not None:
491
+ params["days"] = days
492
+ if from_date is not None:
493
+ params["from"] = from_date
494
+ if to_date is not None:
495
+ params["to"] = to_date
496
+ return self._get("/history/status/uptime", params=params)
497
+
498
+ def status_leaderboard_free(
499
+ self,
500
+ *,
501
+ days: int | None = None,
502
+ ) -> dict[str, Any]:
503
+ """Cross-provider uptime leaderboard. Free, 7-day cap.
504
+
505
+ Returns providers ranked by uptime % DESC. Each entry includes
506
+ ``polls``, per-bucket counts (operational/degraded/down/unknown),
507
+ ``downtime_minutes``, and ``hard_down_minutes`` (excludes degraded).
508
+ Computed from minute-resolution counters: at our 2-min poll cadence
509
+ a 7-day window aggregates ~5040 samples per provider.
510
+
511
+ For windows up to 90 days plus ``incident_count`` and
512
+ ``mttr_minutes`` per provider, use ``status_leaderboard()``
513
+ (premium, 1 credit).
514
+
515
+ Args:
516
+ days: 1 to 7 (default 7).
517
+
518
+ Returns:
519
+ Dict with ``entries`` (sorted), ``range``, ``poll_interval_minutes``,
520
+ and ``generated_at``. ``ok=False`` with ``error="no_data"`` if
521
+ the counter capture has not accumulated any data in the range.
522
+ """
523
+ params: dict[str, Any] = {}
524
+ if days is not None:
525
+ params["days"] = days
526
+ return self._get("/status/leaderboard", params=params)
527
+
428
528
  # ── Free: routing preview (rate-limited) ───────────────────────
429
529
 
430
530
  def routing_preview(
@@ -760,6 +860,43 @@ class TensorFeed:
760
860
  require_token=True,
761
861
  )
762
862
 
863
+ def status_leaderboard(
864
+ self,
865
+ *,
866
+ from_date: str | None = None,
867
+ to_date: str | None = None,
868
+ ) -> dict[str, Any]:
869
+ """Cross-provider uptime leaderboard. Costs 1 credit.
870
+
871
+ Same minute-resolution counter source as the free
872
+ ``status_leaderboard_free()`` but extends the window to the full
873
+ 90-day retention horizon and adds ``incident_count`` and
874
+ ``mttr_minutes`` (mean time to recover from resolved incidents)
875
+ per provider.
876
+
877
+ Aimed at SRE/ops/procurement teams comparing AI vendor reliability
878
+ for vendor selection or post-incident reviews. The data series
879
+ compounds with time and cannot be backfilled, so it is part of the
880
+ moat behind the free 7-day endpoint.
881
+
882
+ Args:
883
+ from_date: Start date in YYYY-MM-DD UTC. Defaults to 30 days ago.
884
+ to_date: End date in YYYY-MM-DD UTC. Defaults to today.
885
+
886
+ Returns:
887
+ Dict with ``entries`` (sorted by uptime % DESC), each with
888
+ ``rank``, ``uptime_pct``, ``polls``, per-bucket counts,
889
+ ``downtime_minutes``, ``hard_down_minutes``, ``incident_count``,
890
+ and ``mttr_minutes``. Plus ``billing``.
891
+ """
892
+ self._require_token("status_leaderboard")
893
+ return self._request(
894
+ "GET",
895
+ "/premium/status/leaderboard",
896
+ params={"from": from_date, "to": to_date},
897
+ require_token=True,
898
+ )
899
+
763
900
  # ── Paid: webhook watches (Tier 1, 1 credit per registration) ──
764
901
 
765
902
  def create_watch(
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tensorfeed
3
- Version: 1.26.0
3
+ Version: 1.28.0
4
4
  Summary: Python SDK for the TensorFeed.ai API: AI news, status, model pricing, premium routing + history series + webhook watches, agent payments via USDC on Base (optional web3 auto-send)
5
5
  Author-email: "TensorFeed.ai" <feedback@tensorfeed.ai>
6
6
  License-Expression: MIT
File without changes
File without changes