Wagyu API
Base URL: https://api.wagyu.xyz
Services
| Service | Description | Authentication |
|---|---|---|
| Swap API | Cross-chain swaps (XMR ↔ any token) | Public (API key optional) |
| Bridge API | Direct XMR ↔ XMR1 conversion | Public |
Public Rates Feed
- Endpoint:
GET https://api.wagyu.xyz/rates.xml - Format: XML
- Source: Wagyu backend quote simulation (not third-party comparison feeds)
Authentication
Both APIs are public and do not require authentication for basic usage.
API keys are only needed if you want to collect integrator fees on swaps made through your integration.
# Without API key (public)
curl -X POST https://api.wagyu.xyz/v1/quote \
-H "Content-Type: application/json" \
-d '{ ... }'
# With API key (to collect fees)
curl -X POST https://api.wagyu.xyz/v1/quote \
-H "Content-Type: application/json" \
-H "X-API-KEY: wg_your_api_key_here" \
-d '{ ... }'
To obtain an API key for fee collection:
- Visit wagyu.xyz/api
- Connect your wallet
- Create a new API key
- Configure your fee settings
Integrator Fees
When creating an API key, you can configure a fee percentage (0-5%) that will be collected on every swap made with your key.
| Setting | Description |
|---|---|
fee_percent | Your fee as a percentage (0-5%) |
fee_address | EVM address to receive fees |
fee_address_sol | Solana address to receive fees |
fee_address_btc | Bitcoin address to receive fees (optional) |
Fee Collection:
- Fees are automatically deducted from user deposits
- Collected in the deposited token (native or ERC20/SPL)
- Sent directly to your configured address
- Tracked in your dashboard with full analytics
Rate Limits
| Request Type | Limit |
|---|---|
| Order creation | 5/min |
| Quotes | 60/min |
| All other endpoints | 50/min |
Higher limits available on request.
Error Handling
All errors return a JSON object:
{
"error": "Description of the error"
}
| Code | Description |
|---|---|
| 400 | Invalid request parameters |
| 401 | Missing or invalid API key |
| 404 | Order not found |
| 429 | Rate limit exceeded |
| 500 | Internal server error |
Minimums
| Route | Minimum |
|---|---|
| EVM → Any | $20 |
| Solana → Any | $20 |
| Bitcoin → Any | $40 |
| XMR → Any | $25 |
| Any → XMR | $25 |