Interface Taxonomy Scoring API
v1.0 · For schools, enterprises & integration partners · Real-time NCI scoring
API Live
8
Taxonomy Levels
0–100
NCI Score Range
500
Max Batch Size
500×
Max Multiplier
What This API Does
The Interface Taxonomy Scoring API allows external institutions — schools, enterprises, LMS platforms, and EEG hardware vendors — to submit cognitive session data and receive back standardized scoring across three dimensions: NCI Score (Neural Complexity Index), Taxonomy Level (0–7), and recommended VOLTS minting value.
NCI Score
Composite neural complexity index (0–100) derived from gamma, phi, coherence, theta/beta coupling
Taxonomy Level
8-level cognitive classification (Passive → Transcendent) with economic multiplier
VOLTS Minting
Standardized recommended VOLTS value for the session, ready to pass to the minting service
Quick Start (cURL)
bash
# Score a single session
curl -X POST https://your-app.base44.app/functions/taxonomyAPI \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "score",
"session": {
"gamma_psd": 0.72,
"coherence_pct": 68,
"duration_seconds": 3600
}
}'Quick Start (JavaScript)
javascript
const response = await fetch('https://your-app.base44.app/functions/taxonomyAPI', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
action: 'score',
session: {
session_id: 'sess_001',
user_id: 'student_42',
gamma_psd: 0.72,
phi_estimate: 0.61,
coherence_pct: 68,
duration_seconds: 3600,
task_type: 'deep_work',
}
})
});
const { result } = await response.json();
console.log(`Level ${result.taxonomy.level}: ${result.taxonomy.name}`);
console.log(`NCI Score: ${result.nci_score}`);
console.log(`Recommended VOLTS: ${result.recommended_volts}`);Quick Start (Python)
python
import requests
response = requests.post(
'https://your-app.base44.app/functions/taxonomyAPI',
headers={
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
json={
'action': 'score',
'session': {
'session_id': 'sess_001',
'user_id': 'student_42',
'gamma_psd': 0.72,
'phi_estimate': 0.61,
'coherence_pct': 68,
'duration_seconds': 3600,
}
}
)
data = response.json()
result = data['result']
print(f"Level {result['taxonomy']['level']}: {result['taxonomy']['name']}")
print(f"NCI Score: {result['nci_score']}")
print(f"VOLTS: {result['recommended_volts']}")