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)
 
(11 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}}
 
__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 13: 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 26: 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 61: 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 95: 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 103: 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 139: 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.
|}
|}


Line 145: Line 94:
Newline-seperated key-value pairs, with timestamps (for [[llHTTPRequest]]())
Newline-seperated key-value pairs, with timestamps (for [[llHTTPRequest]]())


:http://secondlife.com/httprequest/homepage.php
: 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).
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).
Line 157: 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 169: 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 185: 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




Line 205: Line 128:
|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.
|-
|-
|signups_updated_unix
|signups_updated_unix
Line 213: Line 136:
|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.
|-
|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.
|-
|logged60
|integer
|number of Resident accounts that have logged in in the past 60 days; updated daily
|-
|-
|exchange_rate_updated_slt
|exchange_rate_updated_slt
|date
|date
|time stamp when exchange_rate value was last updated in Pacific Time.
|Time stamp when exchange_rate value was last updated in Pacific Time.
|-
|-
|exchange_rate_updated_unix
|exchange_rate_updated_unix
Line 238: Line 149:
|float
|float
|Average number of L$ that 1 US$ can purchase.
|Average number of L$ that 1 US$ can purchase.
|-
|transactions_l$_updated_unix
|integer
|UNIX time stamp when transactions_l$ value was last updated.
|-
|transactions_l$_updated_slt
|date
|time stamp when transactions_l$ value was last updated in Pacific Time.
|-
|transactions_l$_freshness_slt
|date
|time stamp when transactions_l$ value was last updated in Pacific Time.
|-
|transactions_l$_freshness_unix
|integer
|UNIX time stamp when transactions_l$ value was last updated.
|-
|transactions_l$
|integer
|amount of L$ traded as resident-to-resident transactions for past 24 hours; updated every 30 minutes
|-
|-
|inworld_updated_unix
|inworld_updated_unix
Line 265: Line 156:
|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.
|-
|-
|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.
|-
|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.
|-
|transactions_us$_freshness_unix
|integer
|UNIX time stamp when transactions_us$ value was last updated.
|-
|transactions_us$_freshness_slt
|date
|time stamp when transactions_us$ value was last updated in Pacific Time.
|}
|}


== LindeX data feeds ==  
== LindeX ==  


=== [[LLSD]] feed ===
=== [[LLSD]] feed ===


:http://secondlife.com/xmlhttp/lindex.php
: 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 ===
=== Text feed ===
Line 302: Line 320:
Newline-separated key-value pairs for [[llHTTPRequest]]()
Newline-separated key-value pairs for [[llHTTPRequest]]()


:http://secondlife.com/httprequest/lindex.php
: 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.


[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