nomas

  • Company Facts
  • Insider Trading History
  • Failure to Deliver (FTD)
  • 13F Holdings
  • Portfolio
  • News
  • API
  • Back Home
Sign in

nomas

Nomas API Guide

Simple step-by-step guide to get started with the Nomas financial data API

Access comprehensive financial data including company facts, insider trading, FTD data, and Form 13F holdings. Sign up for a free account to get started.

Quick Start Guide

1
Create Your API Key

Go to your Account Management page and create an API key. This key will be used to authenticate your API requests.

2
Add API Key to Environment

In the API playground below, click the settings icon and add your API key to the X-API-Key environment variable.

3
Test Your First Request

Try the interactive examples below to test your API key and see the data in action.

Rate Limits

Rate limits are enforced per minute and vary based on your subscription tier.

Public

60 requests per minute

Basic endpoints only

Free

120 requests per minute

Basic company data

Professional

300 requests per minute

+ Insider trading & FTD data

Business

600 requests per minute

+ Portfolio management & real-time

API Endpoints

GET

/api/v1/dataview/companyView/{concept}/{cik}

Get company facts data for a specific concept and CIK

📋Parameters:
concept (string) - Required: Concept identifier
cik (string) - Required: Company CIK number
💻Example:
curl -X GET https://nomas.fyi/api/v1/dataview/companyView/AccountsPayableCurrent/0000320193 \ -H "X-API-Key: YOUR_API_KEY"
Try it live
GET

/api/v1/dataview/conceptView/{cik}

Get available concepts for a company

📋Parameters:
cik (string) - Required: Company CIK number
💻Example:
curl -X GET https://nomas.fyi/api/v1/dataview/conceptView/0000320193 \ -H "X-API-Key: YOUR_API_KEY"
Try it live
GET

/api/v1/dataview/conceptDetail/{concept}

Get detailed information about a specific concept

📋Parameters:
concept (string) - Required: Concept identifier
💻Example:
curl -X GET https://nomas.fyi/api/v1/dataview/conceptDetail/AccountsPayableCurrent \ -H "X-API-Key: YOUR_API_KEY"
Try it live

GET

/api/v1/dataview/ftdCompanyList

Get list of companies with FTD data

📋Parameters:
search (string) - Optional: Search term for company symbol or name
page (integer) - Optional: Page number for pagination (default: 1)
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/ftdCompanyList?search=AAPL&page=1" \ -H "X-API-Key: YOUR_API_KEY"
Try it live
GET

/api/v1/dataview/ftdView/{cusip}

Get FTD data for a specific CUSIP

📋Parameters:
cusip (string) - Required: CUSIP identifier
page (integer) - Optional: Page number for pagination (default: 1)
from_month (integer) - Optional: Start month (1-12) for date filtering
from_year (integer) - Optional: Start year (YYYY) for date filtering
to_month (integer) - Optional: End month (1-12) for date filtering
to_year (integer) - Optional: End year (YYYY) for date filtering
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/ftdView/007903107?page=1&from_month=5&from_year=2025&to_month=7&to_year=2025" \ -H "X-API-Key: YOUR_API_KEY"
Try it live

GET

/api/v1/dataview/insiderCompanyList

Get list of companies with insider trading data

📋Parameters:
page (integer) - Optional: Page number for pagination (default: 1)
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/insiderCompanyList?page=1" \ -H "X-API-Key: YOUR_API_KEY"
Try it live
GET

/api/v1/dataview/insiderTradingView/{cik}/{insiderTable}

Get insider trading data by table type

📋Parameters:
cik (string) - Required: Company CIK number
insiderTable (string) - Required: Table type (nonderiv_trans, deriv_trans, etc.)
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/insiderTradingView/0000320193/nonderiv_trans" \ -H "X-API-Key: YOUR_API_KEY"
Try it live

GET

/api/v1/dataview/form13f/filingmanagers

Get list of Form 13F filing managers

📋Parameters:
search (string) - Optional: Search term for filing manager name
page (integer) - Optional: Page number for pagination (default: 1)
page_size (integer) - Optional: Number of items per page (default: 50, max: 100)
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/form13f/filingmanagers?search=BlackRock&page=1&page_size=25" \ -H "X-API-Key: YOUR_API_KEY"
Try it live
GET

/api/v1/dataview/form13f/data/cik/{cik}

Get Form 13F data for a specific filing manager CIK

📋Parameters:
cik (string) - Required: Filing manager CIK number
quarter (string) - Optional: Specific quarter in YYYY-MM-DD format (optional)
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/form13f/data/cik/0000949012?quarter=2024-12-31" \ -H "X-API-Key: YOUR_API_KEY"
Try it live

GET

/api/v1/dataview/companyList

Get list of all companies

📋Parameters:
page (integer) - Optional: Page number for pagination (default: 1)
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/companyList?page=1" \ -H "X-API-Key: YOUR_API_KEY"
Try it live
GET

/api/v1/dataview/companyDetail/{cik}

Get detailed company information

📋Parameters:
cik (string) - Required: Company CIK number
💻Example:
curl -X GET "https://nomas.fyi/api/v1/dataview/companyDetail/0000320193" \ -H "X-API-Key: YOUR_API_KEY"
Try it live
Ready to Get Started?

Sign up for a free account to create your API key and start accessing financial data.