OilpriceAPI/python-sdk holds a health index of 65 out of 100, placing it in the Moderate band. It scores highest on Vitality (81/100) and lowest on Community & Adoption (42/100). It was last updated 4 days ago. A single contributor accounts for most of its recent work.
65
overall / 100
Moderate
Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
65
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
Direct dependencies free of known advisories — no direct dependency carries a known advisory
25/25
Indirect dependencies free of known advisories — no indirect dependency carries a known advisory
0/40
No advisories left outstanding — no advisory carries a publication date
Inputs used
source
osv
advisories
0
affected_packages
0
assessed_packages
13
unassessed_packages
0
affected_by_severity
none
direct_affected_packages
0
Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:oilpriceapi@1.11.0 runtime dependency closure — what installing the published package pulls in — 13 packages. Reachability is not analyzed.
How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.
Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
More detail
Star and fork history 0 ★ / 2 ⇿
0Stars
2Forks
When each star and fork was added, collected from GitHub and bucketed by day. Cumulative growth sits directly above the daily additions it is made of, so the two read against each other: steady organic accretion looks nothing like an abrupt, short-lived burst. Where that difference is measurable, it is reported as growth authenticity.
OpenSSF Scorecard 5.6 / 10
5.6aggregate
Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).Scorecard v5.5.0 · 2026-07-29 23:53 UTC
Full resolved dependency set from the GitHub dependency graph: 3 direct and 17 indirect (transitive) packages. The transitive closure is complete when the repository commits a lockfile.
Registry
Package
Version
Relation
PyPI
httpx
—
direct
PyPI
pydantic
—
direct
PyPI
python-dateutil
—
direct
PyPI
black
—
indirect
PyPI
cachetools
—
indirect
PyPI
click
—
indirect
PyPI
jsonschema
—
indirect
PyPI
mypy
—
indirect
PyPI
numpy
—
indirect
PyPI
pandas
—
indirect
PyPI
pre-commit
—
indirect
PyPI
pytest
—
indirect
PyPI
pytest-asyncio
—
indirect
PyPI
pytest-cov
—
indirect
PyPI
pytest-timeout
—
indirect
PyPI
redis
—
indirect
PyPI
rich
—
indirect
PyPI
ruff
—
indirect
PyPI
setuptools
—
indirect
PyPI
websockets
—
indirect
Dependency advisories 0
Installing pypi:oilpriceapi@1.11.0 pulls in 13 packages, direct and transitive: 0 carry known advisories, of which 0 are direct dependencies.
No known advisories affect the assessed dependencies.
An advisory means the version recorded in the dependency graph falls inside an advisory’s affected range. Reachability is not analysed, and the graph includes development and test pins — a finding may concern tooling rather than shipped software.
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"api-client",
"async",
"energy",
"oil-prices",
"pydantic",
"python",
"sdk",
"trading",
"commodity-prices",
"commodities",
"financial-data",
"wti",
"brent-crude",
"commodity-data",
"energy-api",
"natural-gas",
"oil-price",
"openbb",
"pypi"
],
"is_fork": false,
"size_kb": 14120,
"has_wiki": false,
"homepage": "https://pypi.org/project/oilpriceapi/",
"languages": {
"Shell": 3169,
"Python": 745054,
"PowerShell": 9033
},
"pushed_at": "2026-07-25T18:29:06Z",
"created_at": "2025-09-29T20:05:12Z",
"owner_type": "Organization",
"updated_at": "2026-07-25T18:29:10Z",
"description": "Official Python SDK for source-timestamped OilPriceAPI energy data with typed recovery and executable capability metadata",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "Python",
"significant_languages": [
"Python"
]
},
"owner": {
"blog": "https://www.oilpriceapi.com",
"name": "OilPriceAPI",
"type": "Organization",
"login": "OilpriceAPI",
"company": null,
"location": "United States of America",
"followers": 7,
"avatar_url": "https://avatars.githubusercontent.com/u/152923419?v=4",
"created_at": "2023-12-04T20:40:00Z",
"is_verified": null,
"public_repos": 18,
"account_age_days": 968
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v1.11.0",
"kind": "minor",
"published_at": "2026-07-19T16:37:47Z"
},
{
"tag": "v1.10.2",
"kind": "patch",
"published_at": "2026-07-16T13:16:43Z"
},
{
"tag": "v1.10.1",
"kind": "patch",
"published_at": "2026-07-03T14:13:33Z"
},
{
"tag": "v1.10.0",
"kind": "minor",
"published_at": "2026-07-03T11:02:09Z"
},
{
"tag": "v1.9.0",
"kind": "minor",
"published_at": "2026-06-21T21:14:37Z"
},
{
"tag": "v1.8.1",
"kind": "patch",
"published_at": "2026-06-21T17:13:21Z"
},
{
"tag": "v1.8.0",
"kind": "minor",
"published_at": "2026-06-21T16:42:38Z"
},
{
"tag": "v1.7.1",
"kind": "patch",
"published_at": "2026-06-21T09:47:47Z"
},
{
"tag": "v1.7.0",
"kind": "minor",
"published_at": "2026-03-29T18:10:37Z"
},
{
"tag": "v1.6.0",
"kind": "minor",
"published_at": "2026-03-18T11:18:13Z"
},
{
"tag": "v1.0.0",
"kind": "major",
"published_at": "2025-09-29T20:52:10Z"
}
],
"recent_commits": [
{
"oid": "f7b92634173dd9c86cdc5e078cba2019bca6cd38",
"body": null,
"is_bot": false,
"headline": "feat: validate dates and guide commodity codes (#76)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T18:29:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "205078857734a1b510379cd2258ffb3e208517b2",
"body": null,
"is_bot": false,
"headline": "docs: replace speculative canary process with release gate (#75)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T18:16:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c2f6a882b1aa483815b9191e8c83a1a25a7c224f",
"body": null,
"is_bot": false,
"headline": "fix: replace flaky SDK health job with bounded synthetic (#74)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T18:12:58Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8a061ef2b544d729dddb0b8be27956ef21c9fedf",
"body": null,
"is_bot": false,
"headline": "fix: preserve dataframe context across pages (#73)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T17:36:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fa86d807bccce739717c3409cf040a557efd342f",
"body": "* feat: normalize API error contracts\n\n* fix: address error contract review",
"is_bot": false,
"headline": "feat: normalize API error contracts (#72)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-25T17:27:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2592030d6f6339e9a305042ac4bb3bd39cd3d076",
"body": "Updates the requirements on [jsonschema](https://github.com/python-jsonschema/jsonschema) to permit the latest version.\n- [Release notes](https://github.com/python-jsonschema/jsonschema/releases)\n- [Changelog](https://github.com/python-jsonschema/jsonschema/blob/main/CHANGELOG.rst)\n- [Commits](https\n[…]\ndency-version: 4.26.0\n dependency-type: direct:development\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps-dev): update jsonschema requirement (#69)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-25T17:06:23Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "9edbb85854fed2780f57dff4c894d8038abe4eb9",
"body": "Bumps [actions/setup-python](https://github.com/actions/setup-python) from 6 to 7.\n- [Release notes](https://github.com/actions/setup-python/releases)\n- [Commits](https://github.com/actions/setup-python/compare/v6...v7)\n\n---\nupdated-dependencies:\n- dependency-name: actions/setup-python\n dependency-\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): bump actions/setup-python from 6 to 7 (#68)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-25T17:06:20Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "fdc4bde8589be43ce17b4a98515bbe11d599f9f1",
"body": "Bumps [actions/upload-artifact](https://github.com/actions/upload-artifact) from 4 to 7.\n- [Release notes](https://github.com/actions/upload-artifact/releases)\n- [Commits](https://github.com/actions/upload-artifact/compare/v4...v7)\n\n---\nupdated-dependencies:\n- dependency-name: actions/upload-artifac\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): bump actions/upload-artifact from 4 to 7 (#67)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-25T17:06:17Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "32791c08ad735cb642a3766e22e53f436ef1c8d0",
"body": "Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 7.\n- [Release notes](https://github.com/actions/checkout/releases)\n- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)\n- [Commits](https://github.com/actions/checkout/compare/v4...v7)\n\n---\nupdated-dependenc\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): bump actions/checkout from 4 to 7 (#59)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:46Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "770ecdf9615d705b90c60abd57997096c2549231",
"body": "Bumps [actions/configure-pages](https://github.com/actions/configure-pages) from 4 to 6.\n- [Release notes](https://github.com/actions/configure-pages/releases)\n- [Commits](https://github.com/actions/configure-pages/compare/v4...v6)\n\n---\nupdated-dependencies:\n- dependency-name: actions/configure-page\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/configure-pages from 4 to 6 (#58)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:43Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "b33414f052cf7e1c9f56973615dad3210e26249f",
"body": "Bumps [actions/upload-pages-artifact](https://github.com/actions/upload-pages-artifact) from 3 to 5.\n- [Release notes](https://github.com/actions/upload-pages-artifact/releases)\n- [Commits](https://github.com/actions/upload-pages-artifact/compare/v3...v5)\n\n---\nupdated-dependencies:\n- dependency-name\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/upload-pages-artifact from 3 to 5 (#57)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:40Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7f44d08c265ad6dc18fe23ce9acc471b1d35a1b1",
"body": "Bumps [actions/setup-python](https://github.com/actions/setup-python) from 5 to 6.\n- [Release notes](https://github.com/actions/setup-python/releases)\n- [Commits](https://github.com/actions/setup-python/compare/v5...v6)\n\n---\nupdated-dependencies:\n- dependency-name: actions/setup-python\n dependency-\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/setup-python from 5 to 6 (#56)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:36Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "183412826c71204271ec9871104d1091c0f246cb",
"body": "Bumps [actions/deploy-pages](https://github.com/actions/deploy-pages) from 4 to 5.\n- [Release notes](https://github.com/actions/deploy-pages/releases)\n- [Commits](https://github.com/actions/deploy-pages/compare/v4...v5)\n\n---\nupdated-dependencies:\n- dependency-name: actions/deploy-pages\n dependency-\n[…]\nirect:production\n update-type: version-update:semver-major\n...\n\nSigned-off-by: dependabot[bot] <support@github.com>\nCo-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>",
"is_bot": true,
"headline": "chore(deps): Bump actions/deploy-pages from 4 to 5 (#55)",
"author_name": "dependabot[bot]",
"author_login": "dependabot[bot]",
"committed_at": "2026-07-19T19:59:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "028ecccc908338fb5a0952afe5d49f916ec8da61",
"body": null,
"is_bot": false,
"headline": "docs: correct PyPI source accuracy (#66)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-19T16:36:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c872371ac85e1a19f3f63247291574fa2d1d793c",
"body": null,
"is_bot": false,
"headline": "fix: make exported snippets standalone (#64)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-19T11:25:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fd826218450d5a346b5d2c789e20cbe64c603914",
"body": null,
"is_bot": false,
"headline": "feat: publish executable snippet manifest (#63)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-19T11:12:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "fc2cc0b2ead792d4bb10bebb27fe76758c660d4e",
"body": "The repo had no dependabot.yml. Runtime deps are floor-pinned ranges so\nusers already get current releases; this keeps the CI actions and dev\ntoolchain from drifting silently.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: add dependabot config (pip + github-actions, weekly) (#54)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-16T13:16:17Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "b30c213d694a4f8e9e161a49107981df60c8525c",
"body": "… (#48) (#53)\n\n- live-tests.yml: split into (1) an always-run keyless demo smoke against\n /v1/demo/* with no secret and no gate, and (2) the keyed live suite,\n which now warns loudly (::warning::) instead of silently exiting when\n the secret is unavailable.\n- weekly-health.yml: export the secret \n[…]\nct.py: unknown commodity codes now return HTTP 400\n invalid_code (was 404) — update the two stale contract tests to the\n current API contract.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: tier live smokes so keyless demo coverage can never silently skip…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-16T13:16:07Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "1973bd74f8a4d5378e142af6846746f71698e10c",
"body": "Includes the well production resource work, removes exposed API tokens, and adds CI coverage to block hardcoded OilPriceAPI-shaped tokens.",
"is_bot": false,
"headline": "Add well production resource and secret guard",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-16T01:06:12Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6cfa2d8a2fd96bb77019e002d2d5bb1a82cb1f74",
"body": "…ing (#4175) (#51)\n\nSource fields are already free-string typed (no venue enum to loosen); this\naligns example/fixture source values with the API switch to market_reporting\nmasked labels (government labels like EIA/opec.org unchanged). Version bumped\n(patch, unpublished).\n\nCo-authored-by: Claude Opus 4.8 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: drop venue-typed source enums; align examples with market_report…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-10T14:20:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "1c932974357d6565af6a4df34d8702a9c779f219",
"body": "* docs: registry storefront README + v1.10.1\n\nApply the shared registry-storefront formula from the PHP SDK:\n- hero line (oil/gas/LNG/carbon/fuels in under 60 seconds) + audience line + 2M+ requests/month\n- shields.io pypi/v badge, nav line with utm_source=python-sdk and quick-start jump link\n- \"Wha\n[…]\nr explorer and raw\nOpenAPI spec from the README (they existed, unadvertised).\n\nCo-Authored-By: Claude Fable 5 <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: registry storefront README + v1.10.1 (#49)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T14:12:20Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "06d9d49a5c3a07ae8996583a7bfaa53de05568da",
"body": "… (#47)\n\nREADME: add 'Beyond Oil — Gas, LNG, Carbon & Fuels' right after the first\nquick-start example — EU_CARBON_EUR spot, ttf-gas futures curve, RTM bunker\nport prices — naming the maritime-compliance (EU ETS/FuelEU), fleet/logistics,\nLNG/European-gas and CBAM audiences. All calls verified agains\n[…]\nhout it)\n\nVerified locally: unit suite 303 passed / 10 skipped; both exact CI commands\nexit 0 with no key (18/22 skipped); workflow YAML parses.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: embedder-segment quick start + fix weekly-health workflow (#44)…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T11:15:34Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "53969a17e43f218127d906d4c1c4fa4ace03f576",
"body": "…e promised (#43) (#46)\n\n- version 1.9.0 → 1.10.0 (analysis module landed after the 1.9.0 tag;\n README advertised it but PyPI 1.9.0 doesn't contain it)\n- README: indicators claim now says v1.10.0; fixed 3 dead\n docs.oilpriceapi.com/sdk/python links (404) → docs root\n- CHANGELOG: [Unreleased] → [1.\n[…]\n - 2026-07-03\n- test_demo_contract: un-pin exact catalog count (442 → floor of 400;\n live catalog is 436 today — curation shouldn't fail tests)\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "release: v1.10.0 — ship the technical-indicators module pip users wer…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T11:02:07Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "e3b1020dc0720c225e94b8eaa67803df7d182129",
"body": "…#45)\n\n37 files: customer email lists (PII), outreach drafts, Reddit/marketing\nplans, QA session artifacts, internal strategy docs, and a customer-named\ntest file. All are session artifacts, not SDK documentation. Archived\ninternally before removal. History scrub tracked separately in #42.\n\nCo-authored-by: Claude Fable 5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: remove internal docs and customer PII from public repo (#42) (…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-07-03T11:01:16Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "b9ddeb856b5ae55421ab749e49ef74edea1ff013",
"body": "Add `client.analysis` (AnalysisResource) with SMA, EMA, RSI, MACD,\nBollinger Bands, and ATR. Supports both the DataFrame helper\n(`with_indicators(df, indicators=[...])`, non-mutating) and direct\nper-Series calculation. Pure pandas/numpy implementation with no new\nhard dependencies; pandas remains th\n[…]\nll unit coverage (12 tests, analysis.py at ~87%), README\ndocumentation with examples for both usage styles, and a CHANGELOG entry.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(analysis): add technical indicators module (Closes #3) (#41)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T11:46:29Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "242c450bca4341fb47ae8fca4de2a52987abb5e9",
"body": "… doc contract tests (#39)\n\nCloses #26.\n\nThe SDK Performance Guide content already existed at docs/PERFORMANCE_GUIDE.md\nbut was undiscoverable: the README did not link to it and it was absent from\nthe mkdocs site navigation. This makes the guide reachable and locks all five\nissue acceptance criteria\n[…]\nnd nav\n discoverability.\n\nTDD: tests written first; 2 of 7 failed (README link + mkdocs nav) before the\nfix and all 7 pass after.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(performance): wire performance guide into README + docs nav, add…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T11:26:43Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8e67190eaa17483f2b64405152c17f0d7a269b30",
"body": "Every SDK request must identify itself to the API for adoption tracking.\nThe sync and async clients already sent X-SDK-Name and X-SDK-Version but\nomitted X-SDK-Language and X-Client-Type, so 0/166 recent requests could be\nattributed to the Python SDK vs raw python-httpx/python-requests calls.\n\nAdd t\n[…]\nPI clients:\n\n X-SDK-Language: python\n X-Client-Type: sdk\n\nChange is additive (4 lines) and does not alter existing behavior.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(telemetry): send X-SDK-Language and X-Client-Type headers (#4) (#40)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T11:26:39Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8c9a0c9ae47fb17551bfbbba581d221bb2158119",
"body": "The integration/live tests hit the real API with a single 1-request/second\nkey that is shared across SDK repos in CI. Cross-repo contention produces\nHTTP 429 (RateLimitError) responses that fail otherwise-green code.\n\nAdd a `live_call` fixture in tests/integration/conftest.py that:\n- spaces live cal\n[…]\n\ntest_historical_endpoints.py through this helper. The existing\nskip-if-no-OILPRICEAPI_KEY behavior is preserved. No version bump.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: skip live tests on 429 (shared-key rate-limit resilience) (#38)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-22T09:15:37Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "f0ceb5b191c29cd8eba99687d1f8ad5c0cc823e6",
"body": "…(#37)\n\nAdd SDK support for the now-live #3245 endpoints on both the sync and\nasync clients:\n\n- client.market_brief(codes, narrative=False) -> MarketBrief\n- client.subscriptions.list() / .create() / .delete() / .events()\n with friendly interval mapping (\"5m\"/\"1h\"/\"daily\" -> interval_seconds)\n and \n[…]\nILPRICEAPI_TEST_KEY, no prod writes).\n\nVersion bumped 1.8.1 -> 1.9.0.\n\nGates: mypy clean, ruff clean, pytest 311 passed (cov 59%).\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: market-brief + agent-subscription methods (sync+async, v1.9.0) …",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T21:14:32Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "95e47b136362d96833b1a1b9b4debff564a3dfe3",
"body": "* docs: normalize legacy plan names to current tiers\n\nReplace legacy tier names (Exploration / Production Boost / Reservoir\nMastery) in customer-facing docs and the QA issue-generator script with\nthe current billing tiers: Developer ($19/10K), Starter ($49/50K,\nwebhooks), Professional ($99/100K, web\n[…]\no the existing streaming unit test still matches.\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: normalize legacy plan names to current tiers (#36)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T17:27:52Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "a4c110e5d1a11add0ba56881fbca495f61c53fc9",
"body": "* fix: futures slug normalization + live CI tests (v1.8.1)\n\nFutures endpoints are keyed by slug (ice-brent, ice-wti, ...), not raw\nexchange contract code. The old docstrings advertised \"CL.1\" which would\nhit /v1/futures/CL.1 and 404. Add contract-code -> slug normalization so\ncallers can pass either\n[…]\nutil import passes mypy in both local and CI envs\n\nCo-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: futures slug normalization + live CI tests (v1.8.1) (#35)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T17:09:37Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9c107d44e47fca0870b3a68c458d8dd26d1e3f03",
"body": "…n) (#34)\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: release 1.8.0 (WebSocket streaming + param fixes + typing-clea…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T16:42:33Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "0c121a7fa1cf4160e8d0bf4defeca31ef33d37fb",
"body": "…ests (#33)\n\nTask 1 — typing-debt paid down: fixed the real type errors in client,\nasync_client, cli, telemetry, prices, alerts, analytics, data_sources,\nwebhooks and the package __init__ with proper annotations (not type: ignore),\nthen removed all 10 TODO(typing-debt) per-module mypy overrides. The\n[…]\nsts cover the accessor.\n\nGates: mypy clean, ruff clean (oilpriceapi/), 249 unit tests pass, cov 57.38%\n(>=50). Version not bumped.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: pay down mypy typing-debt + param audit + live demo contract t…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T16:01:05Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "f2b1b35b9c2fc5da3548f4a1ed65e8a39973e4a4",
"body": "Add a real-time streaming client for the OilPriceAPI Rails ActionCable\nendpoint (/cable, EnergyPricesChannel), exposed via the async SDK as\n`client.stream`.\n\n- Implements the ActionCable JSON subprotocol: welcome -> subscribe ->\n confirm_subscription -> message; pings/control frames filtered.\n- Tok\n[…]\ns (39 files), pytest 240 passed /\n9 skipped, coverage 55.9% (>= 50% threshold). New streaming modules:\nclient 92.6%, models 95.4%.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: async WebSocket streaming client (#32)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T15:23:04Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "742cc029d072127fb444dca025f32c0a448dba9e",
"body": "…ions (#31)\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: green CI — mypy python_version + sync forecasts/drilling annotat…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T14:52:08Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3b83e8095533ac49d0b49103ae4341f5413c86f8",
"body": "Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: bump version to 1.7.1 for PyPI release (#30)",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T09:47:35Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9f68a1b595edb239017c7acda07d6313d2a0d1a6",
"body": "… (#29)\n\nThe \"Publish to PyPI\" workflow was blocked: its pytest gate had 11\nfailures and coverage sat below the 50% threshold, so the package was\nstuck at 1.6.2 while pyproject was at 1.7.0.\n\nRoot causes and fixes:\n\n1. Schema drift on `currency` (models.py)\n - Price.currency and HistoricalPrice.cu\n[…]\ne result: 227 passed, 9 skipped, coverage 52.90% (exit 0).\nruff check oilpriceapi/ passes. `pytest --timeout=60` no longer errors.\n\nCo-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: green publish gate + add pytest-timeout so PyPI publish can ship…",
"author_name": "karlwaldman",
"author_login": "karlwaldman",
"committed_at": "2026-06-21T09:45:40Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "9c6c1f3d75b53e3cf6b61c2cd3d79e1c3c963a68",
"body": "…sync telemetry\n\n- Fix 656 ruff lint errors (auto-fix + config updates for pre-existing style issues)\n- Add 429 auto-retry to request_with_headers() (was missing)\n- Add enable_telemetry param + tracking to AsyncOilPriceAPI\n- Extract shared validators to resource_validators.py\n- Update pyproject.toml ruff config to ignore pre-existing style debt\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: Pass ruff lint checks, fix request_with_headers 429 retry, add a…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-29T18:13:59Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "362b118d4b13ff7c8b92337cb720b9a17343e7da",
"body": "Major improvements:\n\n- Full async client: all 16 resources now available on AsyncOilPriceAPI (was 2)\n- Add 429 auto-retry with Retry-After header support (capped at 60s)\n- Add webhook signature verification (verify_signature + standalone export)\n- Add oilprice CLI tool (price, historical, commoditie\n[…]\nync duplication)\n- Make lint/mypy blocking in CI (removed continue-on-error)\n- Add coverage enforcement gate (--cov-fail-under=50)\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: v1.7.0 — World-class SDK upgrade",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-29T18:08:45Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "97c49d3457dce37143441b38a182e315acd6b26a",
"body": "… in historical\n\n1. get_all(): Handle nested dict response from /v1/prices/all\n (data.data.prices is a dict keyed by commodity, not a list)\n2. historical: Use request_with_headers() + X-Total-Pages header\n for reliable pagination detection (was using per_page comparison)\n3. historical: Pass curr\n[…]\nrequesting 1000)\n\nVerified: EU_CARBON_EUR returns 1,603 rows (EUR), NATURAL_GAS_GBP\nreturns 2,974 rows (GBP) with auto-pagination.\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: get_all() response parsing, historical auto-pagination, currency…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-18T11:28:38Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "35a6b57a4fa12478f022a76ec05831b3e38053ac",
"body": "1. get_all() now correctly maps API response currency field to Price\n model (was always defaulting to USD regardless of actual currency)\n2. get_all() auto-paginates using X-Has-Next response header\n3. to_dataframe() accepts per_page parameter, forwarded to get_all()\n\nFixes: customers getting USD f\n[…]\n EUR/GBP commodities in to_dataframe(),\nand pagination capping results at 500 rows.\n\nReported by Jens Baetens (Entras BV) — twice.\n\nCo-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: currency preservation + auto-pagination in to_dataframe()",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-18T11:17:49Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "5b0bfa54f5f72b4ee37e245dc3664e5f34e97ba8",
"body": "Updated README with UTM attribution links and cross-channel promotion\nnow live on PyPI.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: bump version to 1.5.1 for PyPI README update",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-08T11:21:52Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "506226e4f9072e0fc6260a6e58c37473efb3f022",
"body": "Enable attribution tracking for PyPI/Python SDK channel by adding\nutm_source=pypi&utm_medium=sdk&utm_campaign=readme to all signup\nand pricing links. Added \"Also Available As\" cross-promotion section.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add UTM tracking parameters to all signup and pricing links",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-03-08T10:37:25Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "4205358539fa736f15f081fbc68ced15685ab073",
"body": "conftest.py in those dirs imports python-dotenv (not in dev deps).\npytest collects conftest even with -m exclusion. Use --ignore instead.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(ci): Ignore integration/contract test dirs in CI",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T14:06:45Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "87d7602e4ca015cb3c54a21762f622aa80321be2",
"body": "336 pre-existing lint errors in source. Lint is advisory until codebase\nis cleaned up. Tests remain the blocking gate for releases.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(ci): Make lint non-blocking (pre-existing errors)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T14:04:11Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "36d7154afd514086458982065a6b0ea9f9bfc15d",
"body": "Pre-existing lint issues in test files (613 errors) were causing CI\nfailure. Scope lint to oilpriceapi/ package only.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(ci): Scope ruff lint to source code only",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T14:02:11Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "ba293de856cd8c52530b84c2e45ea0b7fc52c42c",
"body": "Add CI test workflow (Python 3.9-3.12 matrix), weekly integration health\ncheck, and require tests pass before PyPI publish.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: Add test pipeline and publish gate",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-14T13:59:56Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "6558a00af44918b63896e3c90061570909fdf5fa",
"body": "Align pyproject.toml version with __init__.py (1.4.3 → 1.5.0).\nDocument all 13 new resource modules, diesel fix, and test improvements.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: Update version to 1.5.0 and add CHANGELOG entry",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T13:13:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3197c18a6dcd80c22f23396590a58a4740c81232",
"body": "Fix diesel validation (empty string handling) and alerts test method\nrename. Add unit tests for commodities, futures, storage, rig counts,\nbunker fuels, analytics, forecasts, data quality, drilling, webhooks,\nand data sources. 222 pass, 0 fail, 60% coverage.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "test: Fix 18 failing tests and add 84 new tests for all resources",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T12:59:18Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "40c30c2b7f5c1ad721eb37cde7784e24e3d7b363",
"body": "Document commodities, futures, storage, rig counts, bunker fuels,\nanalytics, drilling intelligence, energy intelligence, webhooks,\nforecasts, data quality, and data sources resources. Version 1.5.0.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: Update README with all 13 resource modules and usage examples",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T12:30:49Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9629d1cbc739171255ca3e4a1e71223a4274156d",
"body": "…sources resources and enhance alerts\n\nPhase 3 of SDK gap analysis: adds 11 new resource files covering drilling intelligence (10 methods),\nenergy intelligence sub-package with 7 modules (rig counts, oil inventories, OPEC production,\ndrilling productivity, forecasts, well permits, frac focus), webhooks CRUD (7 methods),\ndata sources CRUD (9 methods), and enhances alerts with test/triggers/analytics_history methods.\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add drilling intelligence, energy intelligence, webhooks, data …",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T11:40:39Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "5cf3bd8f7cff426387ae71ca972e542598108a2d",
"body": "…ig counts, bunker fuels, analytics, forecasts, and data quality\n\nPhase 2 of SDK gap analysis - expands Python SDK from 4 resources to 12, adding full coverage\nfor commodities, futures (7 methods), storage (5), rig counts (5), bunker fuels (6),\nanalytics (6), forecasts (4), and data quality (3).\n\nCo-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add 8 new resource modules for commodities, futures, storage, r…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-02-11T11:24:07Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3eb76a44e9814bdfbb9de5e628c552dd23d36766",
"body": "Add get_data_connector_prices() method and DataConnectorPrice model\nfor fetching prices from connected data sources (BYOS).\n\nNew model DataConnectorPrice with 8 fields:\n- price, currency, fuel_type, port, region, unit, source, timestamp\n\nSupports filtering by fuel_type, port, region, and since timestamp.\nRequires Data Connector feature enabled on organization.\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add Data Connector support for BYOS prices",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2026-01-25T11:58:58Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "268109e468233e002dfa427174231111f762bc00",
"body": "- Add app_url and app_name config options for SDK telemetry\n- Send X-SDK-Name, X-SDK-Version headers on every request\n- Send X-App-URL, X-App-Name headers when configured (10% bonus!)\n- Rename headers from X-Api-Client to X-SDK-Name for consistency\n- Bump version to 1.5.0\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add telemetry headers for app tracking (v1.5.0)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-27T18:52:59Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "aa35e8922fbc9d32d465a98c81ee1f305ee73901",
"body": "These test fixes address pagination-related assertion failures:\n- Relax record count assertions (API returns paginated results, 100/page)\n- Add timezone-aware datetime handling for date comparisons\n- Add conftest.py with .env loading for live API tests\n- Update comments explaining pagination behavio\n[…]\navior while still validating core functionality.\n\nTest results: 21/21 contract tests pass, 9/10 integration tests pass\nNo production code changes - tests only\n\nRelated to v1.4.3 historical timeout fix",
"is_bot": false,
"headline": "test: Fix contract/integration tests for API pagination behavior",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-17T10:19:02Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a7f7c399dbc8365429f6c5153a01b4960b01e882",
"body": "Q1 (Prevention - Urgent & Important):\n- #20: Integration tests with real API calls\n- #21: Performance baseline tests\n- #22: Pre-release validation automation\n- #23: Monitoring & alerting documentation\n\nQ2 (Long-term Quality - Important, Not Urgent):\n- #24: Opt-in SDK telemetry module\n- #25: API cont\n[…]\ntatus:\n- Tests: Ready to use immediately\n- Monitoring: Infrastructure ready (deployment optional)\n- Telemetry: Module ready (integration pending)\n\nResolves: #20, #21, #22, #23, #24, #25, #26, #27, #28",
"is_bot": false,
"headline": "feat: Complete Q1 & Q2 QA improvements (#20-28)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-17T09:49:06Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "31c0a9f88c1c80fa5e208804c3ea924a5e73945f",
"body": "BREAKING BUG FIX - ALL historical queries were returning wrong data:\n- Changed 'commodity' parameter to 'by_code' to match API expectation\n- Fixes issue where ALL historical queries returned BRENT_CRUDE_USD data\n- Impact: All v1.4.0-1.4.2 users were getting wrong commodity data\n\nThis parameter misma\n[…]\n.\nDate ranges and validation fixed in API separately.\n\nVersion: 1.4.2 → 1.4.3\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "Critical Fix: Historical API parameter name (v1.4.3)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-17T08:46:11Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "b421d50f0b31cb2750623f2b6af63c377d01b5a3",
"body": "Fixes 100% timeout rate on historical queries by implementing intelligent\nendpoint selection and dynamic timeout management.\n\nRoot Cause:\n- SDK hardcoded /v1/prices/past_year for all date ranges\n- 30s default timeout insufficient for year-long aggregations (actual: 67-85s)\n\nSolution:\n- Endpoint sele\n[…]\nmpatible)\n\nResolves: Customer issue from idan@comity.ai\nPublished: PyPI v1.4.2\n\n🤖 Generated with Claude Code (https://claude.com/claude-code)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Fix historical data timeout issue (SDK v1.4.2)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T23:11:25Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "ed5bfca8ed1339889050955a6c74f05065e558b8",
"body": "- Remove non-existent analysis module examples\n- Remove non-existent CLI tool section\n- Replace MockClient with working pytest examples\n- Replace broken example links with inline code\n- Update features list (remove vaporware, add actual features)\n- Add documentation status disclaimer\n- Fix all broke\n[…]\numentation accuracy improved from 65% to ~95%, matching Node.js SDK standard.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs: Remove vaporware features, improve accuracy to 95%",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T16:11:38Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "3c2f4ba98ea990709093875055904e8c0118428a",
"body": "- Add X-Api-Client header: 'oilpriceapi-python'\n- Add X-Client-Version header: '1.4.1'\n- Update User-Agent to include Python version\n- Remove deprecated X-SDK-Language, X-SDK-Version, X-Client-Type headers\n\nResolves: #8\nDocumentation: /home/kwaldman/code/sdks/EISENHOWER_MATRIX_PLAN.md",
"is_bot": false,
"headline": "Add SDK telemetry headers (v1.4.1)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T15:06:54Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "80d87242c72eb9f1ffa21b57d57adb11a7d77c1d",
"body": "Updated Available Commodities section:\n- Added new Coal section with all 8 endpoints\n- Organized into US Spot (3), International Futures (3), Historical (2)\n- Updated commodity count from \"all commodities\" to \"all 79 commodities\"\n- Grouped oil & gas commodities separately from coal for clarity\n\nCoal\n[…]\nternational: NEWCASTLE_COAL_USD, COKING_COAL_USD, CME_COAL_USD\n- Historical: NYMEX_APPALACHIAN_USD, NYMEX_WESTERN_RAIL_USD\n\nMakes Python SDK documentation consistent with complete coal API deployment.",
"is_bot": false,
"headline": "docs: Add 8 coal endpoints to Python SDK README",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T14:41:09Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "77fce4ed1f01c2c237e9d0eb0ac44763c1b0521a",
"body": "Critical fixes based on QA assessment and backend API verification:\n\nAPI Contract Fixes:\n- Fix list() to handle unwrapped array responses from API\n- Fix get() to handle direct object responses (not wrapped)\n- Fix create() to handle direct object responses\n- Fix update() to handle direct object respo\n[…]\nesponses (PriceAlertSerializer)\n- Confirmed API returns unwrapped responses\n- Verified routes.rb shows no test_webhook endpoint\n\nImpact: Prevents 100% failure rate on list/get/create/update operations",
"is_bot": false,
"headline": "fix: Update API response handling and disable test_webhook",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T09:54:29Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "86bd6b493d2dd6b679f07446fc0e552194434c66",
"body": "Add comprehensive price alerts functionality to Python SDK:\n\n- New AlertsResource with full CRUD operations\n- 5 comparison operators for flexible conditions\n- Webhook notifications with HTTPS support\n- Alert cooldown periods (0-1440 minutes)\n- Webhook endpoint testing\n- DataFrame conversion support\n\n[…]\nlerts.test_webhook(url) - Test webhook endpoint\n- alerts.to_dataframe() - Convert to pandas DataFrame\n\nSupports 12 API endpoints (up from 7).\n\nCo-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add price alerts support (v1.4.0)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-16T02:30:13Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "473fb076a6733f0d0ef33d30d34f97bac5ce0015",
"body": "Sprint 1 - Python Diesel Implementation Complete\n\nChanges:\n1. Created DieselResource class with get_price(), get_stations(), and to_dataframe() methods\n2. Added 7 comprehensive Pydantic models (DieselPrice, DieselStation, DieselStationsResponse, etc.)\n3. Implemented input validation for coordinates,\n[…]\nrices/stations - Nearby station prices (paid)\n- Pandas DataFrame integration for diesel data\n\nResolves: https://github.com/OilpriceAPI/python-sdk/issues/6\nDocumentation: SDK_SPRINT_PLAN_DEC_15_2025.md",
"is_bot": false,
"headline": "feat: Add diesel prices support to Python SDK (v1.3.0)",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-12-15T22:10:56Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "6c3ab3ed0da1c7bf8ed98191fbe279be3cef024f",
"body": null,
"is_bot": false,
"headline": "Remove pricing section from GitHub Pages landing page",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-29T20:20:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b31da482f6b8935332d057b4bbdfd046968d49df",
"body": null,
"is_bot": false,
"headline": "Add GitHub Pages deployment for Python SDK docs",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-29T13:57:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9346d4f7ec8eb81ec8722f75dfb807028f010272",
"body": "Show both sync and async usage examples to demonstrate async/await support.\n\nAsync example:\n- Uses AsyncOilPriceAPI with context manager\n- Shows asyncio.gather() for concurrent requests\n- Fetches multiple commodities in parallel\n\nThis addresses feedback about proving async functionality exists and works.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add async example code block to Reddit post",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T21:07:18Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "9cb4ec609783f6c406285e6b8530b6a0b5b9f216",
"body": "Query production database to get actual Python SDK usage statistics:\n- 113 API requests from Python SDK (User-Agent: OilPriceAPI-Python/1.0.0)\n- 4 unique active users\n- Most popular: /v1/prices/past_year (77 requests)\n\nUpdated Reddit post (line 66):\n- Before: \"20+ downloads in the past month\"\n- Afte\n[…]\nion rate suggests onboarding friction\n- Historical data (/past_year) is primary use case\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Update Reddit post with real usage data from production DB",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:25:40Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "0e979d1ecfe13993d9382354c4dac2ee1cb073d8",
"body": "- Added Quick Start one-liner at top\n- Removed defensive language (\"not a toy project\")\n- Changed \"proper\" to \"comprehensive\" (less subjective)\n- Asked for feedback: \"What should I prioritize?\"\n- Added real usage stats: 20+ downloads/month\n- Prepared answers for common questions\n- Posting strategy and timing guidance\n\nReady to post Tuesday-Thursday 9-11am EST\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Final Reddit post with Sr. QA Engineer improvements",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:13:17Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "feb0d95020f183f89cef71d28bb6b440ca7b7583",
"body": "- Credible claims backed by real code\n- Transparent about roadmap items\n- Technical depth (jitter, connection pooling, error handling)\n- Invites community contribution\n- Ready to post Tuesday-Thursday morning\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add honest Reddit post for current SDK state",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:07:32Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "6528e3dab3b4ce02067a9d93376206e64b15885e",
"body": "- Add jitter to exponential backoff (prevents thundering herd)\n- Configure connection pool limits (max 100 concurrent, 20 keepalive)\n- Comprehensive test suite for retry strategy\n- Improves production resilience under high load\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Phase 1: Add retry jitter and connection pool limits",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T20:03:27Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "5c3983054623c8b7de55934dd43715da1eb6fb98",
"body": "Marketing Materials:\n- REDDIT_POST_TEMPLATE.md: Ready-to-use Reddit post with engagement strategy\n- SESSION_SUMMARY_SDK.md: Complete session summary and next steps\n\nReddit Post Ready:\n- 3 title options (value-focused recommended)\n- Full post body with code examples\n- Engagement strategy and sample r\n[…]\nsignup\n2. Post to r/Python\n3. Engage actively for 2-3 hours\n4. Track metrics daily\n5. Update baseline after 24 hours\n\nExpected Impact: 50-100 upvotes, 2-3x download spike\n\n🤖 Generated with Claude Code",
"is_bot": false,
"headline": "Add Reddit post template and session summary",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T19:59:27Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8893fa96c25d0ea1c4b7d35715494843e2f44ebd",
"body": "Documentation Added:\n- GITHUB_ISSUES_SDK.md: 12 prioritized growth issues (P1-P3)\n- PERFORMANCE_BASELINE.md: Baseline metrics before Reddit campaign\n- README.md: Enhanced with download badge and quick start\n\nCurrent Metrics (Baseline 2025-11-25):\n- PyPI Downloads: 1,019 total, 7/day average\n- Last 3\n[…]\narget: 2x downloads (15/day)\n- 90-day target: 7x downloads (50/day)\n- First Reddit post: 20-50 download spike expected\n\nNext: Reddit post to r/Python, track metrics daily\n\n🤖 Generated with Claude Code",
"is_bot": false,
"headline": "Prepare Python SDK for Reddit marketing launch",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T19:55:26Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "8a7359c614c907238ff7d841e45c060297a1126d",
"body": "- Both emails sent via Postmark with tracking enabled\n- Python Weekly: dc8a303c-b14f-442a-9921-8de7f2a1d3c1\n- PyCoder's Weekly: 2f85f78b-4072-4fda-a1e9-8328164eee2d\n- Added Postmark dashboard link for tracking\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Mark Python Weekly and PyCoder's Weekly emails as sent",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T19:28:12Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "2d0807c6c1e2c3962a57941ee6453f3c79b22d33",
"body": "- Web form at pythonweekly.com/submit returns 404\n- Updated instructions to email rahul@pythonweekly.com instead\n- Updated checklist to reflect PR #2809 completion\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Update Python Weekly submission method to email",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T18:59:54Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "572cdbe5726c43c1d4a9d73ca9098f4d247583e5",
"body": "awesome-python PR successfully created and submitted.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Update READY_TO_SUBMIT with PR #2809 link",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T15:47:05Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "a3d0edf9eb7bf1c71365dc6ae90f899f06c1be1c",
"body": "- Add downloads/month badge to README for transparency\n- Add Contributor Covenant Code of Conduct v2.1\n- Create comprehensive marketing action plan\n- Create Awesome Lists submission tracker\n- Improve community documentation\n\nThis addresses issue #528: PyPI Package Optimization and Marketing\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Add PyPI marketing improvements and action plan",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-11-25T11:32:55Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "3b213ec807f6014bc3fd2f259d25a395c5b0ea2f",
"body": "…ility\n\nFixes #2\n\nReplace relative markdown links with absolute GitHub URLs to ensure\nlinks work correctly on both GitHub and PyPI package page.\n\nChanges:\n- README.md: Fix examples/, EXAMPLES.md, LICENSE, CONTRIBUTING.md links\n- docs/index.md: Fix CONTRIBUTING.md and LICENSE links\n\nBefore: [EXAMPLES\n[…]\nverywhere\n\nThis resolves the 404 error at https://pypi.org/project/oilpriceapi/examples/\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: Convert relative links to absolute GitHub URLs for PyPI compatib…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-10-07T20:56:55Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "d07bfef69b6fee530be6d807bfb6a153c3233e68",
"body": "….com\n\n- Add 3 promotional badges to README (Website, Docs, Sign Up)\n- Add promotional footer section with value proposition and CTAs\n- Create docs/index.md with 25+ backlinks and complete SDK documentation\n- Create EXAMPLES.md with 12 real-world use cases and 30+ backlinks\n- Create GITHUB_TOPICS_SE\n[…]\n website sections\nExpected impact: 50-100% increase in SDK installations over 3-6 months\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat: Add comprehensive SEO enhancements and backlinks to oilpriceapi…",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-10-07T20:46:15Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "d6f6755a01fb8c2629b755cb46dc8c3688095d21",
"body": "Automated publishing using trusted publisher (OIDC).\nTriggers on GitHub releases.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "ci: Add GitHub Actions workflow for PyPI publishing",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-09-29T20:46:38Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "5ee9e9d9dfef414fb4436076b8103ae75be79ccf",
"body": "Removed internal development scripts, test utilities, and planning docs\nthat were used during SDK development but don't belong in the production\nrepository. This cleanup prepares the repo for PyPI publication.\n\nRemoved files:\n- Development scripts: CREATE_GITHUB_ISSUES.sh, generate_*.py utilities\n- \n[…]\ntegration/ is canonical location)\n\nRepository is now clean and ready for v1.0.0 release.\n\n🤖 Generated with [Claude Code](https://claude.com/claude-code)\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "chore: Remove development artifacts from production repo",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-09-29T20:13:14Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "80f17b9bf42f48f774d9523a481111e908c493f2",
"body": "- Synchronous and asynchronous clients\n- Comprehensive error handling and logging\n- Type-safe Pydantic models\n- 94 unit tests + 6 integration tests\n- Full documentation and examples\n- Production-ready with 64% test coverage\n\nCo-Authored-By: Claude <noreply@anthropic.com>",
"is_bot": false,
"headline": "Initial commit: OilPriceAPI Python SDK v1.0.0",
"author_name": "Karl Waldman",
"author_login": "karlwaldman",
"committed_at": "2025-09-29T20:05:22Z",
"body_truncated": false,
"is_coding_agent": true
}
],
"releases_count": 11,
"commits_last_year": 82,
"latest_release_at": "2026-07-19T16:37:47Z",
"latest_release_tag": "v1.11.0",
"releases_from_tags": false,
"days_since_last_push": 4,
"active_weeks_last_year": 17,
"days_since_latest_release": 10,
"mean_days_between_releases": 13.7
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 87,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": false
},
"ecosystem": {
"packages": [
{
"name": "oilpriceapi",
"exists": true,
"license": null,
"keywords": [
"oil",
"prices",
"api",
"commodities",
"energy",
"brent",
"wti",
"natural gas",
"source timestamps",
"finance",
"Development Status :: 5 - Production/Stable",
"Intended Audience :: Developers",
"Intended Audience :: Financial and Insurance Industry",
"Intended Audience :: Science/Research",
"License :: OSI Approved :: MIT License",
"Operating System :: OS Independent",
"Programming Language :: Python",
"Programming Language :: Python :: 3",
"Programming Language :: Python :: 3.10",
"Programming Language :: Python :: 3.11",
"Programming Language :: Python :: 3.12",
"Programming Language :: Python :: 3.8",
"Programming Language :: Python :: 3.9",
"Topic :: Office/Business :: Financial",
"Topic :: Scientific/Engineering :: Information Analysis",
"Topic :: Software Development :: Libraries :: Python Modules",
"Typing :: Typed"
],
"ecosystem": "pypi",
"matches_repo": true,
"registry_url": "https://pypi.org/project/oilpriceapi/",
"is_deprecated": false,
"latest_version": "1.11.0",
"repository_url": "https://github.com/oilpriceapi/python-sdk",
"versions_count": 20,
"total_downloads": null,
"dependents_count": null,
"deprecation_note": null,
"maintainers_count": null,
"monthly_downloads": 728,
"first_published_at": "2025-09-29T21:05:54.900617Z",
"latest_published_at": "2026-07-19T16:38:55.842344Z",
"latest_version_yanked": null,
"days_since_latest_publish": 10
}
]
},
"popularity": {
"forks": 2,
"stars": 2,
"watchers": 0,
"fork_history": {
"days": [
{
"date": "2026-03-20",
"count": 1
},
{
"date": "2026-03-26",
"count": 1
}
],
"complete": true,
"collected": 2,
"total_forks": 2
},
"star_history": null,
"open_issues_and_prs": 0
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [
"examples"
],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [
"oilpriceapi/py.typed"
],
"toolchain_manifests": [],
"largest_source_bytes": 61566,
"source_files_sampled": 112,
"oversized_source_files": 1,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"dependencies": {
"manifests": [
"pyproject.toml"
],
"advisories": {
"error": null,
"scope": "published_package",
"source": "osv",
"findings": [],
"collected": true,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 13,
"malicious_count": 0,
"assessed_package": "pypi:oilpriceapi@1.11.0",
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "httpx",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=0.24.0"
},
{
"name": "pydantic",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.0.0"
},
{
"name": "python-dateutil",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=2.8.0"
},
{
"name": "typing-extensions",
"manifest": "pyproject.toml",
"ecosystem": "pypi",
"version_constraint": ">=4.5.0"
}
],
"all_dependencies": {
"error": null,
"source": "github-sbom",
"packages": [
{
"name": "httpx",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pydantic",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "python-dateutil",
"direct": true,
"version": null,
"ecosystem": "pypi"
},
{
"name": "black",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "cachetools",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "click",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "jsonschema",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "mypy",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "numpy",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pandas",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pre-commit",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-asyncio",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-cov",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "pytest-timeout",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "redis",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "rich",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "ruff",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "setuptools",
"direct": false,
"version": null,
"ecosystem": "pypi"
},
{
"name": "websockets",
"direct": false,
"version": null,
"ecosystem": "pypi"
}
],
"collected": true,
"truncated": false,
"total_count": 20,
"direct_count": 3,
"indirect_count": 17
}
},
"maintainership": {
"issues": {
"open_prs": 0,
"merged_prs": 37,
"open_issues": 0,
"closed_ratio": 1,
"closed_issues": 39,
"closed_unmerged_prs": 0
},
"bus_factor": 1,
"bot_contributors": 1,
"top_contributors": [
{
"type": "User",
"login": "karlwaldman",
"commits": 74,
"avatar_url": "https://avatars.githubusercontent.com/u/12957260?v=4"
}
],
"contributors_sampled": 1,
"top_contributor_share": 1
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"github-pages.yml",
"live-tests.yml",
"publish.yml",
"test.yml",
"weekly-health.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 9,
"reason": "binaries present in source code",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": null,
"reason": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 10,
"reason": "21 out of 21 merged PRs checked by a CI test -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 0,
"reason": "Found 0/22 approved changesets -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 3,
"reason": "project has 1 contributing companies or organizations -- score normalized to 3",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 10,
"reason": "update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": 10,
"reason": "packaging workflow detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 10,
"reason": "security policy file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": 0,
"reason": "Project has not signed or included provenance with any releases.",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 10,
"reason": "0 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "f7b92634173dd9c86cdc5e078cba2019bca6cd38",
"ran_at": "2026-07-29T23:53:08Z",
"aggregate_score": 5.6,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": true,
"has_dependabot_config": true
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-29T23:39:29Z",
"oldest_open_prs": [],
"last_merged_pr_at": "2026-07-25T18:29:05Z",
"ci_last_conclusion": "FAILURE",
"oldest_open_issues": []
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/OilpriceAPI/python-sdk",
"host": "github.com",
"name": "python-sdk",
"owner": "OilpriceAPI"
},
"metrics": {
"overall": {
"key": "overall",
"band": "moderate",
"name": "Overall health",
"note": null,
"notes": [],
"value": 65,
"inputs": {
"security": 66,
"vitality": 81,
"community": 42,
"governance": 58,
"engineering": 77
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "good",
"name": "Vitality",
"value": 81,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "good",
"name": "Development activity",
"note": null,
"notes": [],
"value": 75,
"inputs": {
"commits_last_year": 82,
"human_commit_share": 0.902,
"days_since_last_push": 4,
"active_weeks_last_year": 17
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 4 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 4
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "17/52 weeks with commits",
"points": 11.8,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 17
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "82 commits in the last year",
"points": 17.2,
"status": "partial",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 82
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"releases_count": 11,
"latest_release_tag": "v1.11.0",
"releases_from_tags": false,
"days_since_latest_release": 10,
"mean_days_between_releases": 13.7
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "11 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 11
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 10 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 10
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~13.7 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 13.7
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 4,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 4 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 4
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "at_risk",
"name": "Community & Adoption",
"value": 42,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "critical",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 1,
"inputs": {
"forks": 2,
"stars": 2,
"watchers": 0,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "2 stars",
"points": 0,
"status": "missed",
"details": [
{
"code": "stars",
"params": {
"count": 2
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "2 forks",
"points": 0,
"status": "missed",
"details": [
{
"code": "forks",
"params": {
"count": 2
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "0 watchers",
"points": 0,
"status": "missed",
"details": [
{
"code": "watchers",
"params": {
"count": 0
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "excellent",
"name": "Community health",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": false
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 13.5,
"status": "met",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.3
}
]
},
{
"key": "ecosystem_adoption",
"band": "at_risk",
"name": "Ecosystem adoption (downloads)",
"note": "Excluded from scoring (no data or not applicable): Registry dependents. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"registry_dependents"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 48,
"inputs": {
"packages": [
"oilpriceapi"
],
"dependents": null,
"ecosystems": "pypi",
"total_downloads": null,
"monthly_downloads": 728
},
"components": [
{
"key": "monthly_downloads",
"name": "Monthly downloads",
"detail": "728 downloads/month across pypi",
"points": 38.2,
"status": "partial",
"details": [
{
"code": "downloads_monthly",
"params": {
"count": 728,
"ecosystems": "pypi"
}
}
],
"max_points": 80
},
{
"key": "registry_dependents",
"name": "Registry dependents",
"detail": "not reported by this ecosystem",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_reported_by_this_ecosystem",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 58,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "critical",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 13,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 1,
"top_contributor_share": 1
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 100% of commits",
"points": 0,
"status": "missed",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 100
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "1 contributors",
"points": 1.4,
"status": "partial",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 1
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 3,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "excellent",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"merged_prs": 37,
"open_issues": 0,
"closed_issues": 39,
"issue_closed_ratio": 1,
"closed_unmerged_prs": 0
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "100% of issues closed",
"points": 46.8,
"status": "met",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 100
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "37/37 decided PRs merged",
"points": 38.2,
"status": "met",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 37,
"decided": 37
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 0/22 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "moderate",
"name": "Ownership & stewardship",
"note": null,
"notes": [],
"value": 51,
"inputs": {
"followers": 7,
"owner_type": "Organization",
"is_verified": null,
"owner_login": "OilpriceAPI",
"public_repos": 18,
"account_age_days": 968
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "organization-owned",
"points": 30,
"status": "met",
"details": [
{
"code": "owner_organization",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "7 followers of OilpriceAPI",
"points": 6.5,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 7,
"login": "OilpriceAPI"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "18 public repos, account ~2 yr old",
"points": 14.6,
"status": "partial",
"details": [
{
"code": "public_repos",
"params": {
"count": 18
}
},
{
"code": "account_age_years",
"params": {
"years": 2
}
}
],
"max_points": 25
}
]
},
{
"key": "package_maintenance",
"band": "excellent",
"name": "Package maintenance",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"packages": [
"oilpriceapi"
],
"ecosystems": "pypi",
"any_deprecated": false,
"min_days_since_publish": 10
},
"components": [
{
"key": "published_resolvable",
"name": "Published & resolvable",
"detail": "1 package(s) on pypi",
"points": 25,
"status": "met",
"details": [
{
"code": "packages_published",
"params": {
"count": 1,
"ecosystems": "pypi"
}
}
],
"max_points": 25
},
{
"key": "publish_recency",
"name": "Publish recency",
"detail": "latest publish 10 days ago",
"points": 35,
"status": "met",
"details": [
{
"code": "publish_recency",
"params": {
"days": 10
}
}
],
"max_points": 35
},
{
"key": "version_history",
"name": "Version history",
"detail": "20 published versions",
"points": 20,
"status": "met",
"details": [
{
"code": "published_versions",
"params": {
"count": 20
}
}
],
"max_points": 20
},
{
"key": "not_deprecated",
"name": "Not deprecated",
"detail": "active, not deprecated or yanked",
"points": 20,
"status": "met",
"details": [
{
"code": "package_not_deprecated",
"params": {}
}
],
"max_points": 20
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "good",
"name": "Engineering Quality",
"value": 77,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "moderate",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 68,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": false,
"has_precommit_config": false
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "5 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 5
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "21 out of 21 merged PRs checked by a CI test -- score normalized to 10",
"points": 20,
"status": "met",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"topics": [
"api-client",
"async",
"energy",
"oil-prices",
"pydantic",
"python",
"sdk",
"trading",
"commodity-prices",
"commodities",
"financial-data",
"wti",
"brent-crude",
"commodity-data",
"energy-api",
"natural-gas",
"oil-price",
"openbb",
"pypi"
],
"has_wiki": false,
"homepage": "https://pypi.org/project/oilpriceapi/",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "https://pypi.org/project/oilpriceapi/",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "19 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 19
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "moderate",
"name": "Security",
"value": 66,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "moderate",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Branch-Protection. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"branch_protection"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 57,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 17,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 1,
"scorecard_aggregate": 5.6
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "binaries present in source code",
"points": 6.8,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "internal error: error during branchesHandler.setup: internal error: some github tokens can't read classic branch protection rules: https://github.com/ossf/scorecard-action/blob/main/docs/authentication/fine-grained-auth-token.md",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "21 out of 21 merged PRs checked by a CI test -- score normalized to 10",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 0/22 approved changesets -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 1 contributing companies or organizations -- score normalized to 3",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "update tool detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 25 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "0 existing vulnerabilities detected",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "dependency_advisories",
"band": "excellent",
"name": "Dependency advisories",
"note": "Excluded from scoring (no data or not applicable): No advisories left outstanding. Remaining weights renormalized. Matched the pypi:oilpriceapi@1.11.0 runtime dependency closure — what installing the published package pulls in — 13 packages. Reachability is not analyzed.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"no_advisories_left_outstanding"
]
}
},
{
"code": "weights_renormalized",
"params": {}
},
{
"code": "advisories_scope_published",
"params": {
"package": "pypi:oilpriceapi@1.11.0",
"assessed": 13
}
},
{
"code": "advisories_reachability",
"params": {}
}
],
"value": 100,
"inputs": {
"source": "osv",
"advisories": 0,
"affected_packages": 0,
"assessed_packages": 13,
"unassessed_packages": 0,
"affected_by_severity": "none",
"direct_affected_packages": 0
},
"components": [
{
"key": "direct_dependencies_free_of_known_advisories",
"name": "Direct dependencies free of known advisories",
"detail": "no direct dependency carries a known advisory",
"points": 35,
"status": "met",
"details": [
{
"code": "no_direct_advisories",
"params": {}
}
],
"max_points": 35
},
{
"key": "indirect_dependencies_free_of_known_advisories",
"name": "Indirect dependencies free of known advisories",
"detail": "no indirect dependency carries a known advisory",
"points": 25,
"status": "met",
"details": [
{
"code": "no_indirect_advisories",
"params": {}
}
],
"max_points": 25
},
{
"key": "no_advisories_left_outstanding",
"name": "No advisories left outstanding",
"detail": "no advisory carries a publication date",
"points": 0,
"status": "excluded",
"details": [
{
"code": "advisories_no_publication_date",
"params": {}
}
],
"max_points": 40
}
]
},
{
"key": "malicious_dependencies",
"band": "excellent",
"name": "Malicious dependencies",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"source": "osv",
"meaning": "reported as a malicious package by the OpenSSF corpus; the remedy is removal or moving off the compromised name, never an upgrade of the same artifact. Versions the registry has since pulled are listed but not scored",
"packages": [],
"red_flag": false,
"assessed_packages": 13,
"malicious_packages": 0,
"direct_malicious_packages": 0,
"withdrawn_malicious_packages": 0,
"installable_malicious_packages": 0
},
"components": [
{
"key": "no_dependency_reported_as_a_malicious_package",
"name": "No dependency reported as a malicious package",
"detail": "no dependency is reported as a malicious package",
"points": 100,
"status": "met",
"details": [
{
"code": "no_malicious_dependencies",
"params": {}
}
],
"max_points": 100
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 2
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "moderate",
"name": "AI Readiness",
"value": 51,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "at_risk",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.973,
"agent_instruction_files": [],
"agent_instruction_max_bytes": null
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "no CLAUDE.md / AGENTS.md / editor rules",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_agent_instructions",
"params": {}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "72 of 74 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 72,
"sampled": 74
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "moderate",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 51,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": false,
"typecheck_configs": [
"oilpriceapi/py.typed"
],
"agent_commit_share": 0.695,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0.098
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": "oilpriceapi/py.typed",
"points": 11,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "oilpriceapi/py.typed"
}
}
],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "57 of the last 82 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 57,
"sampled": 82
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "8 of the last 82 commits are automated dependency updates",
"points": 8,
"status": "met",
"details": [
{
"code": "dependency_bot_commits",
"params": {
"count": 8,
"sampled": 82
}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "good",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 82,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 61566,
"source_files_sampled": 112,
"oversized_source_files": 1
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python with type-check config (oilpriceapi/py.typed)",
"points": 27,
"status": "partial",
"details": [
{
"code": "typecheck_config_language",
"params": {
"files": "oilpriceapi/py.typed",
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "1/112 source files over 60KB",
"points": 54.5,
"status": "partial",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 112,
"oversized": 1
}
}
],
"max_points": 55
}
]
},
{
"key": "ai_interfaces",
"band": "at_risk",
"name": "Machine-readable interfaces",
"note": null,
"notes": [],
"value": 40,
"inputs": {
"example_dirs": [
"examples"
],
"has_mcp_signal": false,
"api_schema_files": []
},
"components": [
{
"key": "api_schema_openapi_graphql_proto",
"name": "API schema (OpenAPI/GraphQL/proto)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 40
},
{
"key": "mcp_server",
"name": "MCP server",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 20
},
{
"key": "runnable_examples",
"name": "Runnable examples",
"detail": "examples",
"points": 40,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "examples"
}
}
],
"max_points": 40
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token"
],
"report_type": "repository",
"generated_at": "2026-07-29T23:53:22.941455Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/o/OilpriceAPI/python-sdk.svg",
"full_name": "OilpriceAPI/python-sdk",
"license_state": "standard",
"license_spdx": "MIT"
}
Related records
Inspected repositories sharing catalogue tags or ecosystems with OilpriceAPI/python-sdk. Read them side by side →
Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.27.0 — full methodology · metrics wiki.
