List Modules

Retrieve a list of HDP modules with optional filtering by marketplace or creator

List Modules

Retrieves a list of HDP modules. Can be filtered to show only marketplace-published modules or modules by a specific creator. This endpoint does not require authentication.

Endpoint

GET /modules

Query Parameters

Parameter	Type	Required	Description
marketplace	boolean	No	If true, returns only modules published on the marketplace
creator_user	string	No	Filter modules by creator user identifier

Example Requests

List all modules

curl -X GET https://staging.hdp.api.herodotus.cloud/modules \
  -H "Content-Type: application/json"

List only marketplace modules

curl -X GET "https://staging.hdp.api.herodotus.cloud/modules?marketplace=true" \
  -H "Content-Type: application/json"

List modules by creator

curl -X GET "https://staging.hdp.api.herodotus.cloud/modules?creator_user=[e-mail]" \
  -H "Content-Type: application/json"

Response

Success Response (200 OK)

{
  "modules": [
    {
      "id": "01JPJ03YJT1A93D6NF56G4GVEQ",
      "latestModuleVersionProgramHash": "0x34a16478e83f69c4f0bcdb7549d32f92c9b7776bb3f71da06de334f1871eba0",
      "compilerVersion": "2.7.0",
      "name": "my_module",
      "description": "My awesome HDP module",
      "usageCount": 42,
      "tags": ["example", "tutorial"],
      "downloadsCount": 100,
      "usersCount": 25,
      "isVerified": false,
      "publishedOnMarketplace": true,
      "creatorUser": "[e-mail]",
      "license": "MIT",
      "abi": {
        "type": "interface",
        "items": []
      },
      "sourceCode": {
        "src/lib.cairo": "fn main() {}"
      },
      "scarbToml": "[package]\nname = \"my_module\"\n...",
      "createdAt": "2024-03-17T10:24:00Z",
      "updatedAt": "2024-03-17T10:25:00Z"
    }
  ]
}

Response Fields

Field	Type	Description
modules	array	Array of module objects

Each module object has the same structure as described in the Get Module endpoint.

Notes

• No authentication is required for this endpoint
• If marketplace=true is specified, only published modules are returned
• If creator_user is specified, only modules created by that user are returned
• If neither parameter is specified, all modules are returned
• The response includes full module details including source code and ABI