API Overview

Base Configuration

Base URL

All API endpoints are accessed via:

Production: https://api.trpcontinuum.com

Headers

All requests must include:

Content-Type: application/json
x-api-key: YOUR_API_KEY
x-secret-key: YOUR_SECRET_KEY

Response Format

All API responses follow a consistent structure:

Success Response:

{
  "success": true,
  "data": {
    // Response data
  },
  "message": "Optional success message"
}

Error Response:

{
  "success": false,
  "error": "Error description",
  "code": "ERROR_CODE",
  "details": {
    // Additional error context
  }
}

API Categories

1. Authentication 🔐

Manage user accounts, sessions, and API credentials.

Method	Endpoint	Description
POST	/api/auth/register	Create new user account
POST	/api/auth/login	Authenticate user
GET	/api/auth/me	Get current user info
POST	/api/auth/logout	End user session
POST	/api/auth/setup-2fa	Enable two-factor auth
POST	/api/auth/verify-2fa	Verify 2FA code

2. VASP Management 🏢

Register and manage Virtual Asset Service Providers.

Method	Endpoint	Description
GET	/trp/vasps	List all VASPs
GET	/trp/vasps/search	Search VASPs by name
GET	/trp/vasps/{id}	Get specific VASP
GET	/vasps/my-vasp	Get current user's VASP
PUT	/vasps/compliance	Update compliance info

3. Virtual Assets 💰

Access cryptocurrency and token information.

Method	Endpoint	Description
GET	/coins	List all supported coins
GET	/coins/network/{network}	Get coins by network
GET	/coins/network/{network}/search	Search coins on network

4. Networks 🌐

Blockchain network information and configuration.

Method	Endpoint	Description
GET	/chains	List all blockchain networks
GET	/chains/enabled	Get active networks only

5. Travel Address 🔗

Privacy-preserving address management.

Method	Endpoint	Description
POST	/trp/travel-address	Generate new travel address
POST	/trp/validate-travel-address	Validate address format
POST	/trp/decode-travel-address	Decode address information

6. Transaction Management 📋

Core transaction creation and lifecycle.

Method	Endpoint	Description
POST	/trp/transactions	Create new transaction
GET	/trp/transactions	List transactions
GET	/trp/transactions/{id}	Get transaction details
POST	/trp/transactions/{id}/archive	Archive transaction
POST	/trp/transactions/{id}/unarchive	Restore transaction

7. Transaction Processing 🔄

Step-by-step transaction workflow endpoints.

Method	Endpoint	Description
POST	/trp/transactions/{id}/add-beneficiary	Add beneficiary info
POST	/trp/transactions/{id}/kyc-check/approve	Approve KYC
POST	/trp/transactions/{id}/kyc-check/reject	Reject KYC
POST	/trp/transactions/{id}/originator-details	Add originator info
POST	/trp/transactions/{id}/send-to-beneficiary	Send to beneficiary VASP
POST	/trp/transactions/{id}/approve-originator	Approve originator
POST	/trp/transactions/{id}/payment-check/approve	Approve payment
POST	/trp/transactions/{id}/payment-check/reject	Reject payment
POST	/trp/transactions/{id}/tx-hash-submit	Submit blockchain hash

8. Beneficiary Transactions 📨

Manage incoming transactions.

Method	Endpoint	Description
GET	/trp/beneficiary-transactions	List beneficiary transactions
GET	/trp/beneficiary-transactions/{id}	Get specific transaction

9. BitRank Integration 🔍

Wallet risk analysis and verification.

Method	Endpoint	Description
POST	/trp/verify-wallets-bitrank	Verify wallet risk scores
POST	/trp/transactions/{id}/bitrank-verify	Record verification
POST	/trp/transactions/{id}/bitrank-reject	Record rejection

HTTP Status Codes

Code	Description
200	Success
201	Created
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
409	Conflict
429	Too Many Requests
500	Internal Server Error
503	Service Unavailable

Error Codes

Code	Description
AUTH_FAILED	Authentication failed
INVALID_TOKEN	Invalid or expired token
INSUFFICIENT_PERMISSIONS	User lacks required permissions
VALIDATION_ERROR	Request validation failed
RESOURCE_NOT_FOUND	Requested resource doesn't exist
DUPLICATE_RESOURCE	Resource already exists
RATE_LIMIT_EXCEEDED	Too many requests
COMPLIANCE_ERROR	Compliance check failed
BLOCKCHAIN_ERROR	Blockchain operation failed

Pagination

List endpoints support pagination using:

GET /endpoint?limit=20&offset=0

Response includes pagination metadata:

{
  "data": [...],
  "pagination": {
    "total": 100,
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

API Versioning

The API uses URL versioning. Current version: v1

Future versions will be available at:

• /v2/...
• /v3/...

Deprecated endpoints will be supported for 6 months after deprecation notice.