kFinance

The kFinance Python library provides a simple interface for the LLM-ready API, streamlining API requests and response handling. It can be used on its own, with LLMs, or integrated into applications.

For a complete overview of the functions, usage, and features of the kFinance Python library, please refer to documentation here.

Any questions or suggestions can be sent to the kFinance Maintainers.

Setup

You can install kFinance on PyPI via

pip install kensho-kfinance

Getting started

To receive access, please email S&P Global Market Intelligence for information on free trials and pricing.

Once access is obtained, get started using the Authentication Guide and Usage Guide.

To get started, we provide some notebooks:

  • The LLM-ready API Basic Usage notebook demonstrates how fetch data with the kFinance client.
  • The tool_calling notebooks show how the kFinance library can be used for tool calling. We provide notebooks for OpenAI (GPT), Anthropic (Claude), and Google (Gemini). Each of these integrations comes in a langchain version, which uses langchain as a wrapper to simplify the integration, and as a lower level non-langchain version.

We also provide an interactive notebook that demonstrates some usage examples.

MCP (Model Context Protocol)

To run the kFinance MCP server use:

python -m kfinance.mcp

This function initializes and starts an MCP server that exposes the kFinance tools. The server supports multiple authentication methods and transport protocols to accommodate different deployment scenarios.

The server's full signature is as follows:

kfinance.mcp [--stdio|-s|--sse|--streamable-http] --refresh-token <refresh-token> --client-id <client-id> --private-key <private-key>

Authentication Methods (in order of precedence):

  1. Refresh Token: Uses an existing refresh token for authentication. The --refresh-token <refresh-token> argument must be provided.
  2. Key Pair: Uses client ID and private key for authentication. Both the --client-id <client-id> and --private-key <private-key> arguments must be provided.
  3. Browser: Falls back to browser-based authentication flow. This occurs if no auth arguments are provided.

Transport Layers:

  • --stdio / -s: Standard input/output transport (use with MCP Inspector)
  • --sse: Server-Sent Events transport (default)
  • --streamable-http: HTTP transport

Examples:

# Using stdio with MCP Inspector
npx @modelcontextprotocol/inspector python -m kfinance.mcp --stdio --refresh-token <token>

# Using SSE (default)
python -m kfinance.mcp --refresh-token <token>

# Using streamable-http
python -m kfinance.mcp --streamable-http --refresh-token <token>

MCP Proxy

The kFinance MCP proxy is a skeleton server that forwards requests to a remote kfinance MCP backend, injecting authentication tokens into every outgoing request. It is intended as a starting point for building a full production MCP proxy service.

# Using a refresh token (for experimentation)
AUTH_REFRESH_TOKEN=<token> python -m kfinance.proxy_mcp

# Using a key pair (for production)
AUTH_CLIENT_ID=<client-id> AUTH_PRIVATE_KEY=<private-key> python -m kfinance.proxy_mcp

The server starts on http://127.0.0.1:8000/mcp by default. Use --host and --port to configure binding.

For full documentation including configuration options, authentication methods, and production considerations, see kfinance/integrations/proxy_mcp/README.md.

Development

Working with Local Package Version

If you need to develop using a local version of the kFinance package in another project that uses poetry for package and dependency management, follow these steps:

  1. In your dependent project's pyproject.toml, replace the kFinance package version specification:

    # Replace this:
# kensho-kfinance = "~2.0.1"
# With this:
kensho-kfinance = { path = "/absolute/path/to/kfinance", develop = true }

    The develop = true flag ensures that the package always matches your local version without requiring reinstallation after changes.

  2. Update your project's dependencies:

    poetry update    # Update poetry.lock with new changes
poetry install   # Install dependencies with updated configuration

    If you encounter the error "your pyproject.toml file has significantly changed", run:

    poetry lock     # Sync the changes to poetry.lock

Versioning

The kFinance uses semantic versioning (major, minor, patch). To bump the version, add a new entry in CHANGELOG.md. This will generate a new version of the library as part of the release process.

License

Licensed under the Apache 2.0 License. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Copyright 2025-present Kensho Technologies, LLC. The present date is determined by the timestamp of the most recent commit in the repository.

Project links

Data verified by PyPI on Jul 15, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (7.1.1)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for Kensho from gravatar.com Kensho

Credits

Author: Luke Brown

GitHub Statistics

Data verified by PyPI on Jul 15, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

Apache Software License (Apache License)

Requires

Python <4, >=3.10

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kensho_kfinance-6.6.3.tar.gz (460.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

kensho_kfinance-6.6.3-py3-none-any.whl (233.5 kB view details)

Uploaded Python 3

File details

Details for the file kensho_kfinance-6.6.3.tar.gz.

File metadata

  • Download URL: kensho_kfinance-6.6.3.tar.gz
  • Upload date:
  • Size: 460.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kensho_kfinance-6.6.3.tar.gz
Algorithm Hash digest
SHA256 3810d9ab0d1f1f49bc03766295615c149b1383b7cbce523bb7d13ae07847e78a
MD5 534fe6bbd53a86bc93768c15e39c7544
BLAKE2b-256 bd4ed30f2b12b9aeaf97fa745cb60277a9df26a00d0611c6bb7368bbf46dc1ce

See more details on using hashes here.

Provenance

The following attestation bundles were made for kensho_kfinance-6.6.3.tar.gz:

Publisher: python-publish.yml on kensho-technologies/kfinance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file kensho_kfinance-6.6.3-py3-none-any.whl.

File metadata

  • Download URL: kensho_kfinance-6.6.3-py3-none-any.whl
  • Upload date:
  • Size: 233.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for kensho_kfinance-6.6.3-py3-none-any.whl
Algorithm Hash digest
SHA256 28bc06f29b74c8382a737c0283af2ff65452a38de9ab79a6ebed26e1dcb35352
MD5 6e625f251669a8215225143f26c172d5
BLAKE2b-256 9e6b3a1f96283431c94304a70638f687f23c7b07d880693e79cbb59a80732b1a

See more details on using hashes here.

Provenance

The following attestation bundles were made for kensho_kfinance-6.6.3-py3-none-any.whl:

Publisher: python-publish.yml on kensho-technologies/kfinance

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

7.1.1

2 files

7.1.0

2 files

7.0.2

2 files

7.0.1

2 files

7.0.0

2 files

6.7.0

2 files

This release

6.6.3 This release

2 files

6.6.2

2 files

6.6.1

2 files

6.6.0

2 files

6.5.2

2 files

6.5.1

2 files

6.4.1

2 files

6.3.0

2 files

6.2.1

2 files

6.2.0

2 files

6.1.3

2 files

6.1.2

2 files

6.1.1

2 files

6.1.0

2 files

6.0.1

2 files

6.0.0

2 files

5.1.4

2 files

5.1.3

2 files

5.1.2

2 files

5.1.1

2 files

5.1.0

2 files

5.0.0

2 files

4.1.4

2 files

4.1.3

2 files

4.1.2

2 files

4.1.1

2 files

4.1.0

2 files

4.0.0

2 files

3.2.20

2 files

3.2.19

2 files

3.2.18

2 files

3.2.17

2 files

3.2.16

2 files

3.2.15

2 files

3.2.14

2 files

3.2.13

2 files

3.2.12

2 files

3.2.11

2 files

3.2.10

2 files

3.2.9

2 files

3.2.8

2 files

3.2.7

2 files

3.2.6

2 files

3.2.5

2 files

3.2.4

2 files

3.2.3

2 files

3.2.2

2 files

3.2.1

2 files

3.2.0

2 files

3.1.1

2 files

3.1.0

2 files

3.0.3

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

2.9.0

2 files

2.8.0

2 files

2.7.0

2 files

2.6.5

2 files

2.6.3

2 files

2.6.2

2 files

2.6.1

2 files

2.4.3

2 files

2.4.2

2 files

2.4.1

2 files

2.4.0

2 files

2.3.0

2 files

2.2.5

2 files

2.2.4

2 files

2.2.2

2 files

2.1.2

2 files

2.0.1

2 files

2.0.0

2 files

1.2.2

2 files

1.2.0

2 files

1.1.0

2 files

Pre-release

1.1.0a0

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page