X account score

Operation: x_account_score
Price: 5 credits / $0.05 display equivalent
Scope: scores:read

See REST result fields for Trust, Confidence, status, freshness, ledger, charge source and balance units.

Supply an X handle or canonical subject resolvable by inVerus. The result belongs to the X Page and must not be displayed as the score of an associated Agent, Skill or Creator.

{
  "operation": "x_account_score",
  "subject": "@handle",
  "channel": "api",
  "idempotency_key": "x-handle-01"
}

When to use it

Use x_account_score to evaluate an X communication identity associated with a Creator or artifact, or to review the account independently. It does not assess code linked or promoted by that account.

Code examples

curl --request POST 'https://www.clawdbase.ai/api/clawdbase/operations/run' \
  --header "Authorization: Bearer $CLAWDBASE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "operation": "x_account_score",
    "subject": "@handle",
    "channel": "api",
    "idempotency_key": "review-220:x_account_score:handle"
  }'

const response = await fetch('https://www.clawdbase.ai/api/clawdbase/operations/run', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CLAWDBASE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    operation: 'x_account_score',
    subject: '@handle',
    channel: 'api',
    idempotency_key: `review-220:x_account_score:handle`,
  }),
  signal: AbortSignal.timeout(50_000),
})

const body = await response.json()
if (!response.ok) throw new Error(body.error)

import os
import requests

response = requests.post(
    "https://www.clawdbase.ai/api/clawdbase/operations/run",
    headers={
        "Authorization": f"Bearer {os.environ['CLAWDBASE_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "operation": "x_account_score",
        "subject": "@handle",
        "channel": "api",
        "idempotency_key": "review-220:x_account_score:handle",
    },
    timeout=50,
)

body = response.json()
if not response.ok:
    raise RuntimeError(body.get("error", "operation failed"))

The operation requires scores:read and costs 5 credits after eligible Free calls. A failed inVerus request reverses the reservation and can be retried with the same idempotency key.

Canonical identity

For registered Pages, the immutable X user ID anchors ownership and deduplication even though the public route uses /x/{handle}. A developer operation subject is a resolver input, not proof that the caller owns the account.

Keep score types separate

An X account can be related to a Creator, Agent or Skill, but its Trust and Confidence remain X account evidence. Label the Page type when presenting several assessments together and keep each timestamp visible.

Scope, price and failure

The operation requires scores:read and costs 5 credits after eligible Free calls. Invalid or unresolved input must not create a Page. A failed inVerus request reverses the reservation and can be retried with the same idempotency key.

Registration relationship

Ownership is established separately through X OAuth 2.0 PKCE. See X registration when the goal is to create or manage the canonical Page.