What is the Sandbox?
The Sandbox provides mock API endpoints that return deterministic test data. Use these endpoints to develop and test your integration without consuming your API quota or waiting for real blockchain queries.Sandbox vs Production
| Feature | Sandbox | Production |
|---|---|---|
| Data | Mock/deterministic | Real blockchain data |
| Response time | Instant | 1-10 seconds |
| API quota | Not counted | Counted |
| Base URL | Same | Same |
| Endpoint prefix | /api/v2/sandbox/ | /api/v2/ |
Available Sandbox Endpoints
| Endpoint | Description |
|---|---|
GET /api/v2/sandbox/score/{address} | Mock credit score |
GET /api/v2/sandbox/report/{address} | Mock credit report |
Deterministic Responses
Sandbox responses are deterministic based on the address provided:- The same address always returns the same mock data
- Different addresses return different (but consistent) mock scores
- This allows you to test various scenarios reliably
When to Use the Sandbox
Development
Build and test your integration without using real API quota
CI/CD Testing
Run automated tests against consistent mock data
Demo Applications
Build demos without depending on real blockchain data
UI Development
Design and test your UI with various score scenarios
Example Workflow
1
Develop with Sandbox
Use sandbox endpoints while building your integration
2
Test Edge Cases
Test different addresses to see various score ranges
3
Switch to Production
Simply change
/sandbox/ to use production endpointsTest Addresses
Use these addresses to test specific scenarios:| Address | Mock Score | Classification |
|---|---|---|
0x0000000000000000000000000000000000000001 | 850 | Excellent |
0x0000000000000000000000000000000000000002 | 720 | Good |
0x0000000000000000000000000000000000000003 | 550 | Fair |
0x0000000000000000000000000000000000000004 | 400 | Low |