FAQs
Frequently asked questions about Router OGA.
Getting Started
What is Router OGA?
Router Open Graph Architecture (OGA) is a non-custodial, chain-agnostic programmable execution graph that provides cross-chain token swaps and bridge operations through the Xplore REST API.
How do I get started?
- Read the Introduction to understand Router OGA
- Explore the API Reference for endpoint documentation
- Try the Swap/Bridge Widget for quick integration
- For production use, contact the Router team to obtain an API key
API Usage
How do I authenticate API requests?
Include your API key in the request header:
X-API-Key: your-api-key-here
Note: API keys are optional during development and testing. For production, contact the Router team.
What are the rate limits?
| Tier | Requests per Minute | Requests per Hour |
|---|---|---|
| Free | 60 | 1,000 |
| Standard | 300 | 10,000 |
| Enterprise | Custom | Custom |
What is the API base URL?
Production: https://xplore.api.v2.routerprotocol.com
You can also access the interactive Swagger UI at https://xplore.api.v2.routerprotocol.com/swagger-ui/ for testing endpoints.
Which chains are supported?
Router OGA supports multiple chains including Ethereum, Polygon, Arbitrum, Base, Optimism, BSC, Solana, and more. Use the /v1/chains endpoint to get the complete list with full metadata.
How do I handle errors?
All API errors follow a consistent format. See the Error Codes documentation for details.
Widget Integration
How do I integrate the Swap/Bridge Widget?
See Swap/Bridge Widget (iframe) for the iframe embed, or Swap/Bridge Widget (npm) for the React package.
Technical
How do I format token amounts?
Amounts must be represented as strings with full precision (including decimals):
// 1 token with 18 decimals
"1000000000000000000"
// 1.5 USDC with 6 decimals
"1500000"
Use the contract amount format, not human-readable amounts.
How do I track transaction status?
Use the /v1/status endpoint with the transaction hash. See the Transaction Status documentation for details.
Support
Where can I get help?
- Check the documentation for detailed guides
- Visit our GitHub for examples
- Report issues through GitHub Issues
Can I contribute to the documentation?
Yes! Contributions are welcome. See our GitHub repository.