DumpLock API v1

Read-only public API

The DumpLock API exposes lock status and health data for integration with explorers, dashboards, and third-party tools. All endpoints are read-only and require no authentication.

Base URL: https://api.dumplock.io

GET /v1/status

Returns lock status for a single token by mint address.

Parameters

Name	Type	Required	Description
mint	string	Yes	Solana token mint address

Example request

GET https://api.dumplock.io/v1/status?mint=So11111111111111111111111111111111111111112

Example response (LOCKED)

{
  "mint": "So11111111111111111111111111111111111111112",
  "status": "LOCKED",
  "lockedPercentage": 95,
  "unlockedPercentage": 5,
  "unlocksAt": "2025-02-07T14:00:00Z",
  "unlocksIn": "2h 15m"
}

Example response (UNLOCKED)

{
  "mint": "So11111111111111111111111111111111111111112",
  "status": "UNLOCKED",
  "lockedPercentage": 0,
  "unlockedPercentage": 100
}

GET /v1/locks

Returns a list of tokens with active or recent lock data.

Example response

{
  "locks": [
    {
      "mint": "So11111111111111111111111111111111111111112",
      "status": "LOCKED",
      "lockedPercentage": 95,
      "unlocksAt": "2025-02-07T14:00:00Z"
    }
  ]
}

GET /v1/health

Service health check. Returns HTTP 200 when the API is operational.

GET https://api.dumplock.io/v1/health

Caching and rate limits

Status and lock data may be cached for a short period. Clients should not assume real-time consistency. Rate limits may apply; use reasonable request intervals and cache responses when appropriate.

This documentation is for informational purposes only. The API is provided as-is. DumpLock does not guarantee availability, accuracy, or fitness for any particular use.