KYSC API
Free access to stablecoin trust scores, compliance data, and risk intelligence for 91 coins.
14
endpoints
100
req/min
0
auth required
Base URL
https://www.kysc.ioAll endpoints return JSON wrapped in a standard envelope with data and meta fields. The meta object includes the engine version, data date, and response timestamp.
Endpoints
GET
/api/v1/coinsAll scored stablecoins with trust scores, grades, and component breakdowns.
Optional: ?grade=A&backing_model=FIAT_CUSTODIED
Request
curl -s https://www.kysc.io/api/v1/coinsResponse
{
"data": {
"coins": [
{
"symbol": "USDC",
"issuer": "Circle",
"trust_score": 91,
"grade": "A",
"confidence": 0.97,
"backing_model": "FIAT_CUSTODIED",
"components": {
"reserve_health": { "score": 90, "weight": 0.3, "weighted": 27 },
"liquidity": { "score": 85, "weight": 0.18, "weighted": 15.3 },
"governance": { "score": 90, "weight": 0.12, "weighted": 10.8 },
"onchain_health": { "score": 96, "weight": 0.12, "weighted": 11.5 },
"track_record": { "score": 91, "weight": 0.12, "weighted": 10.9 },
"yield_sustainability": { "score": 92, "weight": 0.09, "weighted": 8.3 },
"adoption_signal": { "score": 100, "weight": 0.07, "weighted": 7 }
},
"flags": { "endogenousCollateral": false, "sunset": false, "structuralFragility": false },
"summary": "Institutional grade. Strongest: adoption (100)."
}
],
"count": 91
},
"meta": { "version": "v3.1", "date": "2026-04-04", "timestamp": "..." }
}GET
/api/v1/coins/{symbol}Single coin with full scoring details including all sub-scores.
Request
curl -s https://www.kysc.io/api/v1/coins/USDCResponse
{
"data": {
"symbol": "USDC",
"issuer": "Circle",
"track": "A",
"backing_model": "FIAT_CUSTODIED",
"trust_score": 91,
"grade": "A",
"confidence": 0.97,
"components": {
"reserve_health": {
"score": 90, "weight": 0.3, "weighted": 27,
"details": {
"ratio_score": 85, "composition_quality": 89,
"attestation_rigor": 95, "auditor_score": 100,
"custodian_quality": 100, "banking_concentration_score": 70
}
}
}
},
"meta": { "version": "v3.1", "date": "2026-04-04", "timestamp": "..." }
}GET
/api/v1/coins/{symbol}/complianceRegulatory compliance package: GENIUS Act, MiCA, FCA, MAS, Basel, and more.
Request
curl -s https://www.kysc.io/api/v1/coins/USDC/complianceResponse
{
"data": {
"symbol": "USDC",
"trust_score": { "score": 91, "grade": "A" },
"regulatory_classification": {
"per_jurisdiction": {
"US": { "framework": "GENIUS Act", "classification": "PPSI", "qualifies_as_stablecoin": true },
"EU": { "framework": "MiCA", "classification": "EMT", "qualifies_as_stablecoin": true },
"Basel": { "framework": "Basel SCO60", "classification": "GROUP_1B" }
}
},
"compliance_assessment": {
"lane": "payment_stablecoin",
"genius": { "result": "PERMITTED", "permitted_issuer": true },
"mica_emt": { "result": "AUTHORIZED", "eu_compliant_for_offering": true },
"fca": { "result": "PATH_TO_COMPLIANCE", "requirements_met": 5, "requirements_total": 11 }
}
},
"meta": { "version": "v3.1", "date": "2026-04-04", "timestamp": "..." }
}GET
/api/v1/coins/{symbol}/classifyBasel SCO60 classification evidence. CC1-CC4 condition tests with entity chain.
Request
curl -s https://www.kysc.io/api/v1/coins/USDC/classifyResponse
{
"data": {
"symbol": "USDC",
"basel_classification": {
"conditions": {
"cc1_stabilisation": { "status": "PASS", "mechanism": "asset_backed" },
"cc2_settlement_finality": { "status": "REVIEW_NEEDED" },
"cc3_network_risk": { "status": "PASS", "governance_score": 90 },
"cc4_regulated_entities": {
"status": "PASS",
"all_regulated": true,
"entity_chain": [
{ "role": "issuer", "entity": "Circle Internet Financial, LLC", "regulator": "NYDFS" },
{ "role": "reserve_manager", "entity": "BlackRock Financial Management, Inc.", "regulator": "SEC" },
{ "role": "custodian", "entity": "The Bank of New York Mellon", "regulator": "OCC" }
]
}
},
"result": "GROUP_1B",
"capital_treatment": "Standard credit risk framework"
}
},
"meta": { "version": "v3.1", "date": "2026-04-04", "timestamp": "..." }
}GET
/api/v1/contagion/{symbol}Shared exposure and contagion risk: auditor overlap, collateral dependencies, liquidity pool cascades.
Request
curl -s https://www.kysc.io/api/v1/contagion/USDCResponse
{
"data": {
"symbol": "USDC",
"contagion_clusters": [
{
"risk": "Auditor failure / credibility loss",
"exposure_type": "auditors",
"shared_entity": "Deloitte",
"affected": ["EURC"]
},
{
"risk": "Collateral asset crash",
"exposure_type": "collateral_assets",
"shared_entity": "US Treasuries",
"affected": ["USDT", "PYUSD", "DAI", "USDP", "GUSD", "FDUSD", "BUSD", "TUSD"]
},
{
"risk": "Liquidity pool cascade",
"exposure_type": "liquidity_pools",
"shared_entity": "Curve 3pool",
"affected": ["USDT", "DAI"],
"historical_precedent": "June 2023 — USDT hit 73% Curve 3pool share during stress event"
}
]
},
"meta": { "version": "v3.1", "date": "2026-04-04", "timestamp": "..." }
}GET
/api/v1/utility/{symbol}Utility scores across 9 dimensions for each purpose. Filter with optional ?purpose= param.
Optional: ?purpose=xborder
Request
curl -s https://www.kysc.io/api/v1/utility/USDCResponse
{
"data": {
"symbol": "USDC",
"purposes": {
"xborder": {
"utility_score": 86,
"dimensions": {
"tce": 84, "rf": 81, "yo": 66, "cm": 100,
"cr": 24, "pi": 97, "ora": 82, "ss": 70, "cdb": 50
}
},
"treasury": { "utility_score": 89, "dimensions": { ... } },
"defi_collateral": { "utility_score": 91, "dimensions": { ... } },
"payments": { "utility_score": 88, "dimensions": { ... } }
}
},
"meta": { "version": "v3.1", "date": "2026-04-04", "timestamp": "..." }
}GET
/api/v1/leaderboardGlobal leaderboard with variance data. Filter by profile or jurisdiction.
Optional: ?profile=treasury or ?jurisdiction=EU
Request
curl -s https://www.kysc.io/api/v1/leaderboard?profile=treasuryResponse
{
"data": {
"profile": "treasury",
"leaderboard": [
{
"symbol": "USDC", "issuer": "Circle",
"trust_score": 91, "grade": "A", "confidence": 0.97,
"backing_model": "FIAT_CUSTODIED",
"components": { ... }
},
{
"symbol": "USDT", "issuer": "Tether",
"trust_score": 74, "grade": "C", "confidence": 0.93,
"backing_model": "FIAT_CUSTODIED",
"components": { ... }
}
],
"variance": { ... },
"count": 91
},
"meta": { "version": "v3.1", "date": "2026-04-04", "timestamp": "..." }
}GET
/api/v1/coins/{symbol}/evidencePer-component evidence sources, sub-metrics, source types, and intelligence verification status.
Request
curl -s https://www.kysc.io/api/v1/coins/USDC/evidenceResponse
{
"data": {
"symbol": "USDC",
"evidence_available": true,
"components": {
"reserve_health": {
"sub_metric_count": 5,
"available": 5, "missing": 0,
"source_types": ["ISSUER_ATTESTATION", "ON_CHAIN"],
"sub_metrics": [
{ "key": "reserve_ratio", "label": "Reserve Ratio", "source_type": "ISSUER_ATTESTATION", "missing": false }
]
}
},
"intelligence": {
"verification_status": "verified",
"source_count": 12, "claim_count": 45
}
},
"meta": { ... }
}GET
/api/v1/coins/{symbol}/historyScore snapshots over time. Each snapshot is immutable and hash-chained.
Request
curl -s https://www.kysc.io/api/v1/coins/USDC/historyResponse
{
"data": {
"symbol": "USDC",
"snapshot_count": 3,
"snapshots": [
{
"snapshot_id": "snap-20260317-0600",
"timestamp": "2026-03-17T06:00:00Z",
"trust_score": 91, "grade": "A",
"components": { "reserve_health": 90, "liquidity": 85, ... }
}
],
"current": { "trust_score": 91, "grade": "A", "components": { ... } }
},
"meta": { ... }
}GET
/api/v1/coins/{symbol}/exportAudit-grade JSON with full attribution per field. Every component includes source type and sub-metric evidence.
Request
curl -s https://www.kysc.io/api/v1/coins/USDC/exportResponse
{
"data": {
"symbol": "USDC", "issuer": "Circle",
"trust_score": 91, "grade": "A",
"components": {
"reserve_health": {
"label": "Reserve Health", "score": 90, "weight": 0.3,
"sub_metrics": [
{ "key": "reserve_ratio", "source_type": "ISSUER_ATTESTATION", "raw_input": "1.23x", "scoring_logic": "..." }
]
}
},
"compliance_summary": { "lane": "payment_stablecoin", "frameworks": [...] },
"provenance": {
"snapshot_id": "...", "methodology_version": "...",
"disclaimer": "...", "scope": "...", "limitations": "..."
}
},
"meta": { ... }
}GET
/api/v1/compareMulti-coin comparison with component matrix and ranking. 2-10 coins.
Required: ?coins=USDC,USDT,DAI
Request
curl -s "https://www.kysc.io/api/v1/compare?coins=USDC,USDT,DAI"Response
{
"data": {
"coins": [
{ "symbol": "USDC", "trust_score": 91, "grade": "A", "components": { ... } },
{ "symbol": "USDT", "trust_score": 74, "grade": "C", "components": { ... } },
{ "symbol": "DAI", "trust_score": 72, "grade": "C", "components": { ... } }
],
"ranked": [
{ "rank": 1, "symbol": "USDC", "trust_score": 91, "grade": "A" },
{ "rank": 2, "symbol": "USDT", "trust_score": 74, "grade": "C" }
],
"comparison_matrix": {
"reserve_health": { "USDC": 90, "USDT": 65, "DAI": 70 }
}
},
"meta": { ... }
}GET
/api/v1/methodologyCurrent scoring methodology, component weights, regulatory frameworks, and changelog.
Request
curl -s https://www.kysc.io/api/v1/methodologyResponse
{
"data": {
"current": {
"methodology_version": "v3.1",
"data_version": "v3.1",
"snapshot_id": "..."
},
"scoring": {
"model": "7-component weighted trust score",
"scale": "0-100",
"components": [
{ "key": "reserve_health", "label": "Reserve Health", "weight": 0.25 }
]
},
"compliance": {
"frameworks": [
{ "key": "genius", "name": "US GENIUS Act", "jurisdiction": "United States" }
]
},
"changelog": [...]
},
"meta": { ... }
}GET
/api/v1/entitiesAll entities in the KYSC knowledge base (custodians, auditors, blockchains, issuers, protocols). Filter by type.
Optional: ?type=custodian
Request
curl -s https://www.kysc.io/api/v1/entities?type=custodianResponse
{
"data": {
"count": 9,
"entities": [
{
"id": "bny-mellon", "name": "BNY Mellon", "type": "custodian",
"credit_rating": "AA-", "jurisdictions": ["US"],
"exposed_coin_count": 2
}
]
},
"meta": { ... }
}GET
/api/v1/entities/{id}Entity profile with full details and blast radius (all coins exposed to this entity).
Request
curl -s https://www.kysc.io/api/v1/entities/bny-mellonResponse
{
"data": {
"id": "bny-mellon", "name": "BNY Mellon", "type": "custodian",
"credit_rating": "AA-", "jurisdictions": ["US"],
"regulatory_status": "OCC regulated, NYDFS regulated",
"substitutability_score": 0.3,
"exposed_coins": [
{ "symbol": "USDC", "exposure_type": "custodians", "trust_score": 91, "grade": "A" }
],
"exposed_coin_count": 2
},
"meta": { ... }
}Response Format
Every response follows the same envelope structure.
{
"data": { ... }, // Endpoint-specific payload
"meta": {
"version": "v3.1", // Engine version
"date": "2026-04-04", // Data snapshot date
"timestamp": "..." // Response ISO timestamp
}
}
// Errors follow the same envelope:
{
"data": { "error": "Coin 'XYZ' not found" },
"meta": { ... }
}Rate Limits
Free tier
- 100 requests per minute per IP
- No authentication required
- CORS enabled for all origins
- 1-hour cache with stale-while-revalidate
Rate limit headers
X-RateLimit-Limitmax requestsX-RateLimit-Remainingremaining in windowX-RateLimit-Resetwindow reset (unix)Exceeding the limit returns 429 Too Many Requests with a Retry-After: 60 header.
Use Cases
Embed trust scores in DeFi protocol risk parameters
Monitor compliance status for exchange listings
Power risk dashboards with component-level data
Build regulatory reporting pipelines
Automate Basel SCO60 classification checks
Track contagion exposure across stablecoin portfolios
Quick Start
Get the trust score for any stablecoin in one line.
# Get USDC trust score
curl -s https://www.kysc.io/api/v1/coins/USDC | jq '.data.trust_score'
# => 91
# Get all A-grade coins
curl -s "https://www.kysc.io/api/v1/coins?grade=A" | jq '.data.coins[].symbol'
# Check Basel classification
curl -s https://www.kysc.io/api/v1/coins/USDC/classify | jq '.data.basel_classification.result'
# => "GROUP_1B"
# Find contagion risk
curl -s https://www.kysc.io/api/v1/contagion/USDC | jq '.data.contagion_clusters[].shared_entity'Get an API Key
The public API is free and unauthenticated. Register for a key to get higher rate limits and access to upcoming premium endpoints.
Questions? jam@kysc.io