{"id":31923389,"url":"https://github.com/fuellabs/fuel-lst-queries","last_synced_at":"2026-08-01T14:32:28.947Z","repository":{"id":294713759,"uuid":"877926196","full_name":"FuelLabs/fuel-lst-queries","owner":"FuelLabs","description":null,"archived":false,"fork":false,"pushed_at":"2025-09-18T22:18:42.000Z","size":9,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-02T07:47:56.922Z","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/FuelLabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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,"zenodo":null}},"created_at":"2024-10-24T13:33:13.000Z","updated_at":"2024-11-11T02:17:01.000Z","dependencies_parsed_at":"2025-05-21T18:34:21.891Z","dependency_job_id":"e6516919-f0dd-488a-b8fe-aa3abc03daa7","html_url":"https://github.com/FuelLabs/fuel-lst-queries","commit_stats":null,"previous_names":["fuellabs/fuel-lst-queries"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/FuelLabs/fuel-lst-queries","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuelLabs%2Ffuel-lst-queries","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuelLabs%2Ffuel-lst-queries/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuelLabs%2Ffuel-lst-queries/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuelLabs%2Ffuel-lst-queries/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FuelLabs","download_url":"https://codeload.github.com/FuelLabs/fuel-lst-queries/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FuelLabs%2Ffuel-lst-queries/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36160599,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-08-01T02:00:05.789Z","response_time":100,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2025-10-13T23:50:13.245Z","updated_at":"2026-08-01T14:32:28.939Z","avatar_url":"https://github.com/FuelLabs.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LST Queries POC\n\n## Background\n\nFuel is working with OpenBlock (OBL) and Sentio to run its points program. OpenBlock has designed the methodology and Sentio is indexing the data on behalf of all participating protocols.\n\nThis project builds on top of Sentio's indexing solution and allows partners to query Sentio's APIs to get the data they need to understand the state of assets on the network, insofar as Fuel has visibiliy based on its own points program.\n\n## Note on Usage\n\nWith the exception of new wallet relationships via bridging, data updates only occur once per hour. So you will not see real-time data. The data is updated at the top of the hour.\n\nPlease be polite with API call frequency. We are not currently rate limiting, but that or API key revocation may occur if there is abuse.\n\n## Project Setup\n\n### Obtaining an API Key\n\nOnly specific partners will be given access to the API. Please reach out to the Fuel team to get an API key.\n\n### Set Up Python Environment\n\nFollow one of many online tutorials to do this. You can use `virtualenv`, `conda`, or Docker to do this.\n\n### Install Dependencies\n\n```bash\npip install -r requirements.txt\n```\n\n### Set Up Environment Variables\n\nIn constants.py, you have the following variables:\n\t\n```python\n# To access Sentio API\n# As protocols expand, we may have to move API keys inside the\n# QUERY_INFO dictionary to grant access to multiple projects.\nAPI_KEY = \"YOUR_API_KEY\"\n\n# If you generate any custom SQL for your own needs, you will have to\n# store the sql in the queries directory and add references to the project\n# and the query here.\nQUERY_INFO = {...}\n```\n\nYou are welcome to use any method you wish to keep private data private - secrets managers, local environment varibles, etc.\n\n### Getting Data\n\nYou can run the following command to get data from Sentio's API:\n\n```bash\npython3 example.py\n```\n\nIt will run through multiple types of queries and print the results to the console.\n\nExample data is like this:\n\n```python\n{\n  \"asset-balance\": {\n    \"columnTypes\": {\n      \"block_date\": \"STRING\",\n      \"chain_id\": \"STRING\",\n      \"timestamp\": \"TIME\",\n      \"token_address\": \"STRING\",\n      \"token_amount\": \"NUMBER\",\n      \"token_symbol\": \"STRING\",\n      \"user_address\": \"STRING\"\n    },\n    \"rows\": [\n      {\n        \"block_date\": \"2024-10-19\",\n        \"chain_id\": \"9889\",\n        \"timestamp\": \"2024-10-19T12:00:00Z\",\n        \"token_address\": \"0xf8f8b6283d7fa5b672b530cbb84fcccb4ff8dc40f8176ef4544ddb1f1952ad07\",\n        \"token_amount\": \"0.0902355\",\n        \"token_symbol\": \"ETH\",\n        \"user_address\": \"0x00017a92ed054f04c6dc7594a58974993569156f02f8de16b9d10c472bcf0546\"\n      },\n      {\n        \"block_date\": \"2024-10-19\",\n        \"chain_id\": \"9889\",\n        \"timestamp\": \"2024-10-19T21:00:00Z\",\n        \"token_address\": \"0xf8f8b6283d7fa5b672b530cbb84fcccb4ff8dc40f8176ef4544ddb1f1952ad07\",\n        \"token_amount\": \"0.005\",\n        \"token_symbol\": \"ETH\",\n        \"user_address\": \"0x000197cf361a202c3c17b8efd740d1df58967798a24a0b42b9725b2f8ca0e18d\"\n      },\n\t  ...\n\t]\n  },\n  \"\u003cquery-type-2\u003e\": {\n  \t# Same format as above\n  },\n  ...\n}\n\n```\n\nRaw hourly data for `asset-balance` queryies will become large, so we recommend running transformations and points calculations via code rather than SQL to enable easier batching and scalability. Sentio's API will time out for queries that are too large.\n\nThe python [pandas library resampling](https://pandas.pydata.org/docs/user_guide/timeseries.html#resampling) can be useful to convert the data to the periodicity of your choosing.\n\n## Notes:\n\nThis repo is provided as is and with all faults. The user of the repo assumes the entire risk as to the quality and performance of the repo. Fuel is not responsible for any damages of any kind, including consequential damages, arising from the use of the repo.\n\n## License\n\nThis repo is licensed under the `Apache-2.0` license. See [`LICENSE`](./LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuellabs%2Ffuel-lst-queries","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffuellabs%2Ffuel-lst-queries","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffuellabs%2Ffuel-lst-queries/lists"}