Introduction
What is Obseq?โ
Obseq is a financial infrastructure platform that enables you to:
- Onboard users as individuals or businesses with built-in KYC/KYB verification
- Hold balances in multiple currencies including fiat and crypto assets
- Move money via P2P transfers, fiat deposits/withdrawals, and crypto on/off-ramps
- Manage recipients for recurring transfers
- Receive real-time events via Server-Sent Events (SSE)
Base URLโ
All API requests use the following base URL:
https://api.obseqops.cloud/v1
API Versioningโ
All endpoints are prefixed with /v1. When breaking changes are introduced, a new version prefix will be released and the old version will be deprecated with advance notice.
Request Formatโ
- All request bodies must be
application/json - All responses are
application/json - Timestamps are in ISO 8601 format:
2024-01-15T10:30:00.000Z - Monetary amounts are represented as strings to preserve decimal precision
Response Formatโ
Successful responses return a JSON object with the relevant data fields directly (no wrapper envelope). Errors follow a consistent format:
{
"statusCode": 400,
"message": "Validation failed",
"error": "Bad Request"
}
Rate Limitingโ
Rate limits apply per authenticated party. If you exceed the limit, you will receive a 429 Too Many Requests response. Contact support to request higher limits.
Idempotencyโ
For mutating operations that risk duplication (transfers, withdrawals, account creation), pass an x-idempotency-key header with a unique UUID per request. Replaying the same key within the idempotency window returns the original response without re-executing the operation.
x-idempotency-key: 550e8400-e29b-41d4-a716-446655440000