npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

financialdatasets-cli

v0.0.3

Published

CLI for Financial Datasets API - command-line interface for accessing financial market data

Vulnerabilities

Powered byPowered by Snyk
  • 0High
  • 0Medium
  • 0Low

Links

Git

Maintainers

simonxabrissimonxabris

Keywords

clifinancestocksapifinancial-datasetsmarket-datacryptoearnings

Readme

@simonxabris/financialdatasets-cli

A command-line interface for the Financial Datasets API. Query stock prices, crypto data, financial statements, earnings reports, news, SEC filings, insider trades, and more.

Installation

# npm
npm install -g @simonxabris/financialdatasets-cli

# pnpm
pnpm add -g @simonxabris/financialdatasets-cli

# bun
bun add -g @simonxabris/financialdatasets-cli

Setup

Get an API key at financialdatasets.ai.

Make sure it's available in the environment as FINANCIAL_DATASETS_API_KEY

Usage

financialdatasets <command> [options]

Commands

Prices

# Historical stock prices
financialdatasets prices historical --ticker AAPL --start-date 2024-01-01 --end-date 2024-01-31

# Latest price snapshot
financialdatasets prices snapshot --ticker AAPL

Crypto

# Historical crypto prices
financialdatasets crypto historical --ticker BTC-USD --start-date 2024-01-01 --end-date 2024-01-31

# Latest crypto snapshot
financialdatasets crypto snapshot --ticker BTC-USD

Company

# Company facts and information
financialdatasets company facts --ticker AAPL

Earnings

# Earnings press releases
financialdatasets earnings press-releases --ticker AAPL

Financials

# All financial statements
financialdatasets financials all --ticker AAPL --period annual --limit 5

# Income statements only
financialdatasets financials income-statements --ticker AAPL --period annual --limit 5

# Balance sheets
financialdatasets financials balance-sheets --ticker AAPL --period quarterly

# Cash flow statements
financialdatasets financials cash-flow-statements --ticker AAPL --period ttm

News

# Company news
financialdatasets news --ticker AAPL --limit 20

SEC Filings

# List filings
financialdatasets filings list --ticker AAPL --filing-type 10-K

# Get specific filing items
financialdatasets filings items --ticker AAPL --filing-type 10-K --year 2024 --item Item-1

Insider Trades

financialdatasets insider-trades --ticker AAPL --limit 50

Institutional Ownership

financialdatasets institutional-ownership --ticker AAPL --limit 20

Financial Metrics

# Historical metrics
financialdatasets financial-metrics historical --ticker AAPL --period annual --limit 5

# Latest metrics snapshot
financialdatasets financial-metrics snapshot --ticker AAPL

Help

Get help for any command:

financialdatasets --help
financialdatasets prices --help
financialdatasets prices historical --help

Output

All commands return raw JSON responses from the API.

Requirements

  • Node.js >= 18.0.0
  • FINANCIAL_DATASETS_API_KEY environment variable

Links