List Master Trades

GET/master-trades

Caller

This endpoint is available to any authenticated Open API key.

Summary

Master trades are Requidex's shared, canonical trade taxonomy for workers. Unlike company trades, which represent roles configured within an individual company, master trades give the same worker trade a consistent identity across companies and agencies.

Use this endpoint to discover the valid master trade IDs before creating or updating a worker. Pass the returned id values in the worker request's trades array. The response intentionally includes only each trade's ID and name.

Query Parameters

Name	Type	Required	Description
query	string	No	Case-insensitive name search
page	integer	No	Page number (default 1)
limit	integer	No	Records per page (default 50, max 200)
sortBy	enum(name)	No	Sort field
sortOrder	enum(asc, desc)	No	Sort direction
fields	string	No	Comma-separated response fields or nested dot paths

Request Example

cURL

curl -X GET 'https://api.requidex.com/api/open/v1/master-trades?limit=200' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Accept: application/json'

JavaScript

const response = await fetch("https://api.requidex.com/api/open/v1/master-trades?limit=200", {
  method: "GET",
  headers: {
    Authorization: "Bearer <API_KEY>",
    Accept: "application/json",
  },
});

const json = await response.json();

Python

import requests

response = requests.get(
    'https://api.requidex.com/api/open/v1/master-trades',
    params={'limit': 200},
    headers={
        'Authorization': 'Bearer <API_KEY>',
        'Accept': 'application/json',
    },
    timeout=30,
)

print(response.json())

Go

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.requidex.com/api/open/v1/master-trades?limit=200", nil)
  req.Header.Set("Authorization", "Bearer <API_KEY>")
  req.Header.Set("Accept", "application/json")

  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := io.ReadAll(res.Body)
  fmt.Println(string(body))
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
data	array[object]	Master trades for the requested page. Show child attributes id string - Master trade ID used in worker requests name string - Canonical master trade name
meta	object	Pagination metadata. Show child attributes page integer - Current page number limit integer - Maximum records returned per page total integer - Total matching records

Response Example (200)

{
  "success": true,
  "data": [
    {
      "id": "67bc36db80a1616ec3f47102",
      "name": "Electrical & Power"
    }
  ],
  "meta": { "page": 1, "limit": 200, "total": 1 }
}