Control your entire RelAI integration programmatically.

curl -X POST https://api.relai.fi/v1/keys \
  -H "Authorization: Bearer <your-jwt>" \
  -H "Content-Type: application/json" \
  -d '{"label": "production"}'

{
  "key": "sk_live_a1b2c3d4e5f6...",
  "label": "production",
  "active": true,
  "createdAt": "2025-01-01T00:00:00.000Z",
  "note": "Store this key securely — it will not be shown again."
}

from solders.keypair import Keypair
import base58, requests

BASE = "https://api.relai.fi/mcp/management/bootstrap/agent"
kp = Keypair()  # or: Keypair.from_bytes(bytes.fromhex(os.environ["AGENT_PRIVKEY"]))

# Step 1 — request challenge
msg = requests.post(BASE, json={"publicKey": str(kp.pubkey())}).json()["message"]

# Step 2 — sign
sig = base58.b58encode(bytes(kp.sign_message(msg.encode()))).decode()

# Step 3 — get service key (runs once, then store the key)
sk = requests.post(BASE, json={
    "publicKey": str(kp.pubkey()),
    "signature": sig,
    "message": msg,
    "label": "my-agent",
}).json()["key"]

print(f"Service key: {sk}")  # → sk_live_...

import { ethers } from "ethers";

const BASE = "https://api.relai.fi/mcp/management/bootstrap/agent";
const wallet = ethers.Wallet.createRandom(); // or load from env

// Step 1 — request challenge
const { message } = await fetch(BASE, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ publicKey: wallet.address }),
}).then(r => r.json());

// Steps 2+3 — sign and get key
const signature = await wallet.signMessage(message);
const { key } = await fetch(BASE, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ publicKey: wallet.address, signature, message, label: "my-agent" }),
}).then(r => r.json());

console.log("Service key:", key); // → sk_live_...

curl -X POST https://api.relai.fi/v1/apis \
  -H "X-Service-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Prediction API",
    "baseUrl": "https://inference.example.com",
    "description": "Pay-per-call ML inference",
    "network": "base",
    "merchantWallet": "0xYourWalletAddress",
    "endpoints": [
      { "path": "/v1/predict", "method": "post", "usdPrice": 0.05 },
      { "path": "/v1/status",  "method": "get",  "usdPrice": 0.001 }
    ]
  }'

{
  "apiId": "1751234567890",
  "name": "My Prediction API",
  "description": "Pay-per-call ML inference",
  "baseUrl": "https://inference.example.com",
  "subdomain": null,
  "network": "base",
  "facilitator": "relai",
  "x402Version": 2,
  "status": "approved",
  "merchantWallet": "0xYourWalletAddress",
  "createdAt": "2025-01-01T00:00:00.000Z",
  "updatedAt": "2025-01-01T00:00:00.000Z"
}

curl https://api.relai.fi/v1/apis \
  -H "X-Service-Key: sk_live_..."

curl https://api.relai.fi/v1/apis/1751234567890 \
  -H "X-Service-Key: sk_live_..."

curl -X PATCH https://api.relai.fi/v1/apis/1751234567890 \
  -H "X-Service-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "description": "Updated description" }'

curl -X DELETE https://api.relai.fi/v1/apis/1751234567890 \
  -H "X-Service-Key: sk_live_..."

curl https://api.relai.fi/v1/apis/1751234567890/pricing \
  -H "X-Service-Key: sk_live_..."

curl -X PUT https://api.relai.fi/v1/apis/1751234567890/pricing \
  -H "X-Service-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "endpoints": [
      { "path": "/v1/predict", "method": "post", "usdPrice": 0.10 },
      { "path": "/v1/status",  "method": "get",  "usdPrice": 0.001 }
    ]
  }'

curl https://api.relai.fi/v1/apis/1751234567890/stats \
  -H "X-Service-Key: sk_live_..."

curl "https://api.relai.fi/v1/apis/1751234567890/payments?limit=20&from=2025-01-01" \
  -H "X-Service-Key: sk_live_..."

curl "https://api.relai.fi/v1/apis/1751234567890/logs?limit=20&from=2025-01-01" \
  -H "X-Service-Key: sk_live_..."