メインコンテンツへスキップ
GET
/
api
/
v2.1
/
calendar
/
splits
يُرجِع بيانات calendar لتجزئات الأسهم
curl --request GET \
  --url 'https://api.benzinga.com/api/v2.1/calendar/splits?token=' \
  --header 'accept: <accept>'
import requests

url = "https://api.benzinga.com/api/v2.1/calendar/splits?token="

headers = {"accept": "<accept>"}

response = requests.get(url, headers=headers)

print(response.text)
const options = {method: 'GET', headers: {accept: '<accept>'}};

fetch('https://api.benzinga.com/api/v2.1/calendar/splits?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.benzinga.com/api/v2.1/calendar/splits?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: <accept>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.benzinga.com/api/v2.1/calendar/splits?token="

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("accept", "<accept>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://api.benzinga.com/api/v2.1/calendar/splits?token=")
  .header("accept", "<accept>")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.benzinga.com/api/v2.1/calendar/splits?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["accept"] = '<accept>'

response = http.request(request)
puts response.read_body
{
  "splits": [
    {
      "cusip": "87807D509",
      "date_announced": "2025-12-30",
      "date_distribution": "2025-01-06",
      "date_ex": "2025-01-07",
      "date_recorded": "2025-01-02",
      "exchange": "NASDAQ",
      "id": "677675329a903000017cb6f1",
      "importance": 1,
      "name": "TC BioPharm (Holdings)",
      "notes": "",
      "optionable": false,
      "ratio": "1.25:1",
      "split_type": "ADR Ratio Change",
      "ticker": "TCBP",
      "updated": 1735816783
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}
{
  "splits": [
    {
      "cusip": "87807D509",
      "date_announced": "2025-12-30",
      "date_distribution": "2025-01-06",
      "date_ex": "2025-01-07",
      "date_recorded": "2025-01-02",
      "exchange": "NASDAQ",
      "id": "677675329a903000017cb6f1",
      "importance": 1,
      "name": "TC BioPharm (Holdings)",
      "notes": "",
      "optionable": false,
      "ratio": "1.25:1",
      "split_type": "ADR Ratio Change",
      "ticker": "TCBP",
      "updated": 1735816783
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "auth_failed",
      "id": "unauthorized",
      "value": "Invalid or missing authentication token"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "no_data_found",
      "id": "not_found",
      "value": "No data found for the specified parameters"
    }
  ]
}
{
  "ok": false,
  "errors": [
    {
      "code": "internal_server_error",
      "id": "server_error",
      "value": "An unexpected error occurred while processing your request"
    }
  ]
}

承認

token
string
query
必須

ヘッダー

accept
enum<string>
デフォルト:application/json
必須

يحدّد تنسيق الإخراج. تعمل معاملات الاستعلام بالطريقة نفسها لكلا التنسيقين

利用可能なオプション:
application/json

クエリパラメータ

page
integer
デフォルト:0

إزاحة الصفحة. لتحسين الأداء ولأسباب تقنية، يتم تقييد قيم إزاحة الصفحة من 0 إلى 100000. قيِّد نتائج الاستعلام باستخدام معلمات أخرى مثل التاريخ.

pagesize
integer

عدد النتائج المُعادة. الحد الأقصى 1000

parameters[date]
string<YYYY-MM-DD>

تاريخ الاستعلام لبيانات calendar. يُعد اختصارًا لـ date_from و date_to إذا كانت قيمتاهما متطابقتين. تكون القيمة الافتراضية هي الأحدث

parameters[date_from]
string<YYYY-MM-DD>

تاريخ بدء الاستعلام من نقطة زمنية معينة

parameters[date_to]
string<YYYY-MM-DD>

تاريخ الاستعلام حتى نقطة زمنية معيّنة

parameters[date_search_field]
enum<string>
デフォルト:announced

التاريخ الذي تُستخدم على أساسه تصفية بيانات calendar وفرزها. القيمة الافتراضية هي announced

利用可能なオプション:
announced,
ex
parameters[importance]
enum<integer>

مستوى الأهمية الذي تتم التصفية على أساسه. يستخدم قيمة أكبر من أو تساوي مستوى الأهمية المحددة.

利用可能なオプション:
0,
1,
2,
3,
4,
5
parameters[tickers]
string<csv>

رمز تداول واحد أو أكثر، تفصل بينها فاصلة، وبحد أقصى 50 رمزًا من رموز الأسهم

parameters[updated]
integer

آخر طابع زمني محدث بنظام Unix للسجلات (UTC). سيؤدي ذلك إلى فرض ترتيب الفرز بحيث يكون أكبر من أو يساوي الطابع الزمني المحدَّد

レスポンス

نجاح

استجابة من واجهة برمجة التطبيقات API تتضمن مصفوفة من سجلات عمليات تجزئة الأسهم

splits
object[]