The Query API from Pocket Network — 26 operation(s) for query.
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/pokt-query-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: PATH - Path & Toolkit Harness Query API
description: PATH (Path API & Toolkit Harness) is an open source framework for enabling access to a decentralized supply network. It provides various tools and libraries to streamline the integration and interaction with decentralized protocols.
version: 1.0.0
contact:
name: Grove Engineering
email: engineering@grove.city
servers:
- url: https://{serviceId}.rpc.grove.city
description: Production PATH URL with service-specific subdomain
variables:
serviceId:
default: eth
description: The service ID that determines the subdomain
enum:
- arb-one
- arb-sepolia-testnet
- avax
- avax-dfk
- base
- base-sepolia-testnet
- bera
- bitcoin
- blast
- boba
- bsc
- celo
- eth
- eth-holesky-testnet
- eth-sepolia-testnet
- fantom
- fraxtal
- fuse
- gnosis
- harmony
- ink
- iotex
- kaia
- kava
- linea
- mantle
- metis
- moonbeam
- moonriver
- near
- oasys
- op
- op-sepolia-testnet
- opbnb
- pocket
- poly
- poly-amoy-testnet
- poly-zkevm
- radix
- scroll
- sei
- sonic
- sui
- taiko
- taiko-hekla-testnet
- tron
- xrplevm
- xrplevm-testnet
- zklink-nova
- zksync-era
- url: http://localhost:3069
description: Local PATH instance
security:
- ApiKeyAuth: []
tags:
- name: Query
paths:
/pokt-network/poktroll/application/application:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_AllApplications
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
- type: string
description: 'TODO_MAINNET(@adshmh): rename this field to `gateway_address_delegated_to`
delegatee_gateway_address, if specified, filters the application list to only include those with delegation to the specified gateway address.'
name: delegatee_gateway_address
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.application.QueryAllApplicationsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/application/application/{address}:
get:
tags:
- Query
summary: Queries a list of Application items.
operationId: GithubCompoktNetworkpoktrollQuery_Application
parameters:
- type: string
name: address
in: path
required: true
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.application.QueryGetApplicationResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/application/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_Params
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.application.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/gateway/gateway:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_AllGateways
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.gateway.QueryAllGatewaysResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/gateway/gateway/{address}:
get:
tags:
- Query
summary: Queries a list of Gateway items.
operationId: GithubCompoktNetworkpoktrollQuery_Gateway
parameters:
- type: string
name: address
in: path
required: true
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.gateway.QueryGetGatewayResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/gateway/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin9
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.gateway.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/migration/morse_claimable_account:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_MorseClaimableAccountAll
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.migration.QueryAllMorseClaimableAccountResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/migration/morse_claimable_account/{address}:
get:
tags:
- Query
summary: Queries a list of MorseClaimableAccount items.
operationId: GithubCompoktNetworkpoktrollQuery_MorseClaimableAccount
parameters:
- type: string
name: address
in: path
required: true
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.migration.QueryMorseClaimableAccountResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/migration/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin17
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.migration.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/proof/claim:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_AllClaims
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
- type: string
name: supplier_operator_address
in: query
- type: string
name: session_id
in: query
- type: string
format: uint64
name: session_end_height
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.proof.QueryAllClaimsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/proof/claim/{session_id}/{supplier_operator_address}:
get:
tags:
- Query
summary: Queries a list of Claim items.
operationId: GithubCompoktNetworkpoktrollQuery_Claim
parameters:
- type: string
name: session_id
in: path
required: true
- type: string
name: supplier_operator_address
in: path
required: true
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.proof.QueryGetClaimResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/proof/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin22
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.proof.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/proof/proof:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_AllProofs
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
- type: string
name: supplier_operator_address
in: query
- type: string
name: session_id
in: query
- type: string
format: uint64
name: session_end_height
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.proof.QueryAllProofsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/proof/proof/{session_id}/{supplier_operator_address}:
get:
tags:
- Query
summary: Queries a list of Proof items.
operationId: GithubCompoktNetworkpoktrollQuery_Proof
parameters:
- type: string
name: session_id
in: path
required: true
- type: string
name: supplier_operator_address
in: path
required: true
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.proof.QueryGetProofResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/service/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin28
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.service.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/service/relay_mining_difficulty:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_RelayMiningDifficultyAll
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.service.QueryAllRelayMiningDifficultyResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/service/relay_mining_difficulty/{serviceId}:
get:
tags:
- Query
summary: Queries a list of RelayMiningDifficulty items.
operationId: GithubCompoktNetworkpoktrollQuery_RelayMiningDifficulty
parameters:
- type: string
name: serviceId
in: path
required: true
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.service.QueryGetRelayMiningDifficultyResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/service/service:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_AllServices
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.service.QueryAllServicesResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/service/service/{id}:
get:
tags:
- Query
summary: Queries a list of Service items.
operationId: GithubCompoktNetworkpoktrollQuery_Service
parameters:
- type: string
description: 'TODO_IMPROVE: We could support getting services by name.'
name: id
in: path
required: true
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.service.QueryGetServiceResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/session/get_session:
get:
tags:
- Query
summary: Queries the session given app_address, service and block_height.
operationId: GithubCompoktNetworkpoktrollQuery_GetSession
parameters:
- type: string
description: The Bech32 address of the application.
name: application_address
in: query
- type: string
description: The service ID to query the session for
name: service_id
in: query
- type: string
format: int64
description: The block height to query the session for
name: block_height
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.session.QueryGetSessionResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/session/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin34
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.session.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/shared/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin39
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.shared.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/supplier/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin46
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.supplier.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/supplier/supplier:
get:
tags:
- Query
operationId: GithubCompoktNetworkpoktrollQuery_AllSuppliers
parameters:
- type: string
format: byte
description: 'key is a value returned in PageResponse.next_key to begin
querying the next page most efficiently. Only one of offset or key
should be set.'
name: pagination.key
in: query
- type: string
format: uint64
description: 'offset is a numeric offset that can be used when key is unavailable.
It is less efficient than using key. Only one of offset or key should
be set.'
name: pagination.offset
in: query
- type: string
format: uint64
description: 'limit is the total number of results to be returned in the result page.
If left empty it will default to a value to be set by each app.'
name: pagination.limit
in: query
- type: boolean
description: 'count_total is set to true to indicate that the result set should include
a count of the total number of items available for pagination in UIs.
count_total is only respected when offset is used. It is ignored when key
is set.'
name: pagination.count_total
in: query
- type: boolean
description: reverse is set to true if results are to be returned in the descending order.
name: pagination.reverse
in: query
- type: string
description: 'Optional filters that can be combined (AND logic)
unique service identifier to filter by'
name: service_id
in: query
- type: string
description: supplier operator address to filter by
name: operator_address
in: query
- type: string
description: supplier owner address to filter by
name: owner_address
in: query
- type: boolean
description: 'if true, return a dehydrated version of the supplier.
Why? This enables smaller response payloads to reduce pagination of the supplier list.
Example: Removes service_config_history and rev_share details from the response. See the implementation for more details.'
name: dehydrated
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.supplier.QueryAllSuppliersResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/supplier/supplier/{operator_address}:
get:
tags:
- Query
summary: Queries a list of Supplier items.
operationId: GithubCompoktNetworkpoktrollQuery_Supplier
parameters:
- type: string
description: 'TODO_TECHDEBT: Add the ability to query for a supplier by owner_id'
name: operator_address
in: path
required: true
- type: boolean
description: 'if true, return a dehydrated version of the supplier.
Why? This enables smaller response payloads to reduce payload size.
Example: Removes service_config_history and rev_share details from the response. See the implementation for more details.'
name: dehydrated
in: query
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.supplier.QueryGetSupplierResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
/pokt-network/poktroll/tokenomics/params:
get:
tags:
- Query
summary: Parameters queries the parameters of the module.
operationId: GithubCompoktNetworkpoktrollQuery_ParamsMixin51
responses:
'200':
description: A successful response.
schema:
$ref: '#/definitions/pocket.tokenomics.QueryParamsResponse'
default:
description: An unexpected error response.
schema:
$ref: '#/definitions/google.rpc.Status'
definitions:
pocket.shared.Service:
type: object
title: Service message to encapsulate unique and semantic identifiers for a service on the network
properties:
compute_units_per_relay:
description: Compute units required per relay for this service
type: string
format: uint64
title: 'The cost of a single relay for this service in terms of compute units.
Must be used alongside the global ''compute_units_to_tokens_multiplier'' to calculate the cost of a relay for this service.
cost_per_relay_for_specific_service = compute_units_per_relay_for_specific_service * compute_units_to_tokens_multiplier_global_value'
id:
description: Unique identifier for the service
type: string
title: For example, what if we want to request a session for a certain service but with some additional configs that identify it?
metadata:
description: 'Optional metadata containing an experimental API specification for the service.
When exposed via JSON, this field is base64 encoded and MUST be <= 100 KiB when decoded.'
$ref: '#/definitions/pocket.shared.Metadata'
name:
description: (Optional) Human readable description of the service
type: string
title: 'TODO_POST_MAINNET: Rename service.name to service.description'
owner_address:
description: 'The owner address that created the service.
It is the address that receives rewards based on the Service''s onchain usage
It is the only address that can update the service configuration (e.g. compute_units_per_relay),
or make other updates to it.
The Bech32 address of the service owner / creator'
type: string
pocket.application.QueryGetApplicationResponse:
type: object
properties:
application:
$ref: '#/definitions/pocket.application.Application'
pocket.shared.ConfigOption:
type: object
title: Key-value wrapper for config options, as proto maps can't be keyed by enums
properties:
key:
title: Config option key
$ref: '#/definitions/pocket.shared.ConfigOptions'
value:
type: string
title: Config option value
pocket.shared.ApplicationServiceConfig:
type: object
title: ApplicationServiceConfig holds the service configuration the application stakes for
properties:
service_id:
type: string
title: The Service ID for which the application is configured
pocket.shared.SupplierEndpoint:
type: object
title: SupplierEndpoint message to hold service configuration details
properties:
configs:
type: array
title: Additional configuration options for the endpoint
items:
type: object
$ref: '#/definitions/pocket.shared.ConfigOption'
rpc_type:
title: Type of RPC exposed on the url above
$ref: '#/definitions/pocket.shared.RPCType'
url:
type: string
title: URL of the endpoint
pocket.shared.SupplierServiceConfig:
type: object
title: SupplierServiceConfig holds the service configuration the supplier stakes for
properties:
endpoints:
type: array
title: List of endpoints for the service
items:
type: object
$ref: '#/definitions/pocket.shared.SupplierEndpoint'
rev_share:
type: array
title: List of revenue share configurations for the se
# --- truncated at 32 KB (70 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/pokt/refs/heads/main/openapi/pokt-query-api-openapi.yml