POST

/api/v1/x/profile

Psychographic profile of one X account

Price $0.50 per callAuth x-quotient-api-key or x402Limit 1/s · 6/min · 100/day

Parameters

None.

Response fields

Field	Type	Meaning
handle	string
display_name	string
profile_url	string
quotient_metadata	QuotientXAccountMetadata	Quotient's account classification metadata. Reviewed expert status is provenance, not an accuracy guarantee.
window	object
interests	object[]
beliefs	object[]
tendencies	object[]
risk_profile	object
information_processing	object	How the account handles complex, ambiguous, or conflicting information.
recommendation_hints	object	Direct inputs for tailoring suggestions to this person.
observations	object[]	Raw per-sweep findings before synthesis, each citing its own post_ids.
evidence	object[]	Every grounded post the profile draws on. All post_ids resolve here.
confidence	"low" \| "medium" \| "high"
gaps	string[]	What the window could not establish, including any sweep that failed and was excluded.
meta	object

Billing and limits

Calls are billed to prepaid credits, or per call over x402. The price above is the reference price; the 402 challenge returned at request time is what a call actually costs.

One request may be in flight at a time, and request starts must be at least one second apart. A rejected 429 is not billed. See rate limits.

curl

curl -H "x-quotient-api-key: qt_…" \
  "https://quotient-api-gateway.onrender.com/api/v1/x/profile"

200 · application/json

{
  "handle": "…",
  "display_name": "…",
  "profile_url": "…",
  "quotient_metadata": {
    "handle": "…",
    "display_name": "…",
    "x_user_id": "…",
    "current_username": "…",
    "is_quotient_expert": false,
    "quotient_expert": {
      "designation": "reviewed_expert",
      "policy_version": "…"
    }
  },
  "window": {
    "from_date": "…",
    "to_date": "…",
    "lookback_days": 0,
    "post_count": 0
  },
  "interests": [
    {}
  ],
  "beliefs": [
    {}
  ],
  "tendencies": [
    {}
  ],
  "risk_profile": {},
  "information_processing": {},
  "recommendation_hints": {
    "market_categories": [
      "…"
    ],
    "tone": "…",
    "avoid": [
      "…"
    ]
  },
  "observations": [
    {
      "dimension": "…",
      "statement": "…",
      "post_ids": [
        "…"
      ]
    }
  ],
  "evidence": [
    {
      "post_id": "…",
      "url": "…",
      "published_at": "…",
      "excerpt": "…"
    }
  ],
  "confidence": "low",
  "gaps": [
    "…"
  ],
  "meta": {}
}