Membook Testnet API

Live endpoint: https://api.membook.cyborama.com | Live Dashboard

Authentication

Use the appropriate API key header:

• Provider API: X-API-Key: membook-provider-key
• Consumer API: X-API-Key: membook-consumer-key

Provider API

Register a provider

curl -X POST https://api.membook.cyborama.com/api/providers \
  -H "X-API-Key: membook-provider-key" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "your-hostname",
    "specs": {
      "ram": {"total_gb": 8},
      "geolocation": {"country": "US"},
      "heartbeat": {"uptime_seconds": 1000}
    }
  }'

Send heartbeat

curl -X POST https://api.membook.cyborama.com/api/providers/{provider_id}/heartbeat \
  -H "X-API-Key: membook-provider-key"

List providers

curl -H "X-API-Key: membook-provider-key" \
  https://api.membook.cyborama.com/api/providers

Consumer API

Request a memory block

curl -X POST https://api.membook.cyborama.com/api/blocks \
  -H "X-API-Key: membook-consumer-key" \
  -H "Content-Type: application/json" \
  -d '{
    "size_gb": 4,
    "duration_hours": 2,
    "max_latency_ms": 50,
    "redundancy": 3
  }'

Connect to a block

curl -X POST https://api.membook.cyborama.com/api/blocks/{block_id}/connect \
  -H "X-API-Key: membook-consumer-key"

List your blocks

curl -H "X-API-Key: membook-consumer-key" \
  https://api.membook.cyborama.com/api/blocks

WebSocket Updates

Real‑time provider/block updates are available via WebSocket:

wss://api.membook.cyborama.com/ws

Error Codes

• 400 – Bad request
• 401 – Invalid API key
• 404 – Resource not found
• 429 – Rate limit exceeded
• 500 – Internal server error