Skip to main content

​
Endpoint

GET /api/status

​
Authentication

Required. Include a valid session token in the Authorization header.

​
Request Headers

​
Authorization
string
required
Bearer token obtained from /api/auth/login. Format: Bearer fn_sess_...

​
Response

​
running
boolean
required
Always true - indicates the Fishnet server is running
​
uptime
string
required
Human-readable uptime in format like 2h 5m or 45m
​
services
array
required
List of enabled service names (e.g., ["openai", "anthropic", "binance"])
​
today_spend
object
required
Map of service names to total spend in USD for the current day
​
today_requests
object
required
Map of service names to request counts for the current day

​
Response Example

{
  "running": true,
  "uptime": "2h 15m",
  "services": ["openai", "anthropic", "binance", "onchain"],
  "today_spend": {
    "openai": 1.23,
    "anthropic": 0.45,
    "binance": 0.0,
    "onchain": 0.0
  },
  "today_requests": {
    "openai": 42,
    "anthropic": 15,
    "binance": 8,
    "onchain": 3
  }
}

​
Error Responses

​
Status Codes

  • 200 OK - Status retrieved successfully
  • 401 Unauthorized - Missing or invalid authentication token

​
Examples

curl http://localhost:3742/api/status \
  -H "Authorization: Bearer fn_sess_..."

​
Service Discovery

The services array includes:
  • First-party services with stored credentials (openai, anthropic)
  • Enabled built-in services (binance, onchain)
  • Custom services defined in configuration

​
Usage Metrics

  • today_spend tracks actual costs in USD based on token usage and model pricing
  • today_requests counts all requests, including those that didn’t incur costs
  • Metrics reset at midnight UTC
  • Services with no activity show 0.0 spend and 0 requests

Build docs developers (and LLMs) love

Get started for freeTalk to us