Difference between revisions of "Linden Lab Official:Live Data Feeds"
Jump to navigation
Jump to search
Natty Linden (talk | contribs) (reflect api.secondlife.com updates) |
|||
(21 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
{{ | {{Supported API}} | ||
{{:API Portal/navigation}} | {{:API Portal/navigation}} | ||
__TOC__ | __TOC__ | ||
<br clear="all"/> | |||
== | == Statistics == | ||
=== XML feed === | === XML feed === | ||
: | : https://api.secondlife.com/datafeeds/secondlife.xml | ||
Example Response: | |||
<nowiki><stats> | <nowiki><stats> | ||
<status>ONLINE</status> | <status>ONLINE</status> | ||
<signups>18,072,648</signups> | <signups>18,072,648</signups> | ||
<inworld>38,836</inworld> | <inworld>38,836</inworld> | ||
</stats></nowiki> | </stats></nowiki> | ||
=== LLSD feed ( | {| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff" | ||
: | |- | ||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Parameter''' | |||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Data type''' | |||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Description''' | |||
|- | |||
|status | |||
|string | |||
|<code>ONLINE</code> when the grid is online. If the grid is offline, <code>OFFLINE</code>. | |||
|- | |||
|signups | |||
|comma delimited integer | |||
|Number of Resident accounts that are open and in good standing. Updated daily. | |||
|- | |||
|inworld | |||
|comma delimited integer | |||
|Number of Resident accounts currently logged in. Updated every 3 minutes. | |||
|} | |||
=== LLSD feed === | |||
: https://api.secondlife.com/datafeeds/homepage.xml | |||
Each key pair has additional dates associated indicating when the data was updated in UNIX time and SL time (Pacific Time). | |||
Example: | |||
<nowiki><llsd> | |||
<map> | |||
<key>stats</key> | |||
<map> | |||
<key>signups</key> | |||
<integer>18072841</integer> | |||
<key>signups_updated_unix</key> | |||
<integer>1265100902</integer> | |||
<key>signups_updated_slt</key> | |||
<string>2010-02-02 00:55:02</string> | |||
<key>inworld</key> | |||
<integer>38574</integer> | |||
<key>inworld_updated_unix</key> | |||
<integer>1265100605</integer> | |||
<key>inworld_updated_slt</key> | |||
<string>2010-02-02 00:50:05</string> | |||
</map> | |||
</map> | |||
</llsd></nowiki> | |||
{| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff" | |||
|- | |||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Parameter''' | |||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Data type''' | |||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Description''' | |||
|- | |||
|signups | |||
|integer | |||
|Number of Resident accounts that are open and in good standing. Updated daily | |||
|- | |||
|signups_updated_unix | |||
|integer | |||
|UNIX time stamp when signups value was last updated. | |||
|- | |||
|signups_updated_slt | |||
|date | |||
|Time stamp when signups value was last updated in Pacific Time. | |||
|- | |||
|inworld | |||
|integer | |||
|Number of Resident accounts currently logged in. Updated every 3 minutes. | |||
|- | |||
|inworld_updated_unix | |||
|integer | |||
|UNIX time stamp when inworld value was last updated. | |||
|- | |||
|inworld_updated_slt | |||
|date | |||
|Time stamp when inworld value was last updated in Pacific Time. | |||
|} | |||
=== Text Feed === | |||
Newline-seperated key-value pairs, with timestamps (for [[llHTTPRequest]]()) | |||
: https://api.secondlife.com/datafeeds/homepage.txt | |||
Key Pairs are delimited by new lines. Each key pair has additional dates associated indicating when the data was updated in UNIX time and SL time (Pacific Time). | |||
Example: | |||
signups_updated_slt | |||
2010-02-02 00:55:02 | |||
: | signups_updated_unix | ||
1265100902 | |||
signups | |||
18072841 | |||
exchange_rate_updated_slt | |||
2010-02-02 01:03:28 | |||
exchange_rate_updated_unix | |||
1265101408 | |||
exchange_rate | |||
262.2055 | |||
inworld_updated_unix | |||
1265101209 | |||
inworld_updated_slt | |||
2010-02-02 01:00:09 | |||
inworld | |||
38489 | |||
; | {| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff" | ||
: | |- | ||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Parameter''' | |||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Data type''' | |||
|style="background: #cee0f2; padding: 0.3em; text-align:center;"|'''Description''' | |||
|- | |||
|signups_updated_slt | |||
|date | |||
|Time stamp when signups value was last updated in Pacific Time. | |||
|- | |||
|signups_updated_unix | |||
|integer | |||
|UNIX time stamp when signups value was last updated. | |||
|- | |||
|signups | |||
|integer | |||
|Number of Resident accounts that are open and in good standing. Updated daily. | |||
|- | |||
|exchange_rate_updated_slt | |||
|date | |||
|Time stamp when exchange_rate value was last updated in Pacific Time. | |||
|- | |||
|exchange_rate_updated_unix | |||
|integer | |||
|UNIX time stamp when exchange_rate value was last updated. | |||
|- | |||
|exchange_rate | |||
|float | |||
|Average number of L$ that 1 US$ can purchase. | |||
|- | |||
|inworld_updated_unix | |||
|integer | |||
|UNIX time stamp when inworld value was last updated. | |||
|- | |||
|inworld_updated_slt | |||
|date | |||
|Time stamp when inworld value was last updated in Pacific Time. | |||
|- | |||
|inworld | |||
|integer | |||
|Number of Resident accounts currently logged in. Updated every 3 minutes. | |||
|} | |||
== LindeX == | |||
: | |||
=== [[LLSD]] feed === | |||
: https://api.secondlife.com/datafeeds/lindex.xml | |||
Example: | |||
<nowiki><llsd> | |||
<map> | |||
<key>stats</key> | |||
<map> | |||
<key>last_updated_unix</key> | |||
<integer>1265102153</integer> | |||
<key>last_updated_slt</key> | |||
<string>2010-02-02 01:15:53</string> | |||
<key>limit_buy_to_limit_sell</key> | |||
<map> | |||
<key>1_hour</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>0</integer> | |||
<key>max_rate</key> | |||
<integer>0</integer> | |||
<key>l$_volume</key> | |||
<integer>0</integer> | |||
<key>us$_volume</key> | |||
<float>0.00</float> | |||
</map> | |||
<key>1_day</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>259</integer> | |||
<key>max_rate</key> | |||
<integer>269</integer> | |||
<key>l$_volume</key> | |||
<integer>107679</integer> | |||
<key>us$_volume</key> | |||
<float>409.06</float> | |||
</map> | |||
<key>today</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>0</integer> | |||
<key>max_rate</key> | |||
<integer>0</integer> | |||
<key>l$_volume</key> | |||
<integer>0</integer> | |||
<key>us$_volume</key> | |||
<float>0.00</float> | |||
</map> | |||
</map> | |||
<key>market_buy</key> | |||
<map> | |||
<key>1_hour</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>259</integer> | |||
<key>max_rate</key> | |||
<integer>260</integer> | |||
<key>l$_volume</key> | |||
<integer>1681958</integer> | |||
<key>us$_volume</key> | |||
<float>6476.66</float> | |||
</map> | |||
<key>1_day</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>259</integer> | |||
<key>max_rate</key> | |||
<integer>268</integer> | |||
<key>l$_volume</key> | |||
<integer>75386206</integer> | |||
<key>us$_volume</key> | |||
<float>290519.80</float> | |||
</map> | |||
<key>today</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>259</integer> | |||
<key>max_rate</key> | |||
<integer>260</integer> | |||
<key>l$_volume</key> | |||
<integer>2252570</integer> | |||
<key>us$_volume</key> | |||
<float>8674.93</float> | |||
</map> | |||
</map> | |||
<key>limit_buy</key> | |||
<map> | |||
<key>best_10_percent</key> | |||
<map> | |||
<key>l$_offered</key> | |||
<integer>45217317</integer> | |||
<key>min_rate</key> | |||
<integer>269</integer> | |||
<key>max_rate</key> | |||
<integer>295</integer> | |||
</map> | |||
</map> | |||
<key>market_sell</key> | |||
<map> | |||
<key>1_hour</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>268</integer> | |||
<key>max_rate</key> | |||
<integer>269</integer> | |||
<key>l$_volume</key> | |||
<integer>566660</integer> | |||
<key>us$_volume</key> | |||
<float>2111.89</float> | |||
</map> | |||
<key>1_day</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>263</integer> | |||
<key>max_rate</key> | |||
<integer>269</integer> | |||
<key>l$_volume</key> | |||
<integer>31952607</integer> | |||
<key>us$_volume</key> | |||
<float>118893.52</float> | |||
</map> | |||
<key>today</key> | |||
<map> | |||
<key>min_rate</key> | |||
<integer>268</integer> | |||
<key>max_rate</key> | |||
<integer>269</integer> | |||
<key>l$_volume</key> | |||
<integer>711410</integer> | |||
<key>us$_volume</key> | |||
<float>2650.43</float> | |||
</map> | |||
</map> | |||
<key>limit_sell</key> | |||
<map> | |||
<key>best_10_percent</key> | |||
<map> | |||
<key>l$_offered</key> | |||
<integer>128164597</integer> | |||
<key>min_rate</key> | |||
<integer>235</integer> | |||
<key>max_rate</key> | |||
<integer>260</integer> | |||
</map> | |||
</map> | |||
</map> | |||
</map> | |||
</llsd></nowiki> | |||
=== Text feed === | |||
Newline-separated key-value pairs for [[llHTTPRequest]]() | |||
: https://api.secondlife.com/datafeeds/lindex.txt | |||
updated_unix | |||
1265102153 | |||
updated_slt | |||
2010-02-02 01:15:53 | |||
ll_1h_l$ | |||
0 | |||
ll_1h_us$ | |||
0.00 | |||
ll_1h_max_rate | |||
0 | |||
ll_1h_min_rate | |||
0 | |||
ll_1d_us$ | |||
409.06 | |||
ll_1d_max_rate | |||
269 | |||
ll_1d_min_rate | |||
259 | |||
ll_1d_l$ | |||
107679 | |||
ll_t_max_rate | |||
0 | |||
ll_t_min_rate | |||
0 | |||
ll_t_us$ | |||
0.00 | |||
ll_t_l$ | |||
0 | |||
mb_1h_min_rate | |||
259 | |||
mb_1h_max_rate | |||
260 | |||
mb_1h_l$ | |||
1681958 | |||
mb_1h_us$ | |||
6476.66 | |||
mb_1d_us$ | |||
290519.80 | |||
mb_1d_l$ | |||
75386206 | |||
mb_1d_min_rate | |||
259 | |||
mb_1d_max_rate | |||
268 | |||
mb_t_max_rate | |||
260 | |||
mb_t_us$ | |||
8674.93 | |||
mb_t_l$ | |||
2252570 | |||
mb_t_min_rate | |||
259 | |||
lb_10%_max_rate | |||
295 | |||
lb_10%_l$_offer | |||
45217317 | |||
lb_10%_min_rate | |||
269 | |||
ms_1h_max_rate | |||
269 | |||
ms_1h_min_rate | |||
268 | |||
ms_1h_us$ | |||
2111.89 | |||
ms_1h_l$ | |||
566660 | |||
ms_1d_max_rate | |||
269 | |||
ms_1d_us$ | |||
118893.52 | |||
ms_1d_l$ | |||
31952607 | |||
ms_1d_min_rate | |||
263 | |||
ms_t_max_rate | |||
269 | |||
ms_t_l$ | |||
711410 | |||
ms_t_min_rate | |||
268 | |||
ms_t_us$ | |||
2650.43 | |||
ls_10%_max_rate | |||
260 | |||
ls_10%_min_rate | |||
235 | |||
ls_10%_l$_offer | |||
128164597 | |||
The LindeX feeds are updated every 15 minutes and include one set of timestamps. | The LindeX feeds are updated every 15 minutes and include one set of timestamps. | ||
[ | |||
== Reference == | |||
* [http://community.secondlife.com/t5/Features/New-Data-Feeds-1/ba-p/525446 New Data Feeds #1], SL blog, 2006-10-03 | |||
* [http://forums-archive.secondlife.com/54/3c/234168/1.html "Concurrency stats" thread], archived SL forums, 2008-08-01 |
Latest revision as of 10:30, 2 November 2022
NOTE: This is an official Second Life API provided and documented by Linden Lab. Its use is subject to the API Terms of Use.
Unofficial APIs
Statistics
XML feed
Example Response:
<stats> <status>ONLINE</status> <signups>18,072,648</signups> <inworld>38,836</inworld> </stats>
Parameter | Data type | Description |
status | string | ONLINE when the grid is online. If the grid is offline, OFFLINE .
|
signups | comma delimited integer | Number of Resident accounts that are open and in good standing. Updated daily. |
inworld | comma delimited integer | Number of Resident accounts currently logged in. Updated every 3 minutes. |
LLSD feed
Each key pair has additional dates associated indicating when the data was updated in UNIX time and SL time (Pacific Time).
Example:
<llsd> <map> <key>stats</key> <map> <key>signups</key> <integer>18072841</integer> <key>signups_updated_unix</key> <integer>1265100902</integer> <key>signups_updated_slt</key> <string>2010-02-02 00:55:02</string> <key>inworld</key> <integer>38574</integer> <key>inworld_updated_unix</key> <integer>1265100605</integer> <key>inworld_updated_slt</key> <string>2010-02-02 00:50:05</string> </map> </map> </llsd>
Parameter | Data type | Description |
signups | integer | Number of Resident accounts that are open and in good standing. Updated daily |
signups_updated_unix | integer | UNIX time stamp when signups value was last updated. |
signups_updated_slt | date | Time stamp when signups value was last updated in Pacific Time. |
inworld | integer | Number of Resident accounts currently logged in. Updated every 3 minutes. |
inworld_updated_unix | integer | UNIX time stamp when inworld value was last updated. |
inworld_updated_slt | date | Time stamp when inworld value was last updated in Pacific Time. |
Text Feed
Newline-seperated key-value pairs, with timestamps (for llHTTPRequest())
Key Pairs are delimited by new lines. Each key pair has additional dates associated indicating when the data was updated in UNIX time and SL time (Pacific Time).
Example:
signups_updated_slt 2010-02-02 00:55:02 signups_updated_unix 1265100902 signups 18072841 exchange_rate_updated_slt 2010-02-02 01:03:28 exchange_rate_updated_unix 1265101408 exchange_rate 262.2055 inworld_updated_unix 1265101209 inworld_updated_slt 2010-02-02 01:00:09 inworld 38489
Parameter | Data type | Description |
signups_updated_slt | date | Time stamp when signups value was last updated in Pacific Time. |
signups_updated_unix | integer | UNIX time stamp when signups value was last updated. |
signups | integer | Number of Resident accounts that are open and in good standing. Updated daily. |
exchange_rate_updated_slt | date | Time stamp when exchange_rate value was last updated in Pacific Time. |
exchange_rate_updated_unix | integer | UNIX time stamp when exchange_rate value was last updated. |
exchange_rate | float | Average number of L$ that 1 US$ can purchase. |
inworld_updated_unix | integer | UNIX time stamp when inworld value was last updated. |
inworld_updated_slt | date | Time stamp when inworld value was last updated in Pacific Time. |
inworld | integer | Number of Resident accounts currently logged in. Updated every 3 minutes. |
LindeX
LLSD feed
Example:
<llsd> <map> <key>stats</key> <map> <key>last_updated_unix</key> <integer>1265102153</integer> <key>last_updated_slt</key> <string>2010-02-02 01:15:53</string> <key>limit_buy_to_limit_sell</key> <map> <key>1_hour</key> <map> <key>min_rate</key> <integer>0</integer> <key>max_rate</key> <integer>0</integer> <key>l$_volume</key> <integer>0</integer> <key>us$_volume</key> <float>0.00</float> </map> <key>1_day</key> <map> <key>min_rate</key> <integer>259</integer> <key>max_rate</key> <integer>269</integer> <key>l$_volume</key> <integer>107679</integer> <key>us$_volume</key> <float>409.06</float> </map> <key>today</key> <map> <key>min_rate</key> <integer>0</integer> <key>max_rate</key> <integer>0</integer> <key>l$_volume</key> <integer>0</integer> <key>us$_volume</key> <float>0.00</float> </map> </map> <key>market_buy</key> <map> <key>1_hour</key> <map> <key>min_rate</key> <integer>259</integer> <key>max_rate</key> <integer>260</integer> <key>l$_volume</key> <integer>1681958</integer> <key>us$_volume</key> <float>6476.66</float> </map> <key>1_day</key> <map> <key>min_rate</key> <integer>259</integer> <key>max_rate</key> <integer>268</integer> <key>l$_volume</key> <integer>75386206</integer> <key>us$_volume</key> <float>290519.80</float> </map> <key>today</key> <map> <key>min_rate</key> <integer>259</integer> <key>max_rate</key> <integer>260</integer> <key>l$_volume</key> <integer>2252570</integer> <key>us$_volume</key> <float>8674.93</float> </map> </map> <key>limit_buy</key> <map> <key>best_10_percent</key> <map> <key>l$_offered</key> <integer>45217317</integer> <key>min_rate</key> <integer>269</integer> <key>max_rate</key> <integer>295</integer> </map> </map> <key>market_sell</key> <map> <key>1_hour</key> <map> <key>min_rate</key> <integer>268</integer> <key>max_rate</key> <integer>269</integer> <key>l$_volume</key> <integer>566660</integer> <key>us$_volume</key> <float>2111.89</float> </map> <key>1_day</key> <map> <key>min_rate</key> <integer>263</integer> <key>max_rate</key> <integer>269</integer> <key>l$_volume</key> <integer>31952607</integer> <key>us$_volume</key> <float>118893.52</float> </map> <key>today</key> <map> <key>min_rate</key> <integer>268</integer> <key>max_rate</key> <integer>269</integer> <key>l$_volume</key> <integer>711410</integer> <key>us$_volume</key> <float>2650.43</float> </map> </map> <key>limit_sell</key> <map> <key>best_10_percent</key> <map> <key>l$_offered</key> <integer>128164597</integer> <key>min_rate</key> <integer>235</integer> <key>max_rate</key> <integer>260</integer> </map> </map> </map> </map> </llsd>
Text feed
Newline-separated key-value pairs for llHTTPRequest()
updated_unix 1265102153 updated_slt 2010-02-02 01:15:53 ll_1h_l$ 0 ll_1h_us$ 0.00 ll_1h_max_rate 0 ll_1h_min_rate 0 ll_1d_us$ 409.06 ll_1d_max_rate 269 ll_1d_min_rate 259 ll_1d_l$ 107679 ll_t_max_rate 0 ll_t_min_rate 0 ll_t_us$ 0.00 ll_t_l$ 0 mb_1h_min_rate 259 mb_1h_max_rate 260 mb_1h_l$ 1681958 mb_1h_us$ 6476.66 mb_1d_us$ 290519.80 mb_1d_l$ 75386206 mb_1d_min_rate 259 mb_1d_max_rate 268 mb_t_max_rate 260 mb_t_us$ 8674.93 mb_t_l$ 2252570 mb_t_min_rate 259 lb_10%_max_rate 295 lb_10%_l$_offer 45217317 lb_10%_min_rate 269 ms_1h_max_rate 269 ms_1h_min_rate 268 ms_1h_us$ 2111.89 ms_1h_l$ 566660 ms_1d_max_rate 269 ms_1d_us$ 118893.52 ms_1d_l$ 31952607 ms_1d_min_rate 263 ms_t_max_rate 269 ms_t_l$ 711410 ms_t_min_rate 268 ms_t_us$ 2650.43 ls_10%_max_rate 260 ls_10%_min_rate 235 ls_10%_l$_offer 128164597
The LindeX feeds are updated every 15 minutes and include one set of timestamps.
Reference
- New Data Feeds #1, SL blog, 2006-10-03
- "Concurrency stats" thread, archived SL forums, 2008-08-01