API References

The Tythe API Suite enables platforms, protocols, and applications to integrate decentralized credibility infrastructure without ever handling personal user data. Each endpoint is designed for modular, ZK-compliant credibility integration with minimal setup.

All APIs follow RESTful structure and work without needing to track or store platform-side identity data.

Below is a reference of the core APIs used across onboarding, DISC Scoring, Credonation, and metadata access.

Example Metric Selection by Platform

Here’s what a full platform configuration might look like:

🟦 Financial

• financial_txn_consistency → High

• financial_liquidity_provision → Critical

→ Cumulative: 0.24

🟨 Creative

• creative_code_contribution → Moderate

• creative_bugs_found → High

→ Cumulative: 0.17

🟧 Educational

• educational_research_authorship → High

• educational_workshop_hosted → Low

→ Cumulative: 0.13

🟩 Behavioral

• behavioral_peer_feedback_score → Minimal

• behavioral_votes_delegated → High

→ Cumulative: 0.11

🟫 Social

• social_verified_identity_linked → Moderate

→ Cumulative: 0.07

🟥 Security

• security_login_pattern_stability → Moderate

• security_verified_identity → High

→ Cumulative: 0.17

🟪 Compliance

• compliance_moderation_flags → High

→ Cumulative: 0.10

Total Weight → 0.99

1. Decision Relay API

POST /api/decision-relay

Submit score-relevant user actions to Tythe for evaluation and scoring.

Payload (json):

{ "tris_id": "tris@satoshi", "action_type": "completed_transaction", "category": "financial", "criticality": "high", "platform_id": "platform_xyz" }

Response (json):

{ "status": "received", "message": "decision relay accepted and processed" }

2. DISC Score Lookup (For Individuals)

GET /api/disc-score/{tris_id}

Fetch public DISC Score and category metadata.

Response (json):

{ "tris_id": "tris@satoshi", "total_tct": 13704.2, "score_rating": "Very Good", "disc_metrics": { "financial": 0.20, "creative": 0.26, "educational": 0.15, "behavioral": 0.08, "social": 0.05, "security": 0.17, "compliance": 0.09 } }

3. DISC Rank Lookup (For Organizations)

GET /api/disc-rank/{tris_id}

Fetches the DISC Rank and TCT accumulation of a vetted organization.

Response (json):

{ "tris_id": "tris@aave", "tct_total": 21944.7, "disc_rank": "Platinum" }

4. TRIS ID Linker

POST /api/link-account

Link an existing user or wallet identity on your platform to a TRIS.

Payload (json):

{ "wallet": "0xabc123...", "tris_id": "tris@satoshi" }

Response (json):

{ "status": "linked" }

5. Credonation Metadata (Read-Only)

GET /api/tris-validations/{tris_id}

Returns a list of Credonations received by a TRIS. For visibility only - Credonate is internal to Tythe and cannot be triggered externally.

Response (json):

{ "tris_id": "tris@satoshi", "validations": [ { "from": "tris@vitalik", "amount": 2.5, "timestamp": "2025-03-01T15:20:34Z", "category": "behavioral" }, { "from": "tris@sandeep", "amount": 5.0, "timestamp": "2025-03-04T12:03:06Z", "category": "creative" } ] }

Note: The endpoints and sample payloads above are for reference only. Refer to the official developer docs or Postman collection (coming soon) for full schemas, authentication parameters, and testnet access.

---

“By wise guidance you can wage your war, and in abundance of counselors there is victory.”

— Proverbs 24:6