Billing

GET /v1/billing/pricing

Get operation pricing for all tools. No authentication required.

curl https://agents.systemr.ai/v1/billing/pricing

Response (200):

{
  "prices": {
    "position_sizing": "0.003",
    "risk_check": "0.004",
    "basic_eval": "0.10",
    "full_eval": "0.50",
    "comprehensive_eval": "1.00",
    "pre_trade_gate": "0.01",
    "assess_trading_system": "2.00"
  },
  "currency": "USDC"
}

---

GET /v1/billing/balance

Get the agent’s current compute credit balance.

curl https://agents.systemr.ai/v1/billing/balance \
  -H "X-API-Key: sr_agent_..."

Response (200):

{
  "agent_id": "agt_a1b2c3d4",
  "balance": "42.50",
  "is_low": false,
  "updated_at": "2026-03-25T14:30:00Z"
}

---

POST /v1/billing/deposit

Record a USDC deposit to the agent’s balance.

curl -X POST https://agents.systemr.ai/v1/billing/deposit \
  -H "X-API-Key: sr_agent_..." \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "funding_path": "direct_transfer",
    "on_chain_tx_hash": "5xYz..."
  }'

Field	Type	Required	Description
amount	string	Yes	Deposit amount in USDC.
funding_path	string	Yes	onramp, direct_transfer, or x402.
on_chain_tx_hash	string	No	On-chain transaction hash.

Response (200): Balance response with updated balance.

---

POST /v1/billing/deposit-osr

Credit balance from a verified on-chain OSR token transfer.

curl -X POST https://agents.systemr.ai/v1/billing/deposit-osr \
  -H "X-API-Key: sr_agent_..." \
  -H "Content-Type: application/json" \
  -d '{"tx_signature": "5xYz..."}'

Response (200):

{
  "agent_id": "agt_a1b2c3d4",
  "osr_amount": "10000",
  "usd_credited": "50.00",
  "rate_per_token": "0.005",
  "is_presale_buyer": false,
  "balance_after": "92.50",
  "tx_id": "tx_abc123"
}

---

POST /v1/billing/deposit-sol

Credit balance from a verified on-chain SOL transfer. Converted at live CoinGecko price.

curl -X POST https://agents.systemr.ai/v1/billing/deposit-sol \
  -H "X-API-Key: sr_agent_..." \
  -H "Content-Type: application/json" \
  -d '{"tx_signature": "5xYz..."}'

Response (200):

{
  "agent_id": "agt_a1b2c3d4",
  "currency": "SOL",
  "amount": "1.000000000",
  "sol_price_usd": "140.25",
  "compute_credits": "140.25",
  "balance_after": "182.75",
  "tx_id": "tx_def456",
  "tx_signature": "5xYz..."
}

---

POST /v1/billing/deposit-usdc

Credit balance from a verified on-chain USDC transfer. 1:1 USD conversion.

curl -X POST https://agents.systemr.ai/v1/billing/deposit-usdc \
  -H "X-API-Key: sr_agent_..." \
  -H "Content-Type: application/json" \
  -d '{"tx_signature": "5xYz..."}'

Response (200):

{
  "agent_id": "agt_a1b2c3d4",
  "currency": "USDC",
  "amount": "100.00",
  "compute_credits": "100.00",
  "balance_after": "142.50",
  "tx_id": "tx_ghi789",
  "tx_signature": "5xYz..."
}

---

POST /v1/billing/deposit-usdt

Credit balance from a verified on-chain USDT transfer. 1:1 USD conversion.

Same request/response format as deposit-usdc, with "currency": "USDT".

---

POST /v1/billing/deposit-pyusd

Credit balance from a verified on-chain PYUSD transfer. 1:1 USD conversion.

Same request/response format as deposit-usdc, with "currency": "PYUSD".

---

GET /v1/billing/transactions

Get recent billing transactions.

curl "https://agents.systemr.ai/v1/billing/transactions?limit=20" \
  -H "X-API-Key: sr_agent_..."

Parameter	Type	Default	Description
limit	int	100	Max transactions to return.

Response (200):

{
  "transactions": [
    {
      "tx_id": "tx_abc123",
      "type": "consumption",
      "amount": "0.01",
      "balance_after": "42.49",
      "created_at": "2026-03-25T14:30:00Z",
      "operation": "pre_trade_gate",
      "funding_path": null
    },
    {
      "tx_id": "tx_xyz789",
      "type": "deposit",
      "amount": "50.00",
      "balance_after": "42.50",
      "created_at": "2026-03-25T10:00:00Z",
      "operation": null,
      "funding_path": "direct_transfer"
    }
  ],
  "count": 2
}

---

GET /v1/billing/usage

Get usage summary grouped by operation type.

curl https://agents.systemr.ai/v1/billing/usage \
  -H "X-API-Key: sr_agent_..."

Response (200):

{
  "agent_id": "agt_a1b2c3d4",
  "operations": {
    "pre_trade_gate": {
      "count": 45,
      "total_cost": "0.45"
    },
    "calculate_position_size": {
      "count": 120,
      "total_cost": "0.36"
    },
    "run_monte_carlo": {
      "count": 8,
      "total_cost": "0.064"
    }
  }
}