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

From Second Life Wiki
Jump to navigation Jump to search
(reflect api.secondlife.com updates)
 
(20 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{:API Portal/navigation
{{Supported API}}
|style=style="float:right;width:15em;padding-bottom:1em;"}}
 
{{:API Portal/navigation}}
{{:API Portal/navigation}}
__TOC__
__TOC__
 
<br clear="all"/>
== Homepage stats feed ==  
== Statistics ==  


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


Example Response:
Example Response:
Line 14: Line 12:
     <status>ONLINE</status>  
     <status>ONLINE</status>  
     <signups>18,072,648</signups>  
     <signups>18,072,648</signups>  
    <logged_in_last_60>1,404,640</logged_in_last_60>
    <transactions>3,065,550</transactions>
     <inworld>38,836</inworld>  
     <inworld>38,836</inworld>  
  </stats></nowiki>
  </stats></nowiki>
Line 27: Line 23:
|status
|status
|string
|string
|ONLINE when the grid is online. (What other values are presented?)
|<code>ONLINE</code> when the grid is online. If the grid is offline, <code>OFFLINE</code>.
|-
|-
|signups
|signups
|comma delimited integer
|comma delimited integer
|number of Resident accounts that are open and in good standing; updated daily
|Number of Resident accounts that are open and in good standing. Updated daily.
|-
|-
|looged_in_last_60
|inworld
|comma delimited integer
|comma delimited integer
|number of Resident accounts that have logged in in the past 60 days; updated daily
|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.
|-
|-
|transactions
|inworld_updated_slt
|comma delimited integer
|date
|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
|Time stamp when inworld value was last updated in Pacific Time.
|-
|-
|inworld
|inworld
|comma delimited integer
|integer
|number of Resident accounts currently logged in; updated every 3 minutes
|Number of Resident accounts currently logged in. Updated every 3 minutes.
|}
|}


=== LLSD feed (With timestamps) ===
== LindeX ==
: http://secondlife.com/xmlhttp/homepage.php
 
=== [[LLSD]] feed ===
 
: https://api.secondlife.com/datafeeds/lindex.xml


=== Newline-seperated key-value pairs, with timestamps ===
Example:
(for [[llHttpRequest]]())
<nowiki><llsd>
:http://secondlife.com/httprequest/homepage.php
<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>


== LindeX data feeds ==  
=== Text feed ===


; [[LLSD]]-formatted XML
Newline-separated key-value pairs for [[llHTTPRequest]]()
:http://secondlife.com/xmlhttp/lindex.php


;Newline-separated key-value pairs for [[llHttpRequest]]()
: https://api.secondlife.com/datafeeds/lindex.txt
:http://secondlife.com/httprequest/lindex.php
 
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.


[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 11: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