Explore OneLiquidity's API endpoints, request and response formats, and authentication requirements for building reliable financial integrations.
Use this page to set up a new OneLiquidity V1 integration and find the endpoint group for your workflow. Start in sandbox, complete account verification and authentication, then test the product flow you plan to launch.
API Base URLs
All API requests should be made to the base URL for the environment you are integrating with.
| Environment | Base URL |
|---|---|
| Sandbox | https://sandbox-api.oneliquidity.technology |
| Production | https://api.oneliquidity.technology |
Endpoint pages append service and version paths to the base URL, such as /auth/v1/..., /integrator/v1/..., or /fcat/v1/....
Recommended setup order
- Register a new integrator account, or skip this step if your account already exists.
- Complete verification using the link sent to the account email address.
- Request an authentication token.
- Send the issued token in the
Authorizationheader. - Make your first authenticated request with Get integrator profile.
- Configure your webhook URL if your workflow uses asynchronous updates.
- Test one product workflow in sandbox, such as a bank transfer, wallet deposit, or quote.
Authenticate your requests
Most OneLiquidity endpoints require a Bearer token in the Authorization header. Include Content-Type when sending a JSON request body:
Authorization: Bearer <token>
Content-Type: application/jsonUse credentials and tokens from the same environment as the base URL. Keep tokens server-side and do not expose them in browsers, mobile apps, public repositories, or client logs.
Build by workflow
| If you want to... | Start with... |
|---|---|
| Register an account, manage profile settings, configure webhooks, or view ledgers | General Endpoints |
| Generate and manage API access tokens | Authentication |
| Send or receive fiat payments | Fiat, Collections & Transfers |
| Create wallets, track deposits, or request withdrawals | Crypto Wallets for Businesses |
| Request and execute quotes | Trading |
| Create market, sweep, or limit orders | LP Merchants |
Before moving to production
- Test the complete workflow with sandbox credentials.
- Switch to the production base URL and use production credentials and tokens.
- Confirm that your production webhook is reachable if the workflow uses asynchronous updates.
- Validate required fields, amounts, currencies, IDs, and timestamps against the endpoint schema.
- Handle the documented error responses before enabling the workflow for customers.