Developer Documentation

Everything you need to integrate connection intelligence into your platform.

Quick Start

Up and running in under 5 minutes.

Sign up for API access

Apply for early access on the waitlist page. You'll receive your credentials within 24 hours.

Get your API key

Find your API key in the dashboard under Settings → API Keys. Keep it secret — treat it like a password.

Make your first request

Using cURL:

bash

curl -X POST https://api.elodtx.com/v1/compatibility \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_a": "usr_8f3k2j", "user_b": "usr_9d4m1n"}'

Or with the JavaScript SDK:

javascript

import EloDtx from '@elodtx/sdk';

const client = new EloDtx({ apiKey: 'YOUR_API_KEY' });

const result = await client.compatibility.check({
  userA: 'usr_8f3k2j',
  userB: 'usr_9d4m1n',
});

console.log(result.score); // 0.84

Authentication

All API requests must include a valid JWT (JSON Web Token) in the Authorization header using the Bearer scheme. Tokens expire after 24 hours and can be refreshed using your API key. Never expose your token in client-side code — always make API calls from a secure server environment.

bash

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

API Reference

Base URL: https://api.elodtx.com

POST/api/v1/compatibility

Get compatibility score between two users

Request

json

{
  "user_a": "usr_8f3k2j",
  "user_b": "usr_9d4m1n",
  "include_dimensions": true
}

Response

json

{
  "score": 0.84,
  "confidence": 0.92,
  "dimensions": {
    "communication_style": 0.91,
    "values_alignment": 0.87,
    "emotional_intelligence": 0.79,
    "lifestyle_compatibility": 0.82
  },
  "conversation_starters": [
    "You both value deep conversations over small talk",
    "Shared interest in creative pursuits"
  ]
}

GET/api/v1/feed

Get personalized ranked feed for a user

Response

json

{
  "user_id": "usr_8f3k2j",
  "feed": [
    {
      "match_id": "usr_9d4m1n",
      "score": 0.84,
      "reason": "High values alignment + complementary communication styles",
      "optimal_contact_time": "2026-03-30T18:30:00Z"
    }
  ],
  "generated_at": "2026-03-30T14:22:00Z"
}

POST/api/v1/proximity/location

Update user location hash for proximity matching

Request

json

{
  "user_id": "usr_8f3k2j",
  "geohash": "mk2g7d",
  "active": true
}

Response

json

{
  "status": "updated",
  "nearby_matches": 3,
  "highest_score": 0.84
}

GET/api/v1/knowme/questions

Get today's Know Me questions for a user

Response

json

{
  "user_id": "usr_8f3k2j",
  "questions": [
    {
      "id": "q_247",
      "dimension": "communication_style",
      "option_a": "I prefer to process my thoughts before responding",
      "option_b": "I think best while talking things through"
    },
    {
      "id": "q_118",
      "dimension": "values",
      "option_a": "Stability and predictability give me peace",
      "option_b": "I thrive on change and new experiences"
    }
  ],
  "completed": 94,
  "total": 138
}

POST/api/v1/whisper/suggest

Get contextual conversation suggestion

Request

json

{
  "conversation_id": "conv_4k8m2",
  "user_id": "usr_8f3k2j",
  "context_window": 5
}

Response

json

{
  "whisper": {
    "suggestion": "She mentioned not going back to her hometown much — her answers suggest this means something to her. This could be worth exploring gently.",
    "confidence": 0.88,
    "source": "cross_reference",
    "dimension": "emotional_depth",
    "dismissible": true
  }
}

Code Examples

Compatibility check — full example in JavaScript, Python, and Swift.

javascript

import EloDtx from '@elodtx/sdk';

const client = new EloDtx({
  apiKey: process.env.ELODTX_API_KEY,
});

const result = await client.compatibility.check({
  userA: 'usr_8f3k2j',
  userB: 'usr_9d4m1n',
  includeDimensions: true,
});

console.log(result.score);        // 0.84
console.log(result.dimensions);   // { communication_style: 0.91, ... }

Rate Limits

Requests exceeding these limits return a 429 Too Many Requests response. Burst limits allow short traffic spikes above the per-minute rate.

Tier	Requests / min	Requests / day	Burst limit
Starter	60	10,000	100
Growth	300	100,000	500
Scale	1,000	1,000,000	2,000

Pricing Calculator

Estimate your monthly cost based on monthly active users.

Monthly Active Users

25,000

1K500K

Growth

$3,900/mo

$0.16/user

per user

SDKs

Official SDKs for the most popular languages and platforms.

JavaScript / TypeScript

Available

bash

npm install @elodtx/sdk

Python

Available

bash

pip install elodtx

Swift

Coming soon

bash

# Coming soon

Kotlin

Coming soon

bash

# Coming soon