Markets are the electricity markets in which you can participate. Each market has a set of eligibility criteria, which you can query to see if you can participate in a certain market. Read our [guide](/guides/connect/markets) for more information.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/powernaut-markets-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Powernaut Markets API
description: '# Getting Started
Welcome to the Powernaut API Reference!'
version: 1.0.0
contact:
name: Powernaut Support
url: https://powernaut.io
email: support@powernaut.io
license:
name: Creative Commons Attribution-ShareAlike 4.0 International
url: https://creativecommons.org/licenses/by-sa/4.0/
servers:
- url: https://api.sandbox.powernaut.io
description: Sandbox
- url: https://api.powernaut.io
description: Production
tags:
- name: Markets
description: 'Markets are the electricity markets in which you can participate.
Each market has a set of eligibility criteria, which you can query to see if you can participate in a certain market.
Read our guide for more information.'
x-displayName: Markets
paths:
/v1/connect/sites/{id}/markets:
get:
description: 'Retrieves the markets a site can have access to.
Whether a market is available or not depends on the combination of a few factors:
- Whether or not the owner of the site is contractually connected to the market via its supplier
- Whether or not the site is located in the market''s service area (geographically)
- Whether or not the site and its resources meet the market''s eligibility criteria (technical requirements)
The result contains all contractually available markets, with a `status` property indicating whether or not the site can access the market.
The different values of the market status of a site are:
- `active` - The site is active on this market.
- `ineligible` - The site is not eligible for this market (for example due to technical, or geographical reasons).
- `action_required` - Further action is required from the site to activate this market.
When the status is `action_required`, further action is required to activate the market. Look at the `action` property for more information.'
operationId: MarketsSite
parameters:
- name: id
required: true
in: path
description: Identifier of the site you want to get markets for.
schema:
type: string
format: uuid
responses:
'200':
description: Markets
content:
application/json:
schema:
type: array
items:
oneOf:
- $ref: '#/components/schemas/MarketActiveDto'
title: Active
- $ref: '#/components/schemas/MarketUnavailableDto'
title: Unavailable
- $ref: '#/components/schemas/MarketActionRequiredDto'
title: Action Required
discriminator:
propertyName: status
mapping:
active: '#/components/schemas/MarketActiveDto'
unavailable: '#/components/schemas/MarketUnavailableDto'
action_required: '#/components/schemas/MarketActionRequiredDto'
'400':
description: Bad request
content:
application/json:
schema:
$ref: '#/components/schemas/BadRequestExceptionDto'
'401':
description: Not authorized
content:
application/json:
schema:
$ref: '#/components/schemas/UnauthorizedExceptionDto'
'403':
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ForbiddenExceptionDto'
'404':
description: Site does not exist
content:
application/json:
schema:
$ref: '#/components/schemas/NotFoundDto_U2l0ZSBkb2VzIG5vdCBleGlzdA'
security:
- cloud-cloud: []
summary: Site markets
tags:
- Markets
components:
schemas:
MarketUnavailableDto:
type: object
properties:
name:
type: string
description: The name of the market
status:
type: string
description: This market is not eligible for the site (for example due to technical, or geographical reasons).
example: ineligible
enum:
- ineligible
required:
- name
- status
MarketActionRequiredDto:
type: object
properties:
name:
type: string
description: The name of the market
status:
type: string
description: Further action is required from the end-consumer to activate this market. Look at the `action` property for more information.
example: action_required
enum:
- action_required
action:
description: The action required to activate the market.
oneOf:
- $ref: '#/components/schemas/MarketActionConsentRequiredDto'
title: Consent Required
discriminator:
propertyName: action
mapping:
consent_required: '#/components/schemas/MarketActionConsentRequiredDto'
allOf:
- $ref: '#/components/schemas/MarketActionConsentRequiredDto'
required:
- name
- status
- action
ForbiddenExceptionDto:
type: object
properties:
message:
description: One or more specific error messages
oneOf:
- type: string
- type: array
items:
type: string
example: Insufficient permissions
error:
type: string
description: Forbidden
example: Forbidden
status_code:
type: number
description: '403'
example: 403
required:
- message
- error
- status_code
NotFoundDto_U2l0ZSBkb2VzIG5vdCBleGlzdA:
type: object
properties:
message:
description: One or more specific error messages
oneOf:
- type: string
- type: array
items:
type: string
example: Site does not exist
error:
type: string
description: Not Found
example: Not Found
status_code:
type: number
description: '404'
example: 404
required:
- message
- error
- status_code
MarketActionConsentRequiredDto:
type: object
properties:
name:
type: string
description: The end-consumer needs explicitly to consent to the market. Redirect the end-consumer to the URL in the `url` property to start the consent flow.
enum:
- consent_required
example: consent_required
url:
type: string
description: 'The URL to redirect to for the end-consumer to capture their consent.
The following query parameters are supported:
- `country`: An ISO 3166-1 alpha-2 country code. This will limit address suggestions to the given country, and adjust naming of grid identifiers accordingly.
- `locale`: An IETF BCP 47 locale code. Supported locales are `en`, `fr`, `nl`. This will adjust the language of the flow to the given locale.
- `redirect_url`: The URL to redirect to after the consent flow.
The flow will capture the customer''s consent and redirect back to the given redirect URL.'
example: https://app.powernaut.io/contract/{uuid}/sign?country=BE&language=nl&redirect_url=https://example.com
required:
- name
- url
MarketActiveDto:
type: object
properties:
name:
type: string
description: The name of the market
status:
type: string
description: The site is active on this market.
example: active
enum:
- active
required:
- name
- status
UnauthorizedExceptionDto:
type: object
properties:
message:
description: One or more specific error messages
oneOf:
- type: string
- type: array
items:
type: string
example: Unauthorized
error:
type: string
description: Unauthorized
example: Unauthorized
status_code:
type: number
description: '401'
example: 401
required:
- message
- error
- status_code
BadRequestExceptionDto:
type: object
properties:
message:
description: One or more specific error messages
oneOf:
- type: string
- type: array
items:
type: string
example:
- Invalid datetime
- Invalid page size
error:
type: string
description: Bad Request
example: Bad Request
status_code:
type: number
description: '400'
example: 400
required:
- message
- error
- status_code
securitySchemes:
cloud-cloud:
scheme: bearer
bearerFormat: JWT
type: http
description: A bearer token obtained from the token endpoint.
token:
type: http
scheme: basic
description: Your client id and secret to obtain a bearer token for cloud-cloud authentication.
edge-cloud:
type: http
scheme: basic
description: Basic credentials used for edge-cloud authentication. They can be obtained when creating a site.
x-tagGroups:
- name: Authentication
tags:
- authentication
- name: Managing resources
tags:
- sites
- resources
- name: Markets
tags:
- markets
- name: Reporting flexibility
tags:
- baselining
- creating_bids
- metrics
- name: Activating flexibility
tags:
- accepting_bids
- name: Managing bids
tags:
- managing_bids
- name: Forecasting
tags:
- getting_forecasts
- uploading_forecasts
- events
- name: Sensor data
tags:
- sensor_data
- name: Historical Data
tags:
- historical_data