Build Something Amazing

    This guide will help you make your first API request in under 5 minutes. You'll learn how to authenticate, fetch data, and start building.

    1

    Create Account

    2

    Get API Key

    3

    First Request

    4

    Explore API

    Step 1: Create Your Account

    First, you'll need an AeThex account to access the developer dashboard.

    1. 1

      Sign up for free

      Visit aethex.dev/login and create your account

    2. 2

      Verify your email

      Check your inbox and click the verification link

    3. 3

      Complete onboarding

      Set up your profile and choose your primary realm

    Free for developers

    All AeThex accounts include free API access with generous rate limits. No credit card required.

    Step 2: Generate Your API Key

    Navigate to the developer dashboard to create your first API key.

    1. 1

      Go to Developer Dashboard

      Visit Dashboard → API Keys

    2. 2

      Create new key

      Click "Create Key" and give it a name (e.g., "Development Key")

    3. 3

      Choose permissions

      Select scopes: read for getting started

    4. 4

      Save your key

      Copy the key immediately - it won't be shown again!

    ⚠️ Keep your API key secret

    Never commit API keys to git or share them publicly. Store them in environment variables or a secure secrets manager.

    Step 3: Make Your First Request

    Let's fetch your user profile to verify everything works.

    Fetch Your Profile

    javascript
    // Replace with your actual API key
    const API_KEY = 'aethex_sk_your_key_here';
     
    async function getMyProfile() {
      const response = await fetch('https://aethex.dev/api/user/profile', {
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        }
      });
     
      if (!response.ok) {
        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
      }
     
      const profile = await response.json();
      
      console.log('Username:', profile.username);
      console.log('Level:', profile.level);
      console.log('Total XP:', profile.total_xp);
      
      return profile;
    }
     
    // Run it
    getMyProfile()
      .then(profile => console.log('Success!', profile))
      .catch(error => console.error('Error:', error));

    🎉 Success!

    If you see your profile data, you're all set! Your API key is working correctly.

    Common Issues

    401 Unauthorized

    Check that your API key is correct and includes the Bearer prefix

    429 Too Many Requests

    You've hit the rate limit. Wait a minute and try again.

    Step 4: Explore the API

    Now that you're authenticated, try out these common operations.

    Get Community Posts

    Fetch the latest posts from the community feed

    javascript
    const posts = await fetch(
      'https://aethex.dev/api/posts?limit=10',
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`
        }
      }
    ).then(r => r.json());
     
    console.log(`Found ${posts.length} posts`);

    Create a Post

    Share content with the community

    javascript
    const post = await fetch(
      'https://aethex.dev/api/posts',
      {
        method: 'POST',
        headers: {
          'Authorization': `Bearer ${API_KEY}`,
          'Content-Type': 'application/json'
        },
        body: JSON.stringify({
          author_id: 'your_user_id',
          title: 'Hello World',
          content: 'My first post via API!',
          is_published: true
        })
      }
    ).then(r => r.json());

    Search Creators

    Find creators by arm or skill

    javascript
    const creators = await fetch(
      'https://aethex.dev/api/creators?arm=labs',
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`
        }
      }
    ).then(r => r.json());
     
    creators.data.forEach(c => {
      console.log(c.username, c.primary_arm);
    });

    Browse Opportunities

    Discover job opportunities on the platform

    javascript
    const jobs = await fetch(
      'https://aethex.dev/api/opportunities?limit=5',
      {
        headers: {
          'Authorization': `Bearer ${API_KEY}`
        }
      }
    ).then(r => r.json());
     
    jobs.data.forEach(job => {
      console.log(job.title, job.job_type);
    });

    Next Steps

    You're ready to build! Here are some resources to help you continue:

    Full API Reference

    Complete documentation of all endpoints, parameters, and responses

    Developer Dashboard

    Manage your API keys, monitor usage, and track analytics

    Join Community

    Get help, share projects, and connect with other developers