FastGPU Router API
Launch and manage GPUs through FastGPU (API key required).
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/fastgpu:fastgpu-router-api"
All apis
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.
Get an API 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. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: FastGPU Router API
description: 'Live GPU cloud price comparison across the whole market, as a REST API and MCP server. FastGPU brokers GPU capacity: describe the cluster you need and get competing quotes from capacity holders, each shown next to live prices from RunPod, Vast.ai, Lambda, the hyperscalers and more. Free for buyers, no sales calls.'
version: 1.0.0
contact:
name: FastGPU
url: https://fastgpu.co/docs
servers:
- url: https://fastgpu.co
tags:
- name: Router
description: Launch and manage GPUs through FastGPU (API key required).
paths:
/api/v1/router/launch:
post:
operationId: router_launch
tags:
- Router
summary: Launch a GPU (route + provision)
description: Route a described job to the best in-stock connected provider (RunPod, Vast.ai, Hyperstack) and PROVISION a real GPU, billed by the second to your prepaid FastGPU wallet. Returns the instance; poll GET /api/v1/router/instances/{id} for the connection URL once it is running. Requires an API key with wallet balance.
security:
- apiKey: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
query:
type: string
description: Describe the job, e.g. "fine-tune Llama 3 8B" or "1x H100 for training".
required:
- query
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
instance:
type: object
properties:
id:
type: string
status:
type: string
provider:
type: string
provider_label:
type:
- string
- 'null'
gpu_model:
type: string
gpu_count:
type: integer
price_usd_hr:
type:
- number
- 'null'
provider_price_usd_hr:
type:
- number
- 'null'
connection:
type:
- object
- 'null'
properties:
jupyterUrl:
type:
- string
- 'null'
sshHost:
type:
- string
- 'null'
sshPort:
type:
- integer
- 'null'
publicIp:
type:
- string
- 'null'
note:
type:
- string
- 'null'
error:
type:
- string
- 'null'
job_query:
type:
- string
- 'null'
charged_usd:
type:
- number
- 'null'
started_at:
type:
- string
- 'null'
created_at:
type: string
required:
- instance
'401':
description: Missing or invalid API key
/api/v1/router/instances:
get:
operationId: router_list_instances
tags:
- Router
summary: List your GPU instances + balance
description: List your router GPU instances (status, connection, billed rate) and your wallet balance. Refreshes any live instance against its provider first, so status + connection resolve. Requires an API key.
security:
- apiKey: []
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
balance:
type: number
reserved:
type: number
instances:
type: array
items:
type: object
properties:
id:
type: string
status:
type: string
provider:
type: string
provider_label:
type:
- string
- 'null'
gpu_model:
type: string
gpu_count:
type: integer
price_usd_hr:
type:
- number
- 'null'
provider_price_usd_hr:
type:
- number
- 'null'
connection:
type:
- object
- 'null'
properties:
jupyterUrl:
type:
- string
- 'null'
sshHost:
type:
- string
- 'null'
sshPort:
type:
- integer
- 'null'
publicIp:
type:
- string
- 'null'
note:
type:
- string
- 'null'
error:
type:
- string
- 'null'
job_query:
type:
- string
- 'null'
charged_usd:
type:
- number
- 'null'
started_at:
type:
- string
- 'null'
created_at:
type: string
required:
- balance
- instances
'401':
description: Missing or invalid API key
/api/v1/router/instances/{id}:
get:
operationId: router_get_instance
tags:
- Router
summary: Get one GPU instance
description: Get one instance's live status + connection URL. Poll this after launching until status is "running". Requires an API key.
security:
- apiKey: []
parameters:
- name: id
in: path
required: true
description: id identifier
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
instance:
type: object
properties:
id:
type: string
status:
type: string
provider:
type: string
provider_label:
type:
- string
- 'null'
gpu_model:
type: string
gpu_count:
type: integer
price_usd_hr:
type:
- number
- 'null'
provider_price_usd_hr:
type:
- number
- 'null'
connection:
type:
- object
- 'null'
properties:
jupyterUrl:
type:
- string
- 'null'
sshHost:
type:
- string
- 'null'
sshPort:
type:
- integer
- 'null'
publicIp:
type:
- string
- 'null'
note:
type:
- string
- 'null'
error:
type:
- string
- 'null'
job_query:
type:
- string
- 'null'
charged_usd:
type:
- number
- 'null'
started_at:
type:
- string
- 'null'
created_at:
type: string
required:
- instance
'401':
description: Missing or invalid API key
delete:
operationId: router_terminate
tags:
- Router
summary: Terminate a GPU instance
description: 'Terminate one instance: destroys the GPU on the provider and settles your wallet to the actual elapsed cost. Requires an API key.'
security:
- apiKey: []
parameters:
- name: id
in: path
required: true
description: id identifier
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
properties:
instance:
type: object
properties:
id:
type: string
status:
type: string
provider:
type: string
provider_label:
type:
- string
- 'null'
gpu_model:
type: string
gpu_count:
type: integer
price_usd_hr:
type:
- number
- 'null'
provider_price_usd_hr:
type:
- number
- 'null'
connection:
type:
- object
- 'null'
properties:
jupyterUrl:
type:
- string
- 'null'
sshHost:
type:
- string
- 'null'
sshPort:
type:
- integer
- 'null'
publicIp:
type:
- string
- 'null'
note:
type:
- string
- 'null'
error:
type:
- string
- 'null'
job_query:
type:
- string
- 'null'
charged_usd:
type:
- number
- 'null'
started_at:
type:
- string
- 'null'
created_at:
type: string
required:
- instance
'401':
description: Missing or invalid API key
components:
securitySchemes:
apiKey:
type: http
scheme: bearer
description: 'FastGPU API key (fgpu_live_...), sent as an Authorization: Bearer header. Create one at /app.'
externalDocs:
description: Docs, the MCP server and the open CC BY 4.0 dataset
url: https://fastgpu.co/docs