Registry API Documentation

Access the SolCertUp Registry programmatically to verify project certifications and retrieve detailed information.

Base URL

text

https://api.solcertup.com/v1

Endpoints

Get Project by Address

Retrieve certification details for a specific project

GET /verify/{projectAddress}

bash

curl -X GET https://api.solcertup.com/v1/verify/PLACEHOLDER_PROGRAM_ADDRESS \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:
{
  "status": "certified",
  "tier": "gold",
  "trustScore": 92,
  "projectAddress": "PLACEHOLDER_PROGRAM_ADDRESS",
  "certifiedAt": "2024-06-09T00:00:00Z",
  "expiresAt": "2025-06-09T00:00:00Z",
  "auditors": ["PLACEHOLDER_AUDITOR_ADDRESS"]
}

Search Projects

Search certified projects by name or category

GET /projects/search?query={query}&tier={tier}

bash

curl -X GET "https://api.solcertup.com/v1/projects/search?query=dex&tier=gold" \
  -H "Authorization: Bearer YOUR_API_KEY"

Query Parameters:
- query: Search term (project name or description)
- tier: Filter by tier (bronze, silver, gold, platinum)
- limit: Results per page (default: 20, max: 100)
- offset: Pagination offset (default: 0)

List All Projects

Get a paginated list of all certified projects

GET /projects

bash

curl -X GET "https://api.solcertup.com/v1/projects?limit=50&offset=0" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response:
{
  "total": 150,
  "projects": [
    {
      "id": "project-1",
      "name": "Project Name",
      "address": "PLACEHOLDER_ADDRESS",
      "tier": "gold",
      "trustScore": 92,
      "category": "dex"
    }
  ]
}

Authentication

All API requests require an API key in the Authorization header:

text

Authorization: Bearer YOUR_API_KEY_HERE

Error Handling

json

// Error Response Example
{
  "error": "INVALID_ADDRESS",
  "message": "The provided project address is not valid",
  "statusCode": 400
}

Common Error Codes:
- 400: Bad Request (invalid parameters)
- 401: Unauthorized (missing/invalid API key)
- 404: Not Found (project not found)
- 429: Rate Limited (too many requests)
- 500: Server Error

Rate Limiting

API rate limits are based on your plan:

• Free: 100 requests/hour
• Basic: 1,000 requests/hour
• Pro: 10,000 requests/hour
• Enterprise: Custom limits