Something.cool
  • Getting started
    • Why Something.cool?
    • 1st stage - Bonding curve
    • 2nd stage - CoolDEX trading
  • Zero-fee coins
    • What is Zero-fee coin?
    • How to launch Zero-fee coin
  • Community coins
    • What is Community coin?
    • Community contribution / How it works?
      • Holders
      • Liquidity providers
      • Burning
    • How to launch Сommunity coin
  • Features
    • Coin Explore
      • New Pairs
      • Coin Vision
    • Spaces
    • Rewards
  • Community
    • Referral program
    • X
    • Media kit
  • Developer Resources
  • Platform Architecture
    • Technical Introduction
    • Overview
    • Components
  • SC Bonding Curve
    • Overview
    • Functions
      • Create Token
      • Buy Token
      • Sell Token
      • Migrate
      • Admin Set Properties
    • Price Calculation
    • Fees
  • CoolDEX
    • Overview
    • Functions
      • Initialize Pool
      • Swap Base In
      • Swap Base Out
      • Deposit
      • Withdraw
      • Withdraw PnL
    • Price Calculation
    • Fees
  • Token Types
    • Token Types
  • Migration Process
    • Migration Process
  • Rewards Claiming
    • Overview
    • Authentication
    • Endpoints
    • Errors
    • Example
  • Reference
    • SC Bonding Curve IDL
    • CoolDEX IDL
    • Log Structure
    • DEVNET EXAMPLES
  • INTERNAL API
    • Overview
    • Register
  • Example: Registering a User via Internal API (JavaScript)
Powered by GitBook
On this page
  • Overview
  • API Basics
  • API Versioning
  • API Authorization
  • Requesting an API key
  • Rate Limits
  • Error Response Format
  • Error Response
  1. INTERNAL API

Overview

Overview

This Internal API allows partner services to register their users directly into our platform. Each request must include a valid API key and is strictly authenticated. Users registered via this API are automatically linked as referrals to the API key owner. This integration is ideal for platforms that want to onboard users seamlessly while tracking referrals.

API Basics

  • Base URL: Coming Soon

API Versioning

Current API version is: v1

API Authorization

All requests to our Internal API must include a valid API key in the request headers.

x-api-key: your-api-key-here

Quick Test: Check API Version

Request:

GET /v1/internal
Host: BASE_URL
x-api-key: your-api-key-here

Example with curl:

curl -X GET https://BASE_URL/v1/internal \
  -H "x-api-key: your-api-key-here"
  

Response:

{
  "version": "v1"
}

Requesting an API key

If you want to integrate with our platform and need an API key, please reach out to us directly:

📩 Contact: TBA

Our team will review your request and provide you with an API key if the integration is approved.

Rate Limits

To ensure fair usage of the API, rate limits are enforced:

  • 100 requests per 15-minute window per IP address

  • Exceeding this limit will result in HTTP 429 (Too Many Requests) responses

Error Response Format

All API error responses follow a consistent format:

Error Response

{
  "message": "ERROR_MESSAGE",
  "error": "ERROR_REASON",
  "statusCode": "ERROR_CODE"
}
PreviousDEVNET EXAMPLESNextRegister

Last updated 2 months ago