How graphsense/graphsense-python works
This is a generated Python client for the GraphSense REST API, used by forensic applications to query cryptocurrency ledger data and annotations. The principal workflow is a caller configuring the client, invoking a domain endpoint, sending an HTTP request to a GraphSense service, and receiving decoded typed API data. The README documents address/entity investigation, deep neighbor search, transaction and block queries, tags, bulk retrieval, statistics, rates, and tokens. API modules are grouped by domain; sampled client and REST excerpts support the transport flow, while endpoint-specific wiring beyond the excerpts is represented only at the documented capability level.
Main entry points: api_client.py Request client · entities_api.py Entity queries · addresses_api.py Address queries · txs_api.py Transaction queries
Components 21
Investigation APIs
- Address queries
graphsense/api/addresses_api.py - Entity queries
graphsense/api/entities_api.py - Transaction queries
graphsense/api/txs_api.py - Block queries
graphsense/api/blocks_api.py - Tags and actors
graphsense/api/tags_api.py - Bulk retrieval
graphsense/api/bulk_api.py - Search and stats
graphsense/api/general_api.py - Exchange rates
graphsense/api/rates_api.py - Token support
graphsense/api/tokens_api.py
Client Runtime
- Request client
graphsense/api_client.py - Client configuration
graphsense/configuration.py - HTTP transport
graphsense/rest.py
Response Models
- Typed API models
graphsense/model - Address data
graphsense/model/address.py - Entity and neighbors
graphsense/model/entity.py - Search paths
graphsense/model/search_result_level1.py - Transaction data
graphsense/model/tx.py - Tag and actor data
graphsense/model/tag.py - Block data
graphsense/model/block.py
Other components
- Forensics caller
- GraphSense API
Connections 31
- Forensics caller → Client configuration: configures
- Forensics caller → Address queries: invokes
- Forensics caller → Entity queries: invokes
- Forensics caller → Transaction queries: invokes
- Forensics caller → Block queries: invokes
- Forensics caller → Tags and actors: invokes
- Forensics caller → Bulk retrieval: invokes
- Forensics caller → Search and stats: invokes
- Forensics caller → Exchange rates: invokes
- Forensics caller → Token support: invokes
- Address queries → Request client: sends request
- Entity queries → Request client: sends request
- Transaction queries → Request client: sends request
- Block queries → Request client: sends request
- Tags and actors → Request client: sends request
- Bulk retrieval → Request client: sends request
- Search and stats → Request client: sends request
- Exchange rates → Request client: sends request
- Token support → Request client: sends request
- Request client → Client configuration: uses settings
- Request client → HTTP transport: dispatches HTTP
- HTTP transport → GraphSense API: requests
- GraphSense API → HTTP transport: returns response
- Request client → Typed API models: decodes response
- Address queries → Address data: returns address data
- Entity queries → Entity and neighbors: returns entity data
- Entity queries → Search paths: returns search paths
- Transaction queries → Transaction data: returns transaction data
- Tags and actors → Tag and actor data: returns annotations
- Block queries → Block data: returns block data
- Forensics caller → Typed API models: receives typed results