Get up and running with Gero Nexus in just a few minutes. This guide will walk you through creating an account, getting an access token, and making your first request.Documentation Index
Fetch the complete documentation index at: https://nexus.gerowallet.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
Prerequisites
- A Gero Nexus account (free tier available)
- Basic knowledge of HTTP requests
- A tool to make API calls (cURL, Postman, or code)
Step 1: Create Your Account
Sign Up
Visit nexus.gerowallet.io/signup and create your free account.No credit card required for the free tier.
Access Dashboard
Log in to your Gero Nexus Dashboard.
Step 2: Get Your Access Token
Gero Nexus uses JWT (JSON Web Token) authentication. You have two options:- User Login (Web Apps)
- Device Auth (Mobile Apps)
Use your account credentials to get tokens:Response:
Copy your
accessToken - you’ll use it in the Authorization header for all API requests.Step 3: Make Your First Request
Let’s fetch the latest block from the Cardano blockchain.Expected Response
Success! You’ve made your first API call to Gero Nexus.
Step 4: Explore More Endpoints
Now that you’ve made your first call, try these common endpoints:Get Block by Hash
Get Transaction
Get Address Info
Get Latest Epoch
Using the Interactive Playground
Want to test endpoints without writing code? Use our API Playground:- Visit your Dashboard
- Navigate to API Playground
- Select an endpoint from the dropdown
- Enter your access token
- Click “Send Request” to see the response
Best Practices
Secure Your Tokens
Secure Your Tokens
- Never commit tokens to version control
- Use environment variables to store tokens
- Implement token refresh before expiry
- Store refresh tokens securely (Keychain/Keystore for mobile)
Handle Token Expiry
Handle Token Expiry
Access tokens expire after 1 hour. Before expiry, use the refresh token:
Handle Rate Limits
Handle Rate Limits
- Free tier: 10,000 requests/day
- Implement exponential backoff for retries
- Monitor your usage in the dashboard
- Cache responses when possible
Error Handling
Error Handling
Always check response status codes:
200- Success400- Bad request (invalid parameters)401- Unauthorized (invalid/expired token)404- Resource not found429- Rate limit exceeded500- Server error (contact support)
Example: Building a Simple Balance Checker
Here’s a complete example that checks the balance of a Cardano address:Next Steps
Authentication Guide
Learn about JWT tokens and security best practices
API Reference
Explore all available endpoints
Rate Limits
Understand rate limiting and quotas
Error Handling
Learn how to handle API errors gracefully
Need Help?
Join Discord
Chat with our team and community
Contact Support
Email us for assistance
Congratulations! You’re now ready to build with Gero Nexus. Check out the API Reference for a full list of endpoints.