Markup Statistics

GETAuth required

Retrieve aggregated markup and trading statistics for your registered applications over a date range.

Endpoint

GET/applications/v1/markup-statistics

Base URL: https://api.derivws.com

Authentication Required

This endpoint requires an OAuth2 Bearer token with the application_read scope and a Deriv-App-ID header.

Query Parameters

Parameter	Type	Required	Description
`date_from`	string (date)	Yes	Interval start date (YYYY-MM-DD), inclusive, UTC. Example: `2026-05-01`
`date_to`	string (date)	Yes	Interval end date (YYYY-MM-DD), inclusive, UTC. Example: `2026-05-06`

Status Codes

200OK - Markup statistics returned successfully

400Bad request - Invalid or missing query parameters

401Unauthorized - Invalid or missing authentication

403Forbidden - Access denied

404Not found - Resource not found

422Unprocessable entity - Validation error

504Gateway timeout - Upstream service timeout

Error Responses

400Bad request

{
  "errors": [
    {
      "status": 400,
      "code": "ValidationError",
      "message": "date_from is required"
    }
  ],
  "meta": {
    "endpoint": "/applications/v1/markup-statistics",
    "method": "GET",
    "timing": 12
  }
}

401Unauthorized

{
  "errors": [
    {
      "status": 401,
      "code": "Unauthorized",
      "message": "Invalid or missing authentication credentials"
    }
  ],
  "meta": {
    "endpoint": "/applications/v1/markup-statistics",
    "method": "GET",
    "timing": 10
  }
}

403Forbidden

{
  "errors": [
    {
      "status": 403,
      "code": "AccessDenied",
      "message": "You do not have permission to access this resource"
    }
  ],
  "meta": {
    "endpoint": "/applications/v1/markup-statistics",
    "method": "GET",
    "timing": 11
  }
}

Account Management Balance

Any other questions? Get in touch