API Reference
SDK Documentation
Documentation for the FundLoop SDK
Last updated September 20, 2026
The FundLoop SDK provides an easy-to-use interface for integrating your project with the FundLoop API. It includes client libraries in multiple languages to simplify tasks like user syncing, revenue reporting, and validation checks.
Available SDKs
FundLoop provides official SDKs in:
- **TypeScript / Node.js**
- **Python** *(in beta)*
- More language support coming soon
Each SDK is versioned and available on GitHub and major package managers (e.g., npm, PyPI).
Installation
TypeScript / Node.js
```bash
npm install @fundloop/sdk
````
Python (Beta)
```bash
pip install fundloop-sdk
```
Basic Usage
Initialization
```ts
import { FundLoopClient } from '@fundloop/sdk'
const client = new FundLoopClient({
apiKey: process.env.FUNDLOOP_API_KEY
})
```
Submit Users
```ts
await client.submitUsers([
{ id: 'user-abc123', score: 1, comment: 'Top contributor' },
{ id: 'user-xyz456', score: 0.3 }
])
```
Report Revenue
```ts
await client.reportContribution({
month: '2025-07',
revenue_usd: 18000,
contribution_usd: 180
})
```
Check Validation
```ts
const validation = await client.getValidation('user-abc123')
console.log(validation.tier, validation.valid)
```
Error Handling
All methods return Promise objects and throw exceptions for:
* Invalid input formats
* Missing credentials
* API errors or rate limits
You can use try/catch or client.onError() hooks to handle failures gracefully.
Best Practices
* Use environment variables to manage your API key
* Schedule monthly syncs using cron or task queues
* Cache validation responses to reduce API calls
* Combine SDK calls with your internal user tracking systems
Resources
* [GitHub Repository](https://github.com/fundloop/sdk)
* [API Reference](/docs/api-reference)
* [Project Onboarding Guide](/docs/project-onboarding)
Support
Need help? Join our developer Discord channel or email us at dev@fundloop.org.
```