Overview
Endpoints
Learn more about the different endpoints of the Swap API:
GET /rfq/pool - Get information about a blockchain network supported by Clipper.
POST /rfq/quote - Generate potential asset swap quotes. Obtain pricing and essential details for informed decision-making.
POST /rfq/sign - Facilitates blockchain transaction preparation and security by returning the required signature and data. Use it for efficient and secure asset swaps.
Authorization
To prevent abuse of the API, we implement rate limits on requests. If you need to bypass these limits as an aggregator, please contact our support team to get API credentials (username and password) here.
These credentials are used to authorize requests made to the following endpoints: /rfq/pool
, /rfq/quote
and /rfq/sign
Basic Authentication
DEPRECATED: If you are using Basic Authentication, please contact us to receive an API key.
The API uses the Basic authentication method, where you must include the credentials (username:password
) in the headers in Base64
format.
Example:
If your username is "clipper
" and your password is "clipperdocs
", the Base64 encoded string for clipper:clipperdocs
is Y2xpcHBlcjpjbGlwcGVyZG9jcw==
.
Api Key Authentication
The API uses the API KEY authentication method. You have to include the credentials in the header x-api-key
.
Example: If your api key is TzuiYrpRgN2
The API v1 currently supports both API Key and Basic Authentication. However, Basic Authentication will be deprecated in the future. Note: The Pool endpoint currently only supports Basic Authentication. To use API Key authentication, use the Pool V2 endpoint.
Errors
Common Error Codes
400
Bad Request - Invalid data in the request
401
Unauthorized
403
Forbidden Error
500
Internal Server Error
503
External Service Error
Error Format
error_code
and data
are not always present
Examples
If we make a request to quote endpoint and the body does not have the field
chain_id
(required param), the API response will look like similar to this:
If we make a request to quote endpoint and we send an
input_asset_symbol
that clipper does not support, the API response will look like similar to this
If we make a request to quote endpoint and we send invalid credentials
Clipper Error Codes
These codes appear in the field errorCode
422
Invalid input data
409
Quote problems
Last updated
Was this helpful?