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)
 
(17 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
|comma delimited integer
|number of Resident accounts that have logged in in the past 60 days; updated daily
|-
|transactions
|comma delimited integer
|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
|-
|-
|inworld
|inworld
|comma delimited integer
|comma delimited 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 ===
=== LLSD feed ===
: http://secondlife.com/xmlhttp/homepage.php
: 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).
Each key pair has additional dates associated indicating when the data was updated in UNIX time and SL time (Pacific Time).
Line 62: Line 50:
  <key>signups_updated_slt</key>  
  <key>signups_updated_slt</key>  
  <string>2010-02-02 00:55:02</string>  
  <string>2010-02-02 00:55:02</string>  
<key>logged60</key>
<integer>1404640</integer>
<key>logged60_updated_unix</key>
<integer>1265097599</integer>
<key>logged60_updated_slt</key>
<string>2010-02-01 23:59:59</string>
<key>transactions_us$</key>
<integer>3065694</integer>
<key>transactions_us$_updated_unix</key>
<integer>1265100936</integer>
<key>transactions_us$_updated_slt</key>
<string>2010-02-02 00:55:36</string>
<key>transactions_us$_freshness_unix</key>
<integer>1265097624</integer>
<key>transactions_us$_freshness_slt</key>
<string>2010-02-02 00:00:24</string>
  <key>inworld</key>  
  <key>inworld</key>  
  <integer>38574</integer>  
  <integer>38574</integer>  
Line 96: Line 68:
|signups
|signups
|integer
|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
|-
|-
|signups_updated_unix
|signups_updated_unix
Line 104: Line 76:
|signups_updated_slt
|signups_updated_slt
|date
|date
|time stamp when signups value was last updated in Pacific Time.
|Time stamp when signups value was last updated in Pacific Time.
|-
|logged60
|integer
|number of Resident accounts that have logged in in the past 60 days; updated daily
|-
|logged60_updated_unix
|integer
|UNIX time stamp when logged60 value was last updated.
|-
|logged60_updated_slt
|date
|time stamp when logged60 value was last updated in Pacific Time.
|-
|transactions_us$
|integer
|amount of US currency traded as resident-to-resident L$ transactions for past 24 hours divided by the average LindeX exchange rate for past 24 hours; updated every 30 minutes
|-
|transactions_us$_updated_unix
|integer
|UNIX time stamp when transactions_us$ value was last updated.
|-
|transactions_us$_updated_slt
|date
|time stamp when transactions_us$ value was last updated in Pacific Time.
|-
|-
|inworld
|inworld
|integer
|integer
|number of Resident accounts currently logged in; updated every 3 minutes
|Number of Resident accounts currently logged in. Updated every 3 minutes.
|-
|-
|inworld_updated_unix
|inworld_updated_unix
Line 140: Line 88:
|inworld_updated_slt
|inworld_updated_slt
|date
|date
|time stamp when inworld value was last updated in Pacific Time.
|Time stamp when inworld value was last updated in Pacific Time.
|}
|}


=== Text Feed ===
=== Text Feed ===
Newline-seperated key-value pairs, with timestamps (for [[llHttpRequest]]())
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).


:http://secondlife.com/httprequest/homepage.php
Example:


  signups_updated_slt
  signups_updated_slt
Line 154: Line 106:
  signups
  signups
  18072841
  18072841
logged60_updated_unix
1265097599
logged60_updated_slt
2010-02-01 23:59:59
logged60
1404640
  exchange_rate_updated_slt
  exchange_rate_updated_slt
  2010-02-02 01:03:28
  2010-02-02 01:03:28
Line 166: Line 112:
  exchange_rate
  exchange_rate
  262.2055
  262.2055
transactions_l$_updated_unix
1265101255
transactions_l$_updated_slt
2010-02-02 01:00:55
transactions_l$_freshness_slt
2010-02-02 01:00:55
transactions_l$_freshness_unix
1265101255
transactions_l$
787268477
  inworld_updated_unix
  inworld_updated_unix
  1265101209
  1265101209
Line 182: Line 118:
  inworld
  inworld
  38489
  38489
transactions_us$
3002486
transactions_us$_updated_unix
1265101408
transactions_us$_updated_slt
2010-02-02 01:03:28
transactions_us$_freshness_unix
1265101255
transactions_us$_freshness_slt
2010-02-02 01:00:55


== LindeX data feeds ==


; [[LLSD]]-formatted XML
{| style="border:1px solid #A3B1BF; text-align:left; background:#f5faff"
:http://secondlife.com/xmlhttp/lindex.php
|-
|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


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