Skip to content

Raw Clients

The curated route groups cover the consumer- and node-facing endpoints. Any endpoint that doesn't have a curated method (for example admin or ops routes) is still reachable through the underlying, fully-typed openapi-fetch clients at client.api.clients. Authentication is applied automatically — you don't add headers yourself.

ts
import { 
createNosanaClient
,
NosanaNetwork
} from '@nosana/kit';
const
client
=
createNosanaClient
(
NosanaNetwork
.
MAINNET
, {
api
: {
apiKey
:
process
.
env
.
NOSANA_API_KEY
},
}); // every route of each service, typed against its OpenAPI schema:
client
.
api
.
clients
.
clientManager
;
client
.
api
.
clients
.
hostManager
;
client
.
api
.
clients
.
blockchainIndexer
;
client
.
api
.
clients
.
deploymentManager
;
// e.g. call a route not exposed as a curated method: const {
data
,
error
} = await
client
.
api
.
clients
.
hostManager
.
GET
(
'/nodes/{id}/full', {
params
: {
path
: {
id
:
nodeAddress
} } },
);

Path, params and response are all type-checked against the generated OpenAPI schema, so your editor autocompletes routes and payloads.

Services

ClientServesBase URL (mainnet)
clients.clientManagerAuth, API keys, credits, payments, templates, job writeshttps://client-manager.k8s.prd.nosana.com
clients.blockchainIndexerJob & stats readshttps://blockchain-indexer.k8s.prd.nos.ci
clients.deploymentManagerDeployments & vaultshttps://deployment-manager.k8s.prd.nos.ci
clients.hostManagerMarkets, nodes, benchmarkshttps://host-manager.k8s.prd.nosana.com

The full mapping of every production endpoint to its SDK method (and which endpoints are raw-client-only) is maintained in packages/api/API_ENDPOINTS.md.