Skip to main content

GraphSense API

Project description

graphsense-python

GraphSense API provides programmatic access to blockchain analytics data across multiple ledgers. Use it to explore addresses, entities, blocks, transactions, tags, token activity, and exchange-rate context, and to integrate investigation workflows into your own applications and automation.

This Python package is automatically generated by the OpenAPI Generator project:

  • API version: 2.9.8
  • Package version: 2.9.8
  • Generator version: 7.19.0
  • Build package: org.openapitools.codegen.languages.PythonClientCodegen For more information, please visit https://www.iknaio.com/

Requirements.

Python 3.9+

Installation & Usage

pip install

If the python package is hosted on a repository, you can install directly using:

pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git

(you may need to run pip with root permission: sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git)

Then import the package:

import graphsense

Setuptools

Install via Setuptools.

python setup.py install --user

(or sudo python setup.py install to install the package for all users)

Then import the package:

import graphsense

Tests

Execute pytest to run the tests.

Getting Started

Please follow the installation procedure and then run the following:

import graphsense
from graphsense.rest import ApiException
from pprint import pprint

# Defining the host is optional and defaults to https://api.iknaio.com
# See configuration.py for a list of all supported configuration parameters.
configuration = graphsense.Configuration(
    host = "https://api.iknaio.com"
)

# The client must configure the authentication and authorization parameters
# in accordance with the API server security policy.
# Examples for each auth method are provided below, use the example that
# satisfies your auth use case.

# Configure API key authorization: api_key
configuration.api_key['api_key'] = os.environ["API_KEY"]

# Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
# configuration.api_key_prefix['api_key'] = 'Bearer'


# Enter a context with an instance of the API client
with graphsense.ApiClient(configuration) as api_client:
    # Create an instance of the API class
    api_instance = graphsense.AddressesApi(api_client)
    currency = 'btc' # str | The cryptocurrency code (e.g., btc)
    address = '1Archive1n2C579dMsAu3iC6tWzuQJz8dN' # str | The cryptocurrency address
    include_actors = True # bool | Whether to include actor information (optional) (default to True)

    try:
        # Get an address
        api_response = api_instance.get_address(currency, address, include_actors=include_actors)
        print("The response of AddressesApi->get_address:\n")
        pprint(api_response)
    except ApiException as e:
        print("Exception when calling AddressesApi->get_address: %s\n" % e)

Documentation for API Endpoints

All URIs are relative to https://api.iknaio.com

Class Method HTTP request Description
AddressesApi get_address GET /{currency}/addresses/{address} Get an address
AddressesApi get_address_entity GET /{currency}/addresses/{address}/entity Get the entity for an address
AddressesApi get_tag_summary_by_address GET /{currency}/addresses/{address}/tag_summary Get address attribution tag summary
AddressesApi list_address_links GET /{currency}/addresses/{address}/links List transactions between two addresses
AddressesApi list_address_neighbors GET /{currency}/addresses/{address}/neighbors List neighboring addresses
AddressesApi list_address_txs GET /{currency}/addresses/{address}/txs List transactions involving an address
AddressesApi list_related_addresses GET /{currency}/addresses/{address}/related_addresses List related addresses
AddressesApi list_tags_by_address GET /{currency}/addresses/{address}/tags List attribution tags for an address
BlocksApi get_block GET /{currency}/blocks/{height} Get block details by height
BlocksApi get_block_by_date GET /{currency}/block_by_date/{date} Get block at or before a date
BlocksApi list_block_txs GET /{currency}/blocks/{height}/txs List transactions in a block
BulkApi bulk_csv POST /{currency}/bulk.csv/{operation} Stream bulk operation results as CSV
BulkApi bulk_json POST /{currency}/bulk.json/{operation} Stream bulk operation results as JSON
EntitiesApi get_entity GET /{currency}/entities/{entity} Get entity details
EntitiesApi list_address_tags_by_entity GET /{currency}/entities/{entity}/tags List entity address tags
EntitiesApi list_entity_addresses GET /{currency}/entities/{entity}/addresses List entity addresses
EntitiesApi list_entity_links GET /{currency}/entities/{entity}/links List transactions between entities
EntitiesApi list_entity_neighbors GET /{currency}/entities/{entity}/neighbors List neighboring entities
EntitiesApi list_entity_txs GET /{currency}/entities/{entity}/txs List entity transactions
EntitiesApi search_entity_neighbors GET /{currency}/entities/{entity}/search Search entity neighborhood
GeneralApi get_statistics GET /stats Get platform statistics for supported currencies
GeneralApi search GET /search Search addresses, transactions, actors, and labels
RatesApi get_exchange_rates GET /{currency}/rates/{height} Get fiat exchange rates at a block height
TagsApi get_actor GET /tags/actors/{actor} Get actor details by ID
TagsApi get_actor_tags GET /tags/actors/{actor}/tags List tags associated with an actor
TagsApi list_address_tags GET /tags List address tags by label
TagsApi list_concepts GET /tags/taxonomies/{taxonomy}/concepts List concepts for a taxonomy
TagsApi list_taxonomies GET /tags/taxonomies List all taxonomies
TagsApi report_tag POST /tags/report-tag Submit a user-reported tag
TokensApi list_supported_tokens GET /{currency}/supported_tokens List supported tokens for a currency
TxsApi get_spending_txs GET /{currency}/txs/{tx_hash}/spending List source transactions
TxsApi get_spent_in_txs GET /{currency}/txs/{tx_hash}/spent_in List spending transactions
TxsApi get_tx GET /{currency}/txs/{tx_hash} Get transaction details by hash
TxsApi get_tx_conversions GET /{currency}/txs/{tx_hash}/conversions List DeFi conversions in a transaction
TxsApi get_tx_io GET /{currency}/txs/{tx_hash}/{io} List transaction inputs or outputs
TxsApi list_token_txs GET /{currency}/token_txs/{tx_hash} List token transfers in a transaction
TxsApi list_tx_flows GET /{currency}/txs/{tx_hash}/flows List transaction asset flows

Documentation For Models

Documentation For Authorization

Authentication schemes defined for the API:

api_key

  • Type: API key
  • API key parameter name: Authorization
  • Location: HTTP header

Author

contact@iknaio.com

Project details


Download files

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

Source Distribution

graphsense_python-2.9.8.tar.gz (77.8 kB view details)

Uploaded Source

Built Distribution

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

graphsense_python-2.9.8-py3-none-any.whl (175.1 kB view details)

Uploaded Python 3

File details

Details for the file graphsense_python-2.9.8.tar.gz.

File metadata

  • Download URL: graphsense_python-2.9.8.tar.gz
  • Upload date:
  • Size: 77.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for graphsense_python-2.9.8.tar.gz
Algorithm Hash digest
SHA256 d574b18ba979bd5bad086a717ab3c1dece0ae138ef0162d059f2ecf87c8f6750
MD5 298829ed90a9ee3d6bc10807990c19da
BLAKE2b-256 2d9a9a496354eb4b16e1e1a8dfd33ce00f2a560787251e18c2cc2341d5b454c2

See more details on using hashes here.

File details

Details for the file graphsense_python-2.9.8-py3-none-any.whl.

File metadata

  • Download URL: graphsense_python-2.9.8-py3-none-any.whl
  • Upload date:
  • Size: 175.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.10.12 {"installer":{"name":"uv","version":"0.10.12","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for graphsense_python-2.9.8-py3-none-any.whl
Algorithm Hash digest
SHA256 f827d93a7d1ba66ec8f1239b7f0bd61428a224cb364afe9d279515d03fe8e219
MD5 8c0aaa04d19b3ae76469563f93a6b4ae
BLAKE2b-256 180462291eee710b70154b0e373961f5b6b393f42c20958fc9a4c4bd5c6abc1b

See more details on using hashes here.

Supported by

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