M2M Revaluation Rate

Retrieve Mark-to-Market (M2M) revaluation rates for institutional accounting.

GET/3.0/forex/m2m

Description

This endpoint provides daily Mark-to-Market (M2M) revaluation rates as published by the State Bank of Pakistan (SBP). These rates are essential for institutional investors and financial institutions for portfolio revaluation, financial reporting, and compliance purposes.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
from	string (date)	No	Start date for range (YYYY-MM-DD)	2025-02-01
to	string (date)	No	End date for range (YYYY-MM-DD)	2025-02-06
date	string (date)	No	Single date to fetch rates for	2025-02-06
currency	string	No	Filter by specific currency code (ISO 4217)	USD

Note: Either provide a single date parameter OR both from and to parameters. Do not mix them.

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
        "date": "2025-12-24",
        "currency": "USD",
        "period": "ready",
        "rate": 280.2018
    },
    {
        "date": "2025-12-24",
        "currency": "EUR",
        "period": "ready",
        "rate": 330.3439
    }
  ]
}

Response Fields

Field	Type	Description
date	string	Date of the M2M rate (YYYY-MM-DD)
currency	string	Quoted currency ISO code
period	string	Effective date of the M2M rate i.e. ready
rate	number	Mark-to-Market rate published by SBP (PKR per unit)

Error Responses

For detailed Common Error responses, see the Error Handling.

Examples

Get Latest M2M Rates

curl -X GET "https://api.capitalstake.com/3.0/forex/m2m" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Portfolio Revaluation: Revalue foreign currency holdings at official SBP rates
• Financial Reporting: Compliance with accounting standards using official revaluation rates
• Risk Management: Calculate forex exposure using standardized rates
• Corporate Treasury: Track portfolio value changes using official benchmarks
• Regulatory Compliance: Meet SBP guidelines for foreign asset valuation