File: B7-FXTransOptions.Rd

package info (click to toggle)
foptions 200.10058-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 956 kB
  • ctags: 157
  • sloc: fortran: 1,992; sh: 28; makefile: 12
file content (238 lines) | stat: -rw-r--r-- 7,482 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
\name{FXTransOptions}

\alias{FXTransOptions}

\alias{FEInDomesticFXOption}
\alias{QuantoOption}
\alias{EquityLinkedFXOption}
\alias{TakeoverFXOption}


\title{Valuation of Currency Translated Options}


\description{
  
    This is a collection of functions to valuate currency 
    translated options. Currency translated options are 
    options on foreign assets where the payoff is exchanged 
    into domestic currency at expiration. For example, a US 
    investor is interested in buying an option that is linked 
    to the Nikkei index that is priced in yen. There are 
    two types or risks, changing prices and exchange rates, 
    to consider when valuing currency-translated options.
    \cr
    
    The functions are:

    \tabular{ll}{
	\code{FEInDomesticFXOption} \tab Foreign Exchange In Domestic Currency Option, \cr
	\code{QuantoOption} \tab Quanto Option, \cr
	\code{EquityLinkedFXOption} \tab Equity Linked FX Option, \cr
	\code{TakeoverFXOption} \tab Takeover FX Option. }
    
}


\usage{
FEInDomesticFXOption(TypeFlag, S, E, X, Time, r, q, 
    sigmaS, sigmaE, rho)
QuantoOption(TypeFlag, S, Ep, X, Time, r, rf, q, sigmaS, 
    sigmaE, rho) 
EquityLinkedFXOption(TypeFlag, E, S, X, Time, r, rf, q, 
    sigmaS, sigmaE,rho)
TakeoverFXOption(V, B, E, X, Time, r, rf, sigmaV, sigmaE, rho)
}


\arguments{

    \item{B}{
        [TakeoverFX*] - \cr
        the value of the foreign firm in the foreign currency at 
        the option expiration, a numeric value.
        }
    \item{E}{
        [FEInDomesticFX*] - \cr
        the spot exchange rate specified in units of the domestic
        currency per unit of the foreign currency, a numeric value.\cr
        [TakeoverFX*] - \cr
        the currency price quoted in units of the domestic currency
        per unit of the foreign currency.
        }
    \item{Ep}{
        [Quanto*] - \cr
        the predetermined exchange rate specified in units of domestic
        currency per unit of foreign currency.
        }
    \item{q}{
        [FEInDomesticFX*][EquityLinkedFX*] - \cr
        the instantaneous proportional dividend payout rate of the 
        underlying asset, a numerical value.
        }   
    \item{r}{
        [FEInDomesticFX*][TakeoverFX*] - \cr
        the domestic interest rate, a numeric value. E.g. 0.25 means 
        25\% p.a.
        }
    \item{rf}{
        [TakeoverFX*] - \cr
        the foreign interest rate, a numeric value.
        }
    \item{rho}{
        [TakeoverFX*] - \cr
        the correlation between annualized volatility of the currency price 
        quoted in units of the domestic currency per unit of the foreign 
        currency and the annualized volatility of the value of the foreign 
        firm, a numeric value.
        }   
    \item{S}{
        [FEInDomesticFX*][EquityLinkedFX*] - \cr
        the underlying asset price in foreign currency, a numeric 
        value.
        }
    \item{sigmaE}{
        [TakeoverFX*] - \cr
        the annualized volatility of the currency price quoted in 
        units of the domestic currency per unit of the foreign currency,
        a numeric value; e.g. 0.3 means 30\% volatility pa.
        }   
    \item{sigmaS}{
        [Quanto*] - \cr
        the annualized volatility of the underlying asset,
        a numeric value; e.g. 0.3 means 30\% volatility pa.
        }
    \item{sigmaV}{
        [TakeoverFX*] - \cr
        the annualized volatility of the value of the foreign firm, 
        a numeric value; e.g. 0.3 means 30\% volatility pa.
        }   
    \item{Time}{
        the time to maturity, a numeric value.
        }
    \item{TypeFlag}{
        a character string either "c" for a call option or a "p" 
        for a put option.
        }
    \item{V}{
        [TakeoverFX*] - \cr
        the value of the foreign firm in the foreign currency, a 
        numeric value.
        }
    \item{X}{
        [FEInDomesticFX*] - \cr
        the strike (delivery) price in domestic currency, a numeric 
        value. \cr
        [TakeoverFX*] - \cr
        the strike price quoted in units of the domestic currency
        per unit of the foreign currency.
        }

}


\value{

    The option price, a numeric value.

}


\details{

    \bold{Equity Linked Foreign Exchange Options:}
    \cr\cr
    An equity-linked foreign-exchange option is an option on the foreign 
    exchange rate and is linked to the forward price of a stock or equity 
    index. This option can be priced analytically using a model introduced 
    by Reiner (1992).
    \cr
    
  
    \bold{Quanto Options:}
    \cr\cr
    A fixed exchange-rate foreign-equity option (Quanto) is denominated in 
    another currency than that of the underlying equity exposure. The face 
    value of the currency protection expands or contracts to cover changes 
    in the foreign currency value of the underlying asset. Quanto options 
    can be priced analytically using a model published by Dravid, Richardson, 
    and Sun (1993).
    \cr
    
    
    \bold{Foreign Equity Options:}
    \cr\cr
    A foreign equity option is an option on a foreign asset where the strike 
    price is specified in either domestic or foreign currency and the payoff 
    at expiration is valued in domestic currency. Foreign equity options 
    can be priced analytically using a model introduced by Reiner (1992).
    \cr
    
  
    \bold{Takeover Foreign Exchange Options:}
    \cr\cr
    A takeover foreign exchange call option gives the buyer the right purchase 
    a specified number of units of foreign currency at a strike price if the 
    corporate takeover is successful. This option can be priced analytically 
    using a model introduced by Schnabel and Wei (1994).
    \cr
    [Haug's Book, Chapter 2.13.4]

}


\note{

    The functions implement the algorithms to valuate plain vanilla 
    options as described in Chapter 1 of Haug's Book (1997).
    
}


\examples{
## Examples from Chapter 2.13 in E.G. Haug's Option Guide (1997)

## Foreign Equity Options Struck in Domestic Currency [2.13.1]:
   xmpOptions("\nStart: FE in Domestic Currency Option > ")
   FEInDomesticFXOption(TypeFlag = "c", S = 100, E = 1.5, 
     X = 160, Time = 0.5, r = 0.08, q = 0.05, sigmaS = 0.20, 
     sigmaE = 0.12, rho = 0.45)

## Fixed Exchange-Rate Foreign-Equity Option [2.13.2]: 
   xmpOptions("\nNext: Quanto Option > ")
   QuantoOption(TypeFlag = "c", S = 100, Ep = 1.5, X = 105, 
     Time = 0.5, r = 0.08, rf = 0.05, q = 0.04, sigmaS= 0.2, 
     sigmaE = 0.10, rho = 0.30) 

## Equity Linked Foreign Exchange Option [2.13.3]:
   xmpOptions("\nNext: Equity Linked FX Option > ")
   EquityLinkedFXOption(TypeFlag = "p", E = 1.5, S = 100, 
     X = 1.52, Time = 0.25, r = 0.08, rf = 0.05, q = 0.04, 
     sigmaS = 0.20, sigmaE = 0.12, rho = -0.40)

## Takeover Foreign-Exchange Option [2.13.4]:
   xmpOptions("\nNext: Takeover FX Option > ")
   TakeoverFXOption(V = 100, B = 100, E = 1.5, X = 1.55, Time = 1, 
     r = 0.08, rf = 0.06, sigmaV = 0.20, sigmaE = 0.25, rho = 0.1)

}


\references{

Haug E.G. (1997); 
    \emph{The Complete Guide to Option Pricing Formulas}, 
    Chapter 2.13, McGraw-Hill, New York.
    
}


\author{

    Diethelm Wuertz for this R-Port.
    
}


\keyword{math}