Alkanes REST Endpoints

Query alkane tokens, contracts, and holdings.

get-alkanes

List all alkanes with pagination.

Endpoint: POST /get-alkanes

Parameters:

• limit (number, optional) - Maximum results (default: 50)
• offset (number, optional) - Pagination offset (default: 0)

get-alkane-details

Get detailed information about a specific alkane.

Endpoint: POST /get-alkane-details

Parameters:

• alkaneId (object) - The alkane ID with block and tx fields

global-alkanes-search

Search for alkanes and pools by name or symbol.

Endpoint: POST /global-alkanes-search

Parameters:

• query (string) - Search query

JavaScript Example

class AlkanesClient {
  constructor(apiKey, network = 'mainnet') {
    this.baseUrl = `https://${network}.subfrost.io/v4/api`;
    this.apiKey = apiKey;
  }

  async post(endpoint, body = {}) {
    const response = await fetch(`${this.baseUrl}${endpoint}`, {
      method: 'POST',
      headers: { 
        'Content-Type': 'application/json',
        'x-subfrost-api-key': this.apiKey
      },
      body: JSON.stringify(body)
    });
    const data = await response.json();
    if (data.statusCode !== 200) throw new Error(data.error);
    return data.data;
  }

  async getAllAlkanes(limit = 50, offset = 0) {
    return this.post('/get-alkanes', { limit, offset });
  }

  async getAlkaneDetails(block, tx) {
    return this.post('/get-alkane-details', { 
      alkaneId: { block: String(block), tx: String(tx) }
    });
  }

  async searchAlkanes(query) {
    return this.post('/global-alkanes-search', { query });
  }
}

// Usage
const client = new AlkanesClient('your-api-key');

const alkanes = await client.getAllAlkanes(10, 0);
console.log('Alkanes:', alkanes);

const details = await client.getAlkaneDetails(4, 65522);
console.log('Details:', details);