Providers

Search providers, one page at a time.

Changed on

Filters and sorts every provider on the network, then answers the requested page along with how many providers matched.

get/v1/provider-search

Request

  • Base URL
    https://console-api-sandbox.akash.network
  • URL
    https://console-api-sandbox.akash.network/v1/provider-search
  • Auth
    none required

Query parameters

searchstring

Case-insensitive substring matched against each provider's host URI and address.

online'true' | 'false'

Only online providers when true, only offline ones when false, both when omitted.

audited'true' | 'false'

Only audited providers when true, only unaudited ones when false, both when omitted.

addressesstring

Comma-separated provider addresses the search is limited to, at most 100.

regionsstring

Comma-separated location-region attribute values, at most 50. Keeps providers in any of them.

Example:eu-central,na-us-west
gpu'true' | 'false'

Only providers with GPUs when true, only providers without any when false, both when omitted.

gpuModelsstring

Comma-separated GPU model names, matched ignoring case, at most 50. Keeps providers with any of them.

Example:h100,a100
sort'active-leases-desc' | 'active-leases-asc' | 'wallet-leases-desc' | 'wallet-active-leases-desc' | 'gpus-desc'

active-leases-* orders by the provider's active lease count, wallet-leases-desc and wallet-active-leases-desc by how many leases walletAddress holds on it, and gpus-desc by its GPU count across available, pending and active ones.

walletAddressstring

The wallet whose leases the wallet-leases-desc and wallet-active-leases-desc sorts count. Required by those sorts.

skipinteger nullable

Matching providers to skip before the page begins.

limitinteger

Providers per page, at most 100.

Response

Returns a page of the providers matching the search

Changes