MobilityPlatform secretMerged

Korea Fuel Price

opinet.co.kr

Opinet gas station fuel price data provider.

Tier: 🥉 Bronze
Reward: ₩15,000
Auth: Platform secret
Operations: 2
Working now: 0 contributors
Status: Merged

Scope

Exposes fuel price data from the national oil price information service. Callers read region-level average prices and search the cheapest stations around a location by fuel type.

Expected operations

get-average-pricesGet average fuel pricesreadDifficulty: easy

Return current average prices per fuel type nationally or for one province.

Inputs

province_codestringoptional

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

This provider has been merged. Browse other open bounties.

Claiming a bounty requires a GitHub sign-in.

Outputs

pricesfuel_typeaverage_price_krwprice_dateprovince_code

Acceptance

Average prices are per-liter Korean won values keyed by a normalized fuel type enum covering gasoline, premium gasoline, diesel, and LPG.
The price date field states the effective date so consumers can detect stale data.

Auth required for this operation.

search-cheapest-stationsSearch cheapest stationsreadDifficulty: medium

Return the lowest-priced gas stations within a radius of a coordinate for one fuel type.

Inputs

latitudenumberrequired
Center latitude in decimal degrees
37.5665
longitudenumberrequired
Center longitude in decimal degrees
126.9780
radius_mnumberrequired
Search radius in meters up to five thousand
3000
fuel_typestringrequired
Fuel type: gasoline, premium_gasoline, diesel, or lpg
gasoline

Outputs

stationsstation_idstation_namebrandprice_krwdistance_m