API Reference Overview
Complete reference for all Bridge API endpoints across products and services.
Base URLs
The Bridge platform exposes APIs through a unified gateway:
- Production:
https://api.gateway.service.d.bridgeintelligence.ltd - Sandbox:
https://sandbox.gateway.service.d.bridgeintelligence.ltd
Individual services are also accessible directly:
| Service | Base URL |
|---------|----------|
| Oracle | https://api.oracle.service.d.bridgeintelligence.ltd |
| Custody | https://api.custody.service.d.bridgeintelligence.ltd |
| Identity | https://api.id.service.d.bridgeintelligence.ltd |
| Orchestra | https://api.orchestra.service.d.bridgeintelligence.ltd |
| Ledger | https://api.ledger.service.d.bridgeintelligence.ltd |
| Market Data | https://api.marketdata.service.d.bridgeintelligence.ltd |
| Portfolio | https://api.portfolio.service.d.bridgeintelligence.ltd |
| Execution | https://api.execution.service.d.bridgeintelligence.ltd |
API Versioning
All APIs are versioned via URL path. The current version is v1:
https://api.gateway.service.d.bridgeintelligence.ltd/api/v1/...
Request Format
All requests should:
- Use HTTPS
- Include
Content-Type: application/jsonfor POST/PUT requests - Include authentication headers (
X-API-KeyorAuthorization: Bearer <token>)
Response Format
All responses are JSON with consistent structure:
{
"data": { ... },
"meta": {
"requestId": "req_abc123",
"timestamp": "2026-04-10T12:00:00Z"
}
}
Error Responses
Errors follow a consistent format:
{
"error": {
"code": "INVALID_REQUEST",
"message": "The request body is invalid",
"details": [
{ "field": "amount", "issue": "must be positive" }
]
},
"meta": {
"requestId": "req_abc123"
}
}
Common Status Codes
| Code | Meaning | |------|---------| | 200 | Success | | 201 | Created | | 400 | Invalid request | | 401 | Unauthorized — check your API key | | 403 | Forbidden — insufficient permissions | | 404 | Resource not found | | 429 | Rate limit exceeded | | 500 | Internal server error |
Rate Limits
Rate limits depend on your subscription tier:
| Tier | Limit | |------|-------| | Explorer | 10 req/min | | Starter | 30 req/min | | Growth | 60 req/min | | Enterprise | 300+ req/min |
Rate limit headers are returned with every response:
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1712750400
Pagination
List endpoints support cursor-based pagination:
GET /api/v1/wallets?limit=20&cursor=eyJpZCI6IjEyMyJ9
Response includes pagination metadata:
{
"data": [ ... ],
"meta": {
"hasMore": true,
"nextCursor": "eyJpZCI6IjE0MyJ9"
}
}