Lium Machine Requests API
The Machine Requests API from Lium — 5 operation(s) for machine requests.
The Machine Requests API from Lium — 5 operation(s) for machine requests.
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/lium-io:lium-io-machine-requests-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. 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: Lium Miner Portal Machine Requests API
version: 0.1.0
servers:
- url: /api
tags:
- name: Machine Requests
paths:
/machine-requests:
get:
tags:
- Machine Requests
summary: List machine requests
description: 'Logged in with at least one validator-verified node: every open request with the requester''s name and spend metrics. Anyone else (no token, or a provider whose nodes are not verified yet) gets an aggregate: how many open requests per GPU class and per hourly budget band, nothing that names a request or a requester.'
operationId: find_machine_requests_get
responses:
'200':
description: The rows (verified provider) or the aggregate (everyone else)
content:
application/json:
schema:
anyOf:
- items:
$ref: '#/components/schemas/MachineRequestWithRequesterDto'
type: array
- $ref: '#/components/schemas/MachineRequestFeedSummary'
title: Response Find Machine Requests Get
'401':
description: A token that is present but invalid or expired
'500':
description: Internal server error
security:
- HTTPBearer: []
- {}
/machine-requests/notices:
get:
tags:
- Machine Requests
summary: The caller's in-app machine-request notices
description: 'DAH-3685: the undismissed ''renters are asking for N× '' items written for this provider, newest first, for requests still open. No requester data.'
operationId: notices_machine_requests_notices_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MachineRequestNoticesResponse'
security:
- HTTPBearer: []
/machine-requests/notices/{notification_id}/dismiss:
post:
tags:
- Machine Requests
summary: Dismiss one in-app notice
operationId: dismiss_notice_machine_requests_notices__notification_id__dismiss_post
security:
- JwtAccessBearer: []
parameters:
- name: notification_id
in: path
required: true
schema:
type: string
format: uuid
title: Notification Id
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/DetailResponse_dict_'
'404':
description: Not one of the caller's notices
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/machine-requests/mutes:
get:
tags:
- Machine Requests
summary: The caller's machine-request notification mutes
description: 'DAH-3685: providers whose listed GPU classes match a request are notified by default; this is the opt-out: every class (`muted_all`) or the listed class keys.'
operationId: mutes_machine_requests_mutes_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MachineRequestMutesDto'
security:
- HTTPBearer: []
put:
tags:
- Machine Requests
summary: Replace the caller's machine-request notification mutes
operationId: set_mutes_machine_requests_mutes_put
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/SetMachineRequestMutesRequest'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/MachineRequestMutesDto'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- JwtAccessBearer: []
/machine-requests/{request_id}:
get:
tags:
- Machine Requests
summary: Get a machine request
description: One request with the requester's name and spend metrics, for a provider with a validator-verified node.
operationId: find_by_id_machine_requests__request_id__get
security:
- HTTPBearer: []
parameters:
- name: request_id
in: path
required: true
schema:
type: string
format: uuid
title: Request Id
responses:
'200':
description: Request retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/MachineRequestWithRequesterDto'
'401':
description: No token, or an invalid one
'403':
description: Logged in, but no validator-verified node yet
'404':
description: Request not found
'500':
description: Internal server error
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
SetMachineRequestMutesRequest:
properties:
muted_all:
type: boolean
title: Muted All
default: false
muted_classes:
items:
type: string
type: array
maxItems: 50
title: Muted Classes
type: object
title: SetMachineRequestMutesRequest
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
MachineRequestWithRequesterDto:
properties:
id:
type: string
format: uuid
title: Id
created_at:
type: string
format: date-time
title: Created At
updated_at:
type: string
format: date-time
title: Updated At
gpu_count:
anyOf:
- type: integer
- type: 'null'
title: Gpu Count
cpu:
anyOf:
- type: string
- type: 'null'
title: Cpu
ram:
anyOf:
- type: string
- type: 'null'
title: Ram
storage:
anyOf:
- type: string
- type: 'null'
title: Storage
location:
anyOf:
- type: string
- type: 'null'
title: Location
extra_data:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Extra Data
machine_name:
type: string
title: Machine Name
user_id:
type: string
format: uuid
title: User Id
deleted_at:
anyOf:
- type: string
format: date-time
- type: 'null'
title: Deleted At
achieved:
type: boolean
title: Achieved
provider_hotkey:
anyOf:
- type: string
- type: 'null'
title: Provider Hotkey
tier:
anyOf:
- type: string
- type: 'null'
title: Tier
requester:
anyOf:
- $ref: '#/components/schemas/RequesterInfoDto'
- type: 'null'
type: object
required:
- id
- created_at
- updated_at
- gpu_count
- cpu
- ram
- storage
- location
- extra_data
- machine_name
- user_id
- deleted_at
- achieved
- requester
title: MachineRequestWithRequesterDto
description: DTO for machine request with requester information
MachineRequestFeedSummary:
properties:
tier:
type: string
const: aggregate
title: Tier
default: aggregate
open_requests:
type: integer
title: Open Requests
by_gpu_class:
items:
$ref: '#/components/schemas/MachineRequestGpuClassCount'
type: array
title: By Gpu Class
by_hourly_budget_band:
items:
$ref: '#/components/schemas/MachineRequestBudgetBandCount'
type: array
title: By Hourly Budget Band
type: object
required:
- open_requests
- by_gpu_class
- by_hourly_budget_band
title: MachineRequestFeedSummary
description: 'What an anonymous caller or a provider without a verified node sees (DAH-2269): counts only.
Nothing in here names a request or a requester — no id, no user_id, no name, no spend figure, no free-form
field. `by_gpu_class` is sorted by open_requests desc, then name; `by_hourly_budget_band` follows
HOURLY_BUDGET_BANDS with "unknown" last, bands with zero requests omitted.'
MachineRequestMutesDto:
properties:
muted_all:
type: boolean
title: Muted All
muted_classes:
items:
type: string
type: array
title: Muted Classes
type: object
required:
- muted_all
- muted_classes
title: MachineRequestMutesDto
description: '`muted_all` is the global mute (''*''); `muted_classes` the per-class ones, class keys of the Lium backend''s
normaliser (GET /api/public/v1/requests lists them).'
MachineRequestBudgetBandCount:
properties:
band:
type: string
title: Band
open_requests:
type: integer
title: Open Requests
type: object
required:
- band
- open_requests
title: MachineRequestBudgetBandCount
MachineRequestGpuClassCount:
properties:
machine_name:
type: string
title: Machine Name
open_requests:
type: integer
title: Open Requests
type: object
required:
- machine_name
- open_requests
title: MachineRequestGpuClassCount
MachineRequestNoticesResponse:
properties:
notices:
items:
$ref: '#/components/schemas/MachineRequestNoticeDto'
type: array
title: Notices
type: object
required:
- notices
title: MachineRequestNoticesResponse
DetailResponse_dict_:
properties:
success:
type: boolean
title: Success
description: Whether the request was successful
default: true
data:
additionalProperties: true
type: object
title: Data
description: Single item data
timestamp:
type: string
format: date-time
title: Timestamp
description: Response timestamp
type: object
required:
- data
title: DetailResponse[dict]
MachineRequestNoticeDto:
properties:
id:
type: string
format: uuid
title: Id
request_id:
type: string
format: uuid
title: Request Id
gpu_class:
anyOf:
- type: string
- type: 'null'
title: Gpu Class
gpu_count:
anyOf:
- type: integer
- type: 'null'
title: Gpu Count
created_at:
type: string
format: date-time
title: Created At
type: object
required:
- id
- request_id
- gpu_class
- gpu_count
- created_at
title: MachineRequestNoticeDto
description: 'One in-app item: what renters are asking for and the request to look at. Never the requester.'
RequesterInfoDto:
properties:
name:
type: string
title: Name
total_spent:
type: number
title: Total Spent
current_credit_balance:
type: number
title: Current Credit Balance
last_month_spent:
type: number
title: Last Month Spent
total_machine_requests:
type: integer
title: Total Machine Requests
active_machine_requests:
type: integer
title: Active Machine Requests
last_calculated_at:
type: string
format: date-time
title: Last Calculated At
type: object
required:
- name
- total_spent
- current_credit_balance
- last_month_spent
- total_machine_requests
- active_machine_requests
- last_calculated_at
title: RequesterInfoDto
description: DTO for requester information from RequesterMetrics
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
JwtAccessBearer:
type: http
scheme: bearer
HTTPBearer:
type: http
scheme: bearer