Difference between revisions of "Linden Lab Official:Live Data Feeds"

From Second Life Wiki
Jump to navigation Jump to search
(Updated the link to the source blogpost, since the old one wasn't being converted correctly in the new blog system.)
(reflect api.secondlife.com updates)
 
(27 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{:API Portal/navigation
{{Supported API}}
|style=style="float:right;width:15em;padding-bottom:1em;"}}
{{:API Portal/navigation}}
__TOC__
<br clear="all"/>
== Statistics ==


'''Homepage stats feed''' http://secondlife.com/xmlhttp/secondlife.php
=== XML feed ===
: https://api.secondlife.com/datafeeds/secondlife.xml


It returns:
Example Response:
*signups (in # of accounts): number of Resident accounts that are open and in good standing; updated daily
<nowiki><stats>
*logged_in_last_60 (in # of accounts): number of Resident accounts that have logged in in the past 60 days; updated daily
    <status>ONLINE</status>
*Transactions (in US$): amount of resident-to-resident L$ transactions for past 24 hours divided by the average LindeX exchange rate for past 24 hours; updated every 30 minutes
    <signups>18,072,648</signups>
*inworld (in # of accounts): number of Resident accounts currently logged in; updated every 3 minutes
    <inworld>38,836</inworld>
</stats></nowiki>


Two other ways to get that data, these feeds include timestamps for each value:
{| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff"
*[http://secondlife.com/xmlhttp/homepage.php LLSD formatted XML]
|-
*[http://secondlife.com/httprequest/homepage.php newline separated key-value pairs]; this can be read via llHTTPRequest()
|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


'''LindeX data feeds''' are available at:
*[http://secondlife.com/xmlhttp/lindex.php in LLSD formatted XML]
*[http://secondlife.com/httprequest/lindex.php in newline separated key-value pairs]; this can be read via [[llHTTPRequest]]()
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.


[https://blogs.secondlife.com/community/features/blog/2006/10/03/new-data-feeds-1 Source]
 
== 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.


Statistics

XML feed

https://api.secondlife.com/datafeeds/secondlife.xml

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

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: 

<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())

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


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

https://api.secondlife.com/datafeeds/lindex.xml

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()

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.


Reference

Retrieved from "https://wiki.secondlife.com/w/index.php?title=Linden_Lab_Official:Live_Data_Feeds&oldid=1212733"