本篇重点

• Snapshots 介绍与属性说明
• VS Code 查看Function参数内容

Snapshots

官方说明文件：https://sinotrade.github.io/tutor/snapshot/
Snapshots，中文翻译为「快照」，也就是用来抓取金融商品当下的资讯，这个资讯，就相当於平常看盘时的这个画面

也因为是抓取当下的资讯，所以Snapshots呼叫时无法给定特定的时间点，只须传入Contract的List，而回传的资料为shioaji.data.Snapshot物件的List。而Snapshots除了可以拿来抓取个股当下的交易资讯，也可以抓取期货、选择权或指数当下的交易资讯，只要把对应的Contract加入List即可。
程序码范例如下：

contracts = [api.Contracts.Stocks['2330'], api.Contracts.Stocks['2890']]
snapshots = api.snapshots(contracts)

属性说明：

VS Code 查看Function参数内容

有时在查看官方说明文件时，会发现文件上没有特别说明Function的参数内容，这时可以透过VS Code的功能，来查看Function的参数内容。查看方式有下列三种

1. 在编写程序码时，VS Code会自动显示
   
2. 在VS Code中，将滑鼠指标停留在该Function上方，VS Code就会自动显示该Funciton的参数内容说明
   
3. 跟第二个方式相同，只是在滑鼠指标停得在该Function上方时，按住Ctrl键，此时滑鼠指标就会变成手套
   
   接着，按下滑鼠左键，VS Code就会自动开启该Function所在的python程序档案并显示Function的定义内容
   
   熟悉上列三种方式，之後若遇到说明文件中没有提到的Funtion，也能自己透过VS Code去了解该Function有哪些参数及要如何使用。