{"id":19336585,"url":"https://github.com/subsquid/ape-subsquid","last_synced_at":"2025-06-30T02:37:06.698Z","repository":{"id":212725103,"uuid":"730731938","full_name":"subsquid/ape-subsquid","owner":"subsquid","description":null,"archived":false,"fork":false,"pushed_at":"2024-02-15T13:58:23.000Z","size":62,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-02-24T08:13:05.333Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/subsquid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-12T14:53:59.000Z","updated_at":"2024-05-03T22:26:40.000Z","dependencies_parsed_at":"2024-01-11T07:22:46.256Z","dependency_job_id":"16d43f90-7921-43e9-b467-6f31722b8264","html_url":"https://github.com/subsquid/ape-subsquid","commit_stats":null,"previous_names":["tmcgroul/ape-subsquid","subsquid/ape-subsquid"],"tags_count":0,"template":false,"template_full_name":"ApeWorX/project-template","purl":"pkg:github/subsquid/ape-subsquid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fape-subsquid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fape-subsquid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fape-subsquid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fape-subsquid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/subsquid","download_url":"https://codeload.github.com/subsquid/ape-subsquid/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/subsquid%2Fape-subsquid/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262699904,"owners_count":23350390,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-10T03:11:42.621Z","updated_at":"2025-06-30T02:37:06.659Z","avatar_url":"https://github.com/subsquid.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quick Start\n\nThis plugin allows to use [subsquid data lake](https://docs.subsquid.io/subsquid-network/overview/) as a backend for ApeWorX query engine. [Full documentation](https://docs.subsquid.io/apeworx/)\n\n## Dependencies\n\n- [python3](https://www.python.org/downloads) version 3.8 up to 3.11.\n\n## Installation\n\n### via `ape plugins`\n\n```bash\nape plugins install \"ape-subsquid@git+https://github.com/subsquid/ape-subsquid.git@main\"\n```\n\n### via `pip` locally\n\nYou can clone the repository and install the plugin locally:\n\n```bash\ngit clone https://github.com/subsquid/ape-subsquid.git\npip install ./ape-subsquid\n```\n\n## Quick Usage\n\nIf we want to be sure that subsquid engine is used then we have to specify it explicitly. Otherwise other query engines might be preferred depending on their estimated time.\n\nThe following queries can be executed via ApeWorX interactive console. Use `ape console --network ethereum:mainnet:geth` to run a console session.\n\n```python\n# BlockQuery\nchain.blocks.query(\"*\", start_block=18_000_000, stop_block=18_000_010, engine_to_use='subsquid')\n\n# ContractEventQuery\ncontract = Contract('0xdac17f958d2ee523a2206206994597c13d831ec7', abi='\u003cUSDT_ABI\u003e')\ncontract.Transfer.query('*', start_block=18_000_000, stop_block=18_000_100, engine_to_use='subsquid')\n```\n\nSupported queries are: `BlockQuery`, `AccountTransactionQuery`, `ContractCreationQuery`, `ContractEventQuery`.\nMore info about querying data can be found in the [corresponding guide](https://docs.apeworx.io/ape/stable/userguides/data.html).\n\n## Development\n\nPlease see the [contributing guide](CONTRIBUTING.md) to learn more how to contribute to this project.\nComments, questions, criticisms and pull requests are welcomed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubsquid%2Fape-subsquid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsubsquid%2Fape-subsquid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsubsquid%2Fape-subsquid/lists"}