Connect your agent to
live market intelligence

Your DID is derived from your XRPL wallet address. Format: did:poi:xrpl:<wallet>. Check your current score (starts at 300, max 850).

# Check ARGUS credit score — free, no auth
curl https://squeezeos-api.onrender.com/api/credit-score \
  -H "X-Agent-DID: did:poi:xrpl:rYOUR_WALLET_ADDRESS"

# Response
{
  "agentDid": "did:poi:xrpl:rYOUR_WALLET_ADDRESS",
  "creditScore": 300,
  "tier": "PROTOSTAR",
  "priceRlusd": "0.10",
  "callsToNextTier": 40
}

Call /x402/quote to get the exact cost before paying. ARGUS tier discounts are applied automatically. Quote is valid for 60 seconds.

curl "https://squeezeos-api.onrender.com/x402/quote?tool=council_full" \
  -H "X-Agent-DID: did:poi:xrpl:rYOUR_WALLET_ADDRESS"

{
  "quoteId": "q_abc123",
  "toolId": "council_full",
  "effectiveAmount": "0.10",
  "currency": "RLUSD",
  "network": "xrpl-mainnet",
  "destination": "rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
  "expiresAt": "2026-01-01T00:01:00Z",
  "agentTier": "PROTOSTAR"
}

Send the exact amount from your quote to the receiving address. Use xrpl.js, xrpl-py, or any XRPL SDK. The memo field must contain the tool ID so the server can route your payment.

# RLUSD IOU details
# currency hex: 524C555344000000000000000000000000000000
# issuer:       rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De
# destination:  rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh

# xrpl-py snippet
from xrpl.models.transactions import Payment
from xrpl.models.amounts import IssuedCurrencyAmount
from xrpl.models.base_model import Memo, MemoData

tx = Payment(
    account=wallet.address,
    destination="rHb9CJAWyB4rj91VRWn96DkukG4bwdtyTh",
    amount=IssuedCurrencyAmount(
        currency="524C555344000000000000000000000000000000",
        issuer="rMxCKbEDwqr76QuheSUMdEGf4B9xJ8m5De",
        value="0.10"
    ),
    memos=[Memo(memo_data=MemoData(data=b"council_full".hex()))]
)
result = client.request(SubmitAndWait(transaction=sign(tx, wallet)))

Build the payment proof object, base64-encode it, and include it as the X-Payment-Proof header on your API call. The server verifies the transaction on-chain before returning data.

# Build payment proof
proof = base64.b64encode(json.dumps({
    "txHash":   "ABCDEF1234...",   # from step 3
    "payer":    "rYOUR_WALLET_ADDRESS",
    "amount":   "0.10",
    "currency": "RLUSD",
    "network":  "xrpl-mainnet"
}).encode()).decode()

# Call the paid endpoint
curl -X POST https://squeezeos-api.onrender.com/api/council \
  -H "X-Agent-DID: did:poi:xrpl:rYOUR_WALLET_ADDRESS" \
  -H "X-Payment-Proof: <base64-proof>" \
  -H "X-Idempotency-Key: <uuid>" \
  -H "Content-Type: application/json" \
  -d '{"symbol":"XRPUSD"}'

The response includes two score headers — no extra API call needed:

• X-402-Score-EarnedYour new ARGUS score after this paid call (+5 per call)
• X-402-TierCurrent tier: PROTOSTAR / NEUTRON / PULSAR / QUASAR
• X-Idempotency-Replayedtrue if result came from 300s cache (no double charge)

Add the SqueezeOS MCP server to your agent's config. The server handles x402 negotiation automatically — your agent never sees raw HTTP 402s.

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "squeezeos": {
      "url": "https://squeezeos-api.onrender.com/mcp",
      "transport": "streamable-http"
    }
  }
}

// .cursor/mcp.json (project) or ~/.cursor/mcp.json (global)
{
  "mcpServers": {
    "squeezeos": {
      "url": "https://squeezeos-api.onrender.com/mcp",
      "transport": "streamable-http"
    }
  }
}

# ~/.continue/config.yaml
mcpServers:
  - name: squeezeos
    url: https://squeezeos-api.onrender.com/mcp
    transport: streamable-http

# Python — anthropic SDK with MCP
from anthropic import Anthropic
client = Anthropic()
result = client.beta.messages.create(
    model="claude-opus-4-8",
    mcp_servers=[{
        "type": "url",
        "url": "https://squeezeos-api.onrender.com/mcp",
        "name": "squeezeos"
    }],
    messages=[{"role": "user", "content": "Run a squeeze scan on XRPUSD"}]
)

Every paid call earns +5 ARGUS points. Higher tiers earn automatic price discounts — no coupon codes, no subscription upgrade required.

Full OpenAPI 3.1 spec: /.well-known/openapi.json · AgentCard: /.well-known/agent.json