Quickstart

Get running with RefineX in 5 minutes.

1

Get your API key

Request an API key through our enterprise form. You'll receive your key within 24 hours.

# Get your API key from https://refinex.io/enterprise
export REFINEX_API_KEY="sk_live_..."
2

Test your connection

Verify your API key works by calling the health endpoint.

curl -H "X-API-Key: $REFINEX_API_KEY" \
  "https://api.refinex.io/v1/health"

# Response
{
  "status": "healthy",
  "version": "1.0.0",
  "timestamp": "2026-01-28T12:00:00Z"
}
3

Get your first signal

Request a signal for a specific instance type.

curl -H "X-API-Key: $REFINEX_API_KEY" \
  "https://api.refinex.io/v1/signals/active?cloud=aws&region=us-east-1&instance_type=c7g.xlarge"

# Response
{
  "action": "buy_spot",
  "signal": {
    "type": "spot_arbitrage",
    "confidence": 0.94,
    "expected_value": {
      "savings_percent": 70.6,
      "savings_usd_per_hour": 0.102
    },
    "ttl": 600
  }
}

Next Steps