Skip to main content

Docs ftmq on pypi PyPI Downloads PyPI - Python Version Python test and package pre-commit Coverage Status AGPLv3+ License Pydantic v2

ftmq

This library provides methods to query and filter entities formatted as Follow The Money data, either from a json file/stream or using a statement-based store backend from nomenklatura.

It also provides a Query class that can be used in other libraries to work with SQL store queries or api queries.

ftmq is the base layer for investigativedata.io's libraries and applications dealing with Follow The Money data.

To get familiar with the Follow The Money ecosystem, you can have a look at this pad here.

Installation

Minimum Python version: 3.11

pip install ftmq

Usage

Command line

cat entities.ftm.json | ftmq -s Company --country=de --incorporationDate__gte=2023 -o s3://data/entities-filtered.ftm.json

Python Library

from ftmq import Query, smart_read_proxies

q = Query() \
    .where(dataset="ec_meetings", date__lte=2020) \
    .where(schema="Event") \
    .order_by("date", ascending=False)

for proxy in smart_read_proxies("s3://data/entities.ftm.json"):
    if q.apply(proxy):
        yield proxy

Documentation

https://docs.investigraph.dev/lib/ftmq

Support

This project is part of investigraph

In 2023, development of ftmq was supported by Media Tech Lab Bayern batch #3

License and Copyright

ftmq, (C) 2023 Simon Wörpel ftmq, (C) 2024-2025 investigativedata.io ftmq, (C) 2025 Data and Research Center – DARC

ftmq is licensed under the AGPLv3 or later license.

Prior to version 0.8.0, ftmq was released under the MIT license.

see NOTICE and LICENSE

Download files

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

Source Distribution

ftmq-4.10.1.tar.gz (53.3 kB view details)

Uploaded Source

Built Distribution

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

ftmq-4.10.1-py3-none-any.whl (64.4 kB view details)

Uploaded Python 3

File details

Details for the file ftmq-4.10.1.tar.gz.

File metadata

  • Download URL: ftmq-4.10.1.tar.gz
  • Upload date:
  • Size: 53.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.4.1 CPython/3.14.4 Linux/7.0.0-28-generic

File hashes

Hashes for ftmq-4.10.1.tar.gz
Algorithm Hash digest
SHA256 d4f8698ccaf3308638fa64cd10516340f4b20cf772a06cfc94868346c5e75573
MD5 5fef9318841f71018a6acff454a9342b
BLAKE2b-256 e9efca441da08fe45c1c905e3c46af56a0ae0bf2c36835407407833a67be9aa9

See more details on using hashes here.

File details

Details for the file ftmq-4.10.1-py3-none-any.whl.

File metadata

  • Download URL: ftmq-4.10.1-py3-none-any.whl
  • Upload date:
  • Size: 64.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/2.4.1 CPython/3.14.4 Linux/7.0.0-28-generic

File hashes

Hashes for ftmq-4.10.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8014750803858dd8dcfe22725ea68ab6843a514ecbb120a612d087c3d8ed9854
MD5 30c7468c101a36607b4d9197cfd78358
BLAKE2b-256 fa68d358a0f2f764528067ae865ca98648c2836ff39a5066a47da303c3153e9c

See more details on using hashes here.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page