Python (SDK)
from datetime import date
from finance_dev import FinanceDev, models
with FinanceDev(
security=models.Security(
client_id="<YOUR_CLIENT_ID_HERE>",
client_secret="<YOUR_CLIENT_SECRET_HERE>",
),
) as fd_client:
res = fd_client.corporate_actions.get_spinoffs(identifier="AAPL", identifier_type=models.TenderOfferIdentifierType.SYMBOL, start_date=date.fromisoformat("2020-01-01"), end_date=date.fromisoformat("2020-12-31"))
assert res.spinoffs_response is not None
# Handle response
print(res.spinoffs_response)import { FinanceDev } from "@ariesdotcom/finance-dev";
const financeDev = new FinanceDev({
security: {
clientID: "<YOUR_CLIENT_ID_HERE>",
clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
},
});
async function run() {
const result = await financeDev.corporateActions.getSpinoffs({
identifier: "AAPL",
identifierType: "Symbol",
startDate: new Date("2020-01-01"),
endDate: new Date("2020-12-31"),
});
console.log(result);
}
run();curl --request GET \
--url https://api.aries.com/v1/corporate-actions/spinoffs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/corporate-actions/spinoffs', 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.aries.com/v1/corporate-actions/spinoffs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.aries.com/v1/corporate-actions/spinoffs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.aries.com/v1/corporate-actions/spinoffs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/corporate-actions/spinoffs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"spinoffs": [
{
"declaredDate": "2020-09-01",
"description": "Spinoff of subsidiary operations",
"exDate": "2020-10-15",
"fromCompanyName": "Ilztal AG",
"fromSymbol": "ILZ.XFRA",
"paymentDate": "2020-10-15",
"ratio": "1:1",
"recordDate": "2020-10-14",
"toCompanyName": "New Company Inc",
"toSymbol": "NEWCO"
}
]
}Corporate Actions
Corporate Spinoffs
Retrieve corporate spinoff information including parent and subsidiary companies, distribution ratios, and effective dates. Track corporate restructuring and new investment opportunities.
Use Case: Monitor upcoming spinoffs to evaluate value creation opportunities from corporate separations.
GET
/
v1
/
corporate-actions
/
spinoffs
Python (SDK)
from datetime import date
from finance_dev import FinanceDev, models
with FinanceDev(
security=models.Security(
client_id="<YOUR_CLIENT_ID_HERE>",
client_secret="<YOUR_CLIENT_SECRET_HERE>",
),
) as fd_client:
res = fd_client.corporate_actions.get_spinoffs(identifier="AAPL", identifier_type=models.TenderOfferIdentifierType.SYMBOL, start_date=date.fromisoformat("2020-01-01"), end_date=date.fromisoformat("2020-12-31"))
assert res.spinoffs_response is not None
# Handle response
print(res.spinoffs_response)import { FinanceDev } from "@ariesdotcom/finance-dev";
const financeDev = new FinanceDev({
security: {
clientID: "<YOUR_CLIENT_ID_HERE>",
clientSecret: "<YOUR_CLIENT_SECRET_HERE>",
},
});
async function run() {
const result = await financeDev.corporateActions.getSpinoffs({
identifier: "AAPL",
identifierType: "Symbol",
startDate: new Date("2020-01-01"),
endDate: new Date("2020-12-31"),
});
console.log(result);
}
run();curl --request GET \
--url https://api.aries.com/v1/corporate-actions/spinoffs \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/corporate-actions/spinoffs', 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.aries.com/v1/corporate-actions/spinoffs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.aries.com/v1/corporate-actions/spinoffs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.aries.com/v1/corporate-actions/spinoffs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/corporate-actions/spinoffs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"spinoffs": [
{
"declaredDate": "2020-09-01",
"description": "Spinoff of subsidiary operations",
"exDate": "2020-10-15",
"fromCompanyName": "Ilztal AG",
"fromSymbol": "ILZ.XFRA",
"paymentDate": "2020-10-15",
"ratio": "1:1",
"recordDate": "2020-10-14",
"toCompanyName": "New Company Inc",
"toSymbol": "NEWCO"
}
]
}Authorizations
Query Parameters
Identifier value for the company you're querying. The format depends on identifierType:
Symbol— exchange ticker (e.g.AAPL).CUSIP— 9-character U.S./Canadian identifier (e.g.037833100).ISIN— 12-character international identifier (e.g.US0378331005).SEDOL— 7-character UK identifier.Valoren— Swiss security identifier.FIGI— Bloomberg Financial Instrument Global Identifier.CompositeFIGI— country-level composite FIGI.
Must match the kind selected in identifierType.
Example:
"AAPL"
Tells the API how to interpret identifier. See TenderOfferIdentifierType for the full set of supported values and what each one means.
Which kind of identifier you are filtering by. Provide the matching value in the identifier field:
Symbol— exchange ticker (e.g.AAPL).CUSIP— 9-character U.S./Canadian security identifier.ISIN— 12-character international identifier.SEDOL— 7-character UK identifier.Valoren— Swiss identifier.FIGI— Bloomberg Financial Instrument Global Identifier.CompositeFIGI— country-level composite FIGI.
Available options:
Symbol, CUSIP, ISIN, SEDOL, Valoren, FIGI, CompositeFIGI Example:
"Symbol"
Was this page helpful?