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.alternative_data.get_uspto_patents(symbol="AAPL", from_=date.fromisoformat("2024-01-01"), to=date.fromisoformat("2024-12-31"))
assert res.uspto_patents_response is not None
# Handle response
print(res.uspto_patents_response)curl --request GET \
--url https://api.aries.com/v1/stock/uspto-patent \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/stock/uspto-patent', 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/stock/uspto-patent",
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/stock/uspto-patent"
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/stock/uspto-patent")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/stock/uspto-patent")
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{
"data": [
{
"applicationNumber": "17565837",
"companyFilingName": [
"NVIDIA CORPORATION"
],
"description": "OBSTACLE TO PATH ASSIGNMENT FOR AUTONOMOUS SYSTEMS AND APPLICATIONS",
"filingDate": "2021-12-30 00:00:00",
"filingStatus": "Application",
"patentNumber": "US20230213945A1",
"patentType": "Utility",
"publicationDate": "2023-07-06 00:00:00",
"url": ""
}
],
"symbol": "NVDA"
}Stock Alternative
USPTO Patent
Retrieve USPTO patents for companies. Limit 250 records per API call. Filter by symbol and date range (from, to).
Use Case: List recent patents filed by a company for IP and innovation analysis.
GET
/
v1
/
stock
/
uspto-patent
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.alternative_data.get_uspto_patents(symbol="AAPL", from_=date.fromisoformat("2024-01-01"), to=date.fromisoformat("2024-12-31"))
assert res.uspto_patents_response is not None
# Handle response
print(res.uspto_patents_response)curl --request GET \
--url https://api.aries.com/v1/stock/uspto-patent \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aries.com/v1/stock/uspto-patent', 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/stock/uspto-patent",
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/stock/uspto-patent"
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/stock/uspto-patent")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aries.com/v1/stock/uspto-patent")
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{
"data": [
{
"applicationNumber": "17565837",
"companyFilingName": [
"NVIDIA CORPORATION"
],
"description": "OBSTACLE TO PATH ASSIGNMENT FOR AUTONOMOUS SYSTEMS AND APPLICATIONS",
"filingDate": "2021-12-30 00:00:00",
"filingStatus": "Application",
"patentNumber": "US20230213945A1",
"patentType": "Utility",
"publicationDate": "2023-07-06 00:00:00",
"url": ""
}
],
"symbol": "NVDA"
}Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Stock ticker symbol (e.g. NVDA). |
from | string | Yes | From date YYYY-MM-DD. |
to | string | Yes | To date YYYY-MM-DD. |
Response
Success returns200 OK with a JSON object containing data array of patent entries (e.g. applicationNumber, patentNumber, description, filingDate, publicationDate, type, url), and symbol.
Errors: 400 when symbol or dates are missing, 401 unauthorized, 404 when no data found, 500 server error.Authorizations
OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.
Query Parameters
Stock ticker to query. Send the plain uppercase symbol exactly as you'd type it on a brokerage screen, e.g. AAPL, MSFT.
Example:
"AAPL"
Start of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-01-01).
Example:
"2024-01-01"
End of the date window, inclusive. Format: YYYY-MM-DD (e.g. 2024-12-31).
Example:
"2024-12-31"
Was this page helpful?