阿格斯提供以下CSV格式的订阅用户文档文件:
- latestCodes.csv :所有阿格斯将发布或已发布商品的列表,附带发布频率、时间信息、度量单位等属性。代码为基本评估描述符,不包含所评估商品的数据点类型或评估时间等信息。
- latestModules.csv :包含描述内容、短名称和位置信息的阿格斯所发布模块的列表。
- latestPricetype.csv :阐述所发布数值类型的描述符列表,例如高、低、平均值等,也被称为PriceType或PT。
- latestTimestamp.csv :阿格斯发布评估的时间段列表。也被称为TimeStamp或TS。
- latestQuotes.csv:Code-TS-PT-CFWD列表(CFWD=连续远期—下文将做阐述)组合,阿格斯用它们开始和结束的日期以及其他参数来进行过评估。该组合和日期相结合就代表一个独有的数据点键。
- latestModuleDetails.csv:以Code-TS-PT-CFWD组合形式描述每个模块的内容(注意:一个模块内可包含按每天和每周、每周和每月等频率发布的数据,所以并不是每个csv文档都只在到期时才包含所有评估内容)。
- latestCategory.csv:映射到特定分类的所有代码列表,以树状结构显示。
- latestDoc.csv:以上所有文档的组合列表,为解码格式。
- latestUnits.csv:度量单位和货币列表
- latestRVP_Code_reference.csv :本文件特定于“阿格斯美国产品报告”汽油,显示价格序列和RVP序列间的映射。
latestDoc.csv文件包含文件夹详细信息和能在FTP站点找到的文件名。举例来说,您可以在名为"DAMCOAL”的文件夹(参见C列)和名称内含"dcm”的文件(参见D列和下文概述的命名约定)里找到API 2煤炭指数(参见下文第2行)。所有一同发布的相关数据都包含在单一文件内。
latestDoc.csv文件也显示每段数据的发布频率(参见V列)。
latestModules.csv文件包含每个文件发布的详细时间信息。请注意:所有文件的时间标记都采用世界标准时间。
文件命名约定如下所示(FFF可替换成latestDoc.csv文件D列的文件名):
文件名格式 | 示例 | 命名方法和内容的阐述 |
---|---|---|
latestFFF.csv | latestdcm.csv | 最新数据会频繁发布到该文件。另外需要注意的是,在更正以往数据或需要发布遗漏数据等少数情况下,这些数据都会列入该文件并标记为“更正”(参见“状态”列的定义)。这将导致更新历史数据集或在其中插入新内容。另外还需注意,如果在交易结束前发现需要进行更正,我们将在此文件中发布更正信息,然后在下一工作日生成新文件时在最新文件中再次发布更正信息。这将确保每天只阅读一次文件的客户能在下一个工作日接收到更正信息。 |
previousFFF.csv | previousdcm.csv | 当天发布价格信息时,前一天的数据将会被转移到该文件。 |
yyyymmddFFF.csv | 20130909dcm.csv | 当天发布价格信息时,前一天的数据将会被复制到文件名含时间标记的新文件中。通常采用这种方式保留10个工作日左右的日报文件、5个工作日的周报文件和2个工作日的月报文件。 |
下方的屏幕截图为2013年9月9日发布的DAMCOAL文件夹示例。该FTP实例被托管在采用美国东部标准时区运行的服务器上,因此时间标记比英国时间延迟5个小时。阿格斯在不同的时区进行FTP服务器托管。为避免歧义,推荐使用在RFC-3659中描述的MDTM FTP命令。
该DAMCOAL文件夹包含两个文件,“dcm”文件包含每天和每周发布的价格信息(例如API 2),“dcm2”文件包含每周和每月发布的价格信息,所以它一周会更新一次,在本示例中文件于周五更新。
DATA CSV文件格式
相比每项评估内仅含名称、日期、数值和时间标记信息,CSV数据文件所包含的信息要多出很多。多出的信息与评估时间和定价依据有关。例如,“阿格斯北海即期原油市场报告”(Argus North Sea Dated)是根据北海远月价格信息计算得出的,csv文件将包含指明是从哪月开始进行定价的数据。一些价格序列表示的都是远期价格且基于另一价格系列而得出,csv文件将收录所有相关时间信息。
此外(同一示例),所有北海远月价格(最近有四项阿格斯北海远月价格)都使用相同代码,所以csv文件含有一个”连续远期”字段。连续远期值代表每个远期周期的序列。例如,阿格斯发布北海远月1、北海远月2、北海远月3和北海远月4价格,则远期周期就可能是10、11、12、1(10月、11月、12月、1月),但连续远期值将一直会是代表第1、第2、第3和第4个月的1、2、3、4。
利用远期周期和连续远期字段,结合日期,即可在数据库中按有效月份(即八月)来提取数据,或按根据用户所需而定的第一个月来提取数据。结合年份,即可利用这些字段生成2003年8月咨询。
从末尾字段可以看出数据记录是新的还是更正后的。如此一来,阿格斯便能将更正数据放入常规的每日数据文件中,和新数据放到一起。用户只需下载一次就能接收到最新数据和更新后数据,这样就可确保用户数据库与阿格斯主数据库保持同步更新。
CSV文件示例:
代码、TS类型、PT代码、日期、价值、远期期间、基准滚动差价、年份、连续远期、记录状态 |
PA0001723,6,1,06-JUN-2006,68.19,0,7,2006,0,N |
PA0001723,6,2,06-JUN-2006,68.25,0,7,2006,0,N |
PA0001723,6,3,06-JUN-2006,-1.800,0,7,2006,0,N |
PA0002654,6,1,06-JUN-2006,68.62,6,0,2006,1,N |
PA0002654,1,1,06-JUN-2006,70.28,6,0,2006,1,N |
PA0002654,1,2,06-JUN-2006,70.36,6,0,2006,1,N |
PA0002654,6,2,06-JUN-2006,68.72,6,0,2006,1,N |
PA0002654,1,1,06-JUN-2006,71.36,7,0,2006,2,N |
PA0002654,6,1,06-JUN-2006,69.99,7,0,2006,2,N |
PA0002654,6,2,06-JUN-2006,70.05,7,0,2006,2,N |
PA0002654,1,2,06-JUN-2006,71.42,7,0,2006,2,N |
PA0002654,6,1,06-JUN-2006,71.32,8,0,2006,3,N |
PA0002654,1,1,06-JUN-2006,72.42,8,0,2006,3,N |
PA0002654,1,2,06-JUN-2006,72.50,8,0,2006,3,N |
PA0002654,6,2,06-JUN-2006,71.42,8,0,2006,3,N |
PA0002654,1,1,06-JUN-2006,73.13,9,0,2006,4,N |
PA0002654,6,1,06-JUN-2006,72.09,9,0,2006,4,N |
PA0002654,6,2,06-JUN-2006,72.17,9,0,2006,4,N |
PA0002654,1,2,06-JUN-2006,73.21,9,0,2006,4,N |
PA0002654,1,1,05-JUN-2006,70.43,7,0,2006,1,C |
PA0002654,1,2,05-JUN-2006,70.49,7,0,2006,1 |
注意:首行包含字段标题。
代码—第1列
一个字符串字段。此为商品标识符。标识符与代码描述表结合,提供商品、单位等信息。
例如:PA0002654代码:PA0002654
显示名称:北海远月价格
交付代码:fob
单位:美元/桶
时间:月
远期周期描述:月份值
频率:每天
时间标记类型—第2列
整数字段。TS(时间标记)类型为评估确定的时间,时间值为分配到特定时间的标识符。一个代码可以有多个时间标记,例如阿格斯可以在伦敦正午时间和伦敦收盘时间生成北海远月原油价格评估(请参见获取确切时间值的相关作价方法)。使用一个代码和多个时间标记修饰符可将所有数据(此示例中为北海即期价格)放到一起。下载时间标记列表
价格类型代码—第3列
整数字段。PT(价格类型)是描述评估价格类型的标识符。一个代码可以有多种价格类型,例如阿格斯可为买入价、卖出价和中值提供北海原油即期价格评估。使用一个代码和多个价格类型修饰符可将所有数据(此示例中为北海即期价格)放到一起。下载价格类型列表
日期——第4列
DD-MMM-YYYY格式的日期字段。自描述型字段—评估日期。
数值——第5列
一个非整数数值字段。此字段为评估值,也是一个自描述型字段。此代码描述表描述此数值的单位。
远期周期—第6列
整数字段。远期周期(Fwd,有时也称为“交付周期”)描述评估适用的周期时间。此字段的数值根据codes.csv文件的定义可表示年、月、周、日。
差异基准滚动值—第7列
整数字段。差异(Diff)基准滚动值是主要用于(但不局限于)原油评估的字段,这种原油评估是相对另一种原油(如非原油则为商品)进行的评估。“阿格斯北海即期原油市场报告”(Argus North Sea Dated)是一项原油评估服务,是相对于北海远月价格序列的远月价格而进行的评估。为了能继续追踪基本远月价格,差异基准滚动值保留了月份值。差异基准滚动值是从1到12的月份值。
年份值—第8列
此为评估有效年。如果此序列为即期价,那年份值就和第4列评估日期中的年份值一致。如果此序列为远期交付价或期货价,甚至是以往周期的价格,那么该年份值就为远期周期的实际年份。在上文示例文件中,代码PA0002731有10行数据,代表的是巴克顿天然气远月价格信息。因为该价格为2004年2月到2004年6月间的价格,所以此数据代表的是2004年的当时价格。而8月前后的数据则会如下显示:
代码、TS类型、PT代码、日期、价值、远期期间、基准滚动差价、年份、连续远期、记录状态 |
PA0002731,6,1,17-AUG-2004,29.6,9,0,2004,1,N |
PA0002731,6,2,17-AUG-2004,29.8,9,0,2004,1,N |
PA0002731,6,1,17-AUG-2004,23.4,10,0,2004,2,N |
PA0002731,6,2,17-AUG-2004,23.6,10,0,2004,2,N |
PA0002731,6,1,17-AUG-2004,21.6,11,0,2004,3,N |
PA0002731,6,2,17-AUG-2004,21.8,11,0,2004,3,N |
PA0002731,6,1,17-AUG-2004,18.85,12,0,2004,4,N |
PA0002731,6,2,17-AUG-2004,18.95,12,0,2004,4,N |
PA0002731,6,1,17-AUG-2004,18,1,0,2005,5,N |
PA0002731,6,2,17-AUG-2004,18.1,1,0,2005,5,N |
用表格更能清晰阐述:
代码 | TS类型 |
PT代码 |
日期 |
数值 |
远期周期 |
差异基准滚动值 |
年份值 |
连续远期 |
记录状态 |
---|---|---|---|---|---|---|---|---|---|
PA0002731 | 6 |
1 |
2004年8月17日 |
29.6 | 9 | 0 | 2004 | 1 | N |
PA0002731 | 6 | 2 |
2004年8月17日 | 29.8 | 9 | 0 | 2004 | 1 | N |
PA0002731 | 6 |
1 |
2004年8月17日 | 23.4 | 10 | 0 | 2004 | 2 | N |
PA0002731 | 6 | 2 |
2004年8月17日 | 23.6 | 10 | 0 | 2004 | 2 | N |
PA0002731 | 6 | 1 | 2004年8月17日 | 21.6 | 11 | 0 | 2004 | 3 | N |
PA0002731 | 6 | 2 | 2004年8月17日 | 21.8 | 11 | 0 | 2004 | 3 | N |
PA0002731 | 6 | 1 |
2004年8月17日 | 18.85 | 12 | 0 | 2004 | 4 | N |
PA0002731 | 6 | 2 |
2004年8月17日 | 18.95 | 12 | 0 | 2004 | 4 | N |
PA0002731 | 6 | 1 |
2004年8月17日 | 18 | 1 | 0 | 2005 | 5 | N |
PA0002731 | 6 | 2 |
2004年8月17日 | 18.1 | 1 | 0 | 2005 | 5 | N |
在最后两行,年份值已滚动至2005年前后。这是因为此代码价格的远期周期为1(1月),远期周期也就相应转到了下一年(2005年)。
连续远期—第9列
与远期周期和年份值有着密切关系的是连续(cont)周期。继续用上面的示例举例,代码PA0002731有10行数据。含有五对数据。每对在价格类型、数值、远期周期和连续周期上都有区别。该价格类型表示它们为买入价对/卖出价对。该远期周期代表着从9月到次年1月间的月份。该连续周期显示了远月1、远月2、远月3、远月4和远月5的远期价格。
状态—第10列
从该状态标记可看出该价格是新的数据点还是更正后的数据点。这些数值里“N”代表新数据,“C”代表更正后数据,“H”代表历史更正数据(参见下文)。更正数据有时也提供以前遗漏的数据。此标记强调了该数据是相对一般日常数据而言的追加数据,因为之前出现过一个特定记录上的问题。如果“搜索”失败也不会阻止从更正中创建新的记录,那么就可以用此标记找出现有记录并覆盖数据。
阿格斯会不断清理和审查时间序列数据,当发现遗漏或错误时也会进行更正。如果数据是“旧”的(比如6个月以上的数据),那么一般不会发布新的更新,除非数据里的数字是基于大量其他价格数据而得出的“北海即期价格”之类的重要指标。阿格斯可以自行发布有关“旧”数据的更正信息。
注意:连续分隔符视为一个分隔符。