Partner API Reference

Authorization: Bearer ucpk_<your_key_here>

GET https://ucrypto.ai/api/partner/rate

// 200 OK
{
  "sdPerUcrypto": 1250.00,
  "circulatingSupply": 1200,
  "totalFloat": 100000,
  "floatRemaining": 98800,
  "supplyPct": 1.20,
  "earlyAdopterActive": true,
  "scarcityFactor": 1.006,
  "timestamp": "2026-09-20T21:00:00.000Z"
}

POST https://ucrypto.ai/api/partner/user/lookup

// Request
{ "email": "[email protected]" }

// 200 OK
{ "userId": "abc123-...", "name": "Jane Smith", "ucryptoBalance": 0.05, "spaceDollarsBalance": 1500 }

// 404
{ "error": "User not found" }

POST https://ucrypto.ai/api/partner/sd-deposit

// Request
{ "userId": "abc123-...", "amount": 500, "sourcePlatform": "intellislots", "externalRef": "event-789" }

// 200 OK
{ "ok": true, "credited": 500, "newSpaceDollarsBalance": 2000 }

POST https://ucrypto.ai/api/partner/convert

// Request
{ "userId": "abc123-...", "spaceDollarsAmount": 1000, "sourcePlatform": "intellislots" }

// 200 OK
{ "ok": true, "ucryptoReceived": 0.8, "rateApplied": 1250.00, "newUcryptoBalance": 0.85, "newSpaceDollarsBalance": 1000, "transactionId": 42, "earlyAdopterBonus": true }

// 400
{ "error": "Insufficient Space Dollars balance", "balance": 500, "required": 1000 }

// JavaScript / Node.js — full integration flow
const BASE = 'https://ucrypto.ai/api/partner';
const headers = { 'Authorization': 'Bearer ucpk_your_key', 'Content-Type': 'application/json' };

const { sdPerUcrypto } = await fetch(`${BASE}/rate`, { headers }).then(r => r.json());
const { userId } = await fetch(`${BASE}/user/lookup`, {
  method: 'POST', headers, body: JSON.stringify({ email: '[email protected]' })
}).then(r => r.json());
await fetch(`${BASE}/sd-deposit`, {
  method: 'POST', headers, body: JSON.stringify({ userId, amount: 500, sourcePlatform: 'my-platform' })
});
const result = await fetch(`${BASE}/convert`, {
  method: 'POST', headers, body: JSON.stringify({ userId, spaceDollarsAmount: 500, sourcePlatform: 'my-platform' })
}).then(r => r.json());
console.log('UCrypto received:', result.ucryptoReceived);

# Python 3 — full integration flow
import requests
BASE = 'https://ucrypto.ai/api/partner'
H = { 'Authorization': 'Bearer ucpk_your_key', 'Content-Type': 'application/json' }

rate   = requests.get(f'{BASE}/rate', headers=H).json()
user   = requests.post(f'{BASE}/user/lookup', headers=H, json={'email': '[email protected]'}).json()
uid    = user['userId']
requests.post(f'{BASE}/sd-deposit', headers=H, json={'userId': uid, 'amount': 500, 'sourcePlatform': 'my-platform'})
result = requests.post(f'{BASE}/convert', headers=H, json={'userId': uid, 'spaceDollarsAmount': 500, 'sourcePlatform': 'my-platform'}).json()
print('UCrypto received:', result['ucryptoReceived'])

<?php
$base = 'https://ucrypto.ai/api/partner';
$h = ['Authorization: Bearer ucpk_your_key', 'Content-Type: application/json'];
function uc($m, $u, $h, $b = null) {
    $c = curl_init($u);
    curl_setopt_array($c, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $h]);
    if ($m === 'POST') { curl_setopt($c, CURLOPT_POST, true); curl_setopt($c, CURLOPT_POSTFIELDS, json_encode($b)); }
    $r = curl_exec($c); curl_close($c); return json_decode($r, true);
}
$user = uc('POST', "$base/user/lookup", $h, ['email' => '[email protected]']);
$uid  = $user['userId'];
uc('POST', "$base/sd-deposit", $h, ['userId' => $uid, 'amount' => 500, 'sourcePlatform' => 'my-platform']);
$r = uc('POST', "$base/convert", $h, ['userId' => $uid, 'spaceDollarsAmount' => 500, 'sourcePlatform' => 'my-platform']);
echo 'UCrypto received: ' . $r['ucryptoReceived'];