Remember
 
 
Most Discussed Coins  Most Discussed Coins / Tokens / Cryptocurrencies through Posts and Reactions on SpeculatingCoins  BCH  •  BTC  •  XLM  •  BTDX  •  ZEC  •  BNB  •  ETH  •  XRP  •  DASH  •  ADA

SpeculatingCoins Public API Documentation (Version 1)




Summary of End Points:


· All Coin Symbol Listings

· Individual Coin Symbols

· Sentiment

· UserStream

· Reactions

· SpecStream

· PulseStream

· DailyStream



Public API Endpoints:


1) All Coin Symbol Listings:

Endpoint: /allcoinsymbollistings/

Method: GET

Description: This endpoint displays all coin symbol listings in one call. For more specific data on an individual coin symbol, find the "id" field associated with the coin you'd like from this #1 Endpoint to use in the #2 "Coin Symbol" Endpoint below.

Example: https://speculatingcoins.com/api/v1/allcoinsymbollistings/

Sample Response for All Coin Symbol Listings Endpoint:


     
  	[{
		"id": 1,
		"crypto_name": "Bitcoin Cash",
		"crypto_symbol": "BCH",
		"symbol_url": "https://speculatingcoins.com/pulse/coin/BCH/"
	},
	{
		"id": 2,
		"crypto_name": "Ripple",
		"crypto_symbol": "XRP",
		"symbol_url": "https://speculatingcoins.com/pulse/coin/XRP/"
	}
	...
	]


 

PHP JSON_DECODE EXAMPLE FOR ALL COIN SYMBOL LISTINGS:


     
     	// A PHP example showing how to get data from All Coin Symbol Listings Endpoint: 

	$url = "https://speculatingcoins.com/api/v1/allcoinsymbollistings/";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc);
	
	$i = 0;
	foreach($json as $row){
	    $id[$i] = $row->id;
	    $crypto_name[$i] = $row->crypto_name;
	    $crypto_symbol[$i] = $row->crypto_symbol;
	    $symbol_url[$i] = $row->symbol_url;
		$i++;
	}
	
	$total = $i; 
	
	for($i = 0; $i < $total; $i++){
		echo  'ID of Coin Symbol: '.$id[$i].' | Name of Cryptocurrency: '.$crypto_name[$i].' | 
		Symbol of Cryptocurrency: '.$crypto_symbol[$i].' | 
		URL of Cryptocurrency Page on SpeculatingCoins: '.$symbol_url[$i].'<br/>';
	} 


 



2) Coin Symbol (Individual / Specific):

Endpoint: /coinsymbol/?id={id}

Method: GET

Description: This endpoint displays ticker data for a specific coin symbol. To find the "id" of the coin symbol you'd like, search for the coin you'd like and the associated the "id" field from the #1 "All Coin Symbol Listings" Endpoint above.

Example: https://speculatingcoins.com/api/v1/coinsymbol/?id=2
* This endpoint would return BTC data.

Sample Response for Coin Symbol Endpoint:


     
 	{
		"id": 2,
		"crytpo_name": "Ripple",
		"crypto_symbol": "XRP",
		"symbol_url": "https://speculatingcoins.com/pulse/coin/XRP/",
		"latest_post": "$XRP (Ripple) is up more than 5%, reaching a new upside threshold.",
		"latest_post_url": "https://speculatingcoins.com/pulse/current-movers-gainers/pulse.php?n=2110",
		"type_of_crypto": "Coin",
		"website": "https://ripple.com/xrp/",
		"profile": "Ripple (XRP) is a centralized solution with the goal of fulfilling enterprise grade use cases 
for monetary transactions. It poses as an innovative alternative to conventional means for cross border payments. Ripple
acts as a currency exchange, settlement system and remittance network. The system's technology appeals to institutional
clients as well as payment networks as settlement infrastructure.", "bs7am": "0", "'buys'": 0, "'sells'": 0, "last_updated": 1530230940 }

Sample Error Response for Coin Symbol Endpoint:


     
 
		"error": "id not found"
		


 

PHP JSON_DECODE EXAMPLE FOR COIN SYMBOL ENDPOINT:


     
	// A PHP example showing how to get data from Coin Symbol Endpoint: 


	$url = "https://speculatingcoins.com/api/v1/coinsymbol/?id=3";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc, true);
	
	$crypto_name = $json["crypto_name"];
	$crypto_symbol = $json["crypto_symbol"];
	$symbol_url = $json["symbol_url"];
	$latest_post = $json["latest_post"];
	$latest_post_url = $json["latest_post_url"];
	$type_of_crypto = $json["type_of_crypto"];
	$website = $json["website"];
	$profile = $json["profile"];
	$bs7am = $json["bs7am"];
	$buys = $json["'buys'"];
	$sells = $json["'sells'"];
	$last_updated = $json["last_updated"];
	
	echo  'Name of Cryptocurrency: '.$crypto_name.' | Symbol of Cryptocurrency: '.$crypto_symbol.' | 
	URL of Cryptocurrency Page on SpeculatingCoins: '.$symbol_url."\" | \"Latest Post\": \"".$latest_post."\" | 
	\"URL of Latest Post\": \"".$latest_post_url."\" | \"Cryptocurrency Type\": \"".$type_of_crypto."\" | 
	\"Website\": \"".$website."\" | \"Profile\": \"".$profile."\" | \"B/S Ratio Since 7 AM\": \"".$bs7am."\" | 
	\"'Buy' Sentiments\": ".$buys." | \"'Sell' Sentiments\": ".$sells." | \"Last Updated\": ".$last_updated.'<br/>';


 



3) Sentiment (Individual 'BUY' and 'SELL' SpecStream Posts):

Endpoint: /sentiment/

Method: GET

Description: This endpoint displays all SpecStream 'BUY' and 'SELL' SpecStream Posts ('BUY' and 'SELL' button actions on individual coins by users) in one call.

Example: https://speculatingcoins.com/api/v1/sentiment/

Sample Response for Sentiment Endpoint:


     
	 [{
		"post_id": 2747,
		"post_content": "russurban Placed a 'Buy' Sentiment on $BTC (Bitcoin)",
		"post_content_url": "https://speculatingcoins.com/pulse/userbuys/pulse.php?n=2747",
		"post_creation_time": 1530231656
	},
	{
		"post_id": 132,
		"post_content": "russurban Placed a 'Buy' Sentiment on $STORJ (Storj)",
		"post_content_url": "https://speculatingcoins.com/pulse/userbuys/pulse.php?n=132",
		"post_creation_time": 1520869396
	}
	...
	]


 

PHP JSON_DECODE EXAMPLE FOR SENTIMENT ENDPOINT:


     
	// A PHP example showing how to get data from Sentiment Endpoint: 

	$url = "https://speculatingcoins.com/api/v1/sentiment/";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc);
	
	$i = 0;
	foreach($json as $row){
	    $post_id[$i] = $row->post_id;
	    $post_content[$i] = $row->post_content;
	    $post_content_url[$i] = $row->post_content_url;
	    $post_creation_time[$i] = $row->post_creation_time;
		$i++;
	}
	
	$total = $i; 
	
	for($i = 0; $i < $total; $i++){
		echo  'ID of Sentiment Post: '.$post_id[$i].' | Post Content: '.$post_content[$i].' | 
		URL of Post: '.$post_content_url[$i].' | Post Creation Time: '.$post_creation_time[$i].'<br/>';
	} 


 



4) UserStream (Posts by Users and Anonymous Visitors):

Endpoint: /userstream/

Method: GET

Description: This endpoint displays last 100 posts by users and anonymous visitors in one call.

Example: https://speculatingcoins.com/api/v1/userstream/

Sample Response for UserStream Endpoint:


     
	 [{
		"post_id": 2746,
		"post_content": "$BTC looking good around November 12th, 2017 support, Facebook lifting cryptocurrency ad 
ban, and Coinbase
rumors. https://ind.pn/2IwibYz", "post_url": "https://speculatingcoins.com/pulse/russurban/pulse.php?n=2746", "author_name": "russurban", "full_author_name": "russurban", "buys_on_the_post": 0, "sells_on_the_post": 0, "buy_to_sell_ratio_of_author": "+5", "post_creation_time": 1530231651 }, { "post_id": 131, "post_content": "Former Docker CEO joining Storj ($STORJ) as Chair and Interim CEO https://www.yahoo.com/news/
former-docker-ceo-ben-golub-130010371.html", "post_url": "https://speculatingcoins.com/pulse/russurban/pulse.php?n=131", "author_name": "russurban", "full_author_name": "russurban", "buys_on_the_post": 1, "sells_on_the_post": 0, "buy_to_sell_ratio_of_author": "+5", "post_creation_time": 1520868753 } ... ]

PHP JSON_DECODE EXAMPLE FOR USERSTREAM ENDPOINT:


     
	// A PHP example showing how to get data from UserStream Endpoint: 

	$url = "https://speculatingcoins.com/api/v1/userstream/";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc);
	
	$i = 0;
	foreach($json as $row){
	    $post_id[$i] = $row->post_id;
	    $post_content[$i] = $row->post_content;
	    $post_url[$i] = $row->post_url;
	    $author_name[$i] = $row->author_name;
	    $full_author_name[$i] = $row->full_author_name;
	    $buys_on_the_post[$i] = $row->buys_on_the_post;
	    $sells_on_the_post[$i] = $row->sells_on_the_post;
	    $buy_to_sell_ratio_of_author[$i] = $row->buy_to_sell_ratio_of_author;
	    $post_creation_time[$i] = $row->post_creation_time;
		$i++;
	}
	
	$total = $i; 
	
	for($i = 0; $i < $total; $i++){
		echo  'ID of Post: '.$post_id[$i].' | Post Content: '.$post_content[$i].' | 
		URL of Post: '.$post_url[$i].' | Name of Author: '.$author_name[$i].' | 
		Full Name of Author: '.$full_author_name[$i].' | \'Buys\' on the Post: '.$buys_on_the_post[$i].' | 
		\'Sells\' on the Post: '.$sells_on_the_post[$i].' | 
		\'Buy\' to \'Sell\' Ratio of Author: '.$buy_to_sell_ratio_of_author[$i].' | 
		Post Creation Time: '.$post_creation_time[$i].'<br/>';
	} 


 



5) Reactions (User Replies to Any Post):

Endpoint: /reactions/

Method: GET

Description: This endpoint displays last 1000 reactions (user replies to any post) in one call.

Example: https://speculatingcoins.com/api/v1/reactions/

Sample Response for Reactions Endpoint:


     
 	[{
		"post_id_of_reply": 4,
		"reply_post_content": "$STORJ is integrated into FileZilla, Microsoft Azure, and other software packages. $STORJ could 
become the storage layer of the Internet.", "original_replied_to_post_url": "https://speculatingcoins.com/pulse/russurban/pulse.php?n=131", "author_name": "russurban", "full_author_name": "russurban", "buys_on_the_post": 1, "sells_on_the_post": 0, "buy_to_sell_ratio_of_author": "+5", "post_creation_time": 1520869182 }, { "post_id_of_reply": 3, "reply_post_content": "Anybody can make their hard drive space available to Storj for $STORJ tokens as compensation.
70k+ ppl doing just that.", "original_replied_to_post_url": "https://speculatingcoins.com/pulse/russurban/pulse.php?n=131", "author_name": "russurban", "full_author_name": "russurban", "buys_on_the_post": 0, "sells_on_the_post": 0, "buy_to_sell_ratio_of_author": "+5", "post_creation_time": 1520869068 } ... ]

PHP JSON_DECODE EXAMPLE FOR REACTIONS ENDPOINT:


     
     // A PHP example showing how to get data from Reactions Endpoint: 

	$url = "https://speculatingcoins.com/api/v1/reactions/";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc);
	
	$i = 0;
	foreach($json as $row){
	    $post_id_of_reply[$i] = $row->post_id_of_reply;
	    $reply_post_content[$i] = $row->reply_post_content;
	    $original_replied_to_post_url[$i] = $row->original_replied_to_post_url;
	    $author_name[$i] = $row->author_name;
	    $full_author_name[$i] = $row->full_author_name;
	    $buys_on_the_post[$i] = $row->buys_on_the_post;
	    $sells_on_the_post[$i] = $row->sells_on_the_post;
	    $buy_to_sell_ratio_of_author[$i] = $row->buy_to_sell_ratio_of_author;
	    $post_creation_time[$i] = $row->post_creation_time;
		$i++;
	}
	
	$total = $i; 
	
	for($i = 0; $i < $total; $i++){
		echo  'ID of Reply Post: '.$post_id_of_reply[$i].' | Reply Post Content: '.$reply_post_content[$i].' | 
		URL of Original Post Replied To: '.$original_replied_to_post_url[$i].' | Name of Author: '.$author_name[$i].' | 
		Full Name of Author: '.$full_author_name[$i].' | \'Buys\' on the Post: '.$buys_on_the_post[$i].' | 
		\'Sells\' on the Post: '.$sells_on_the_post[$i].' | 
		\'Buy\' to \'Sell\' Ratio of Author: '.$buy_to_sell_ratio_of_author[$i].' | 
		Post Creation Time: '.$post_creation_time[$i].'<br/>';
	} 


 



6) SpecStream (Posts Generated by SpecStream Data Components):

Endpoint: /specstream/

Method: GET

Description: This endpoint displays last 150 SpecStream posts (generated by SpecStream data components) in one call.

Example: https://speculatingcoins.com/api/v1/specstream/

Sample Response for SpecStream Endpoint:


     
 	[{
		"post_id": 2777,
		"post_content": "$NEOG (NEO GOLD) is down more than 20%, reaching a new downside threshold.",
		"post_url": "https://speculatingcoins.com/pulse/current-movers-decliners/pulse.php?n=2777",
		"component_name": "current-movers-decliners",
		"full_component_name": "Current Movers - Decliners",
		"buys_on_the_post": 0,
		"sells_on_the_post": 0,
		"buy_to_sell_ratio": "0",
		"post_creation_time": 1530493658
	},
	{
		"post_id": 2776,
		"post_content": "$LIFE (LIFE) is down more than 10%, reaching a new downside threshold.",
		"post_url": "https://speculatingcoins.com/pulse/current-movers-decliners/pulse.php?n=2776",
		"component_name": "current-movers-decliners",
		"full_component_name": "Current Movers - Decliners",
		"buys_on_the_post": 0,
		"sells_on_the_post": 0,
		"buy_to_sell_ratio": "0",
		"post_creation_time": 1530488767
	}
	...
	]


 

PHP JSON_DECODE EXAMPLE FOR SPECSTREAM ENDPOINT:


          
	// A PHP example showing how to get data from SpecStream Endpoint: 
	
	$url = "https://speculatingcoins.com/api/v1/specstream/";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc);
	
	$i = 0;
	foreach($json as $row){
	    $post_id[$i] = $row->post_id;
	    $post_content[$i] = $row->post_content;
	    $post_url[$i] = $row->post_url;
	    $component_name[$i] = $row->component_name;
	    $full_component_name[$i] = $row->full_component_name;
	    $buys_on_the_post[$i] = $row->buys_on_the_post;
	    $sells_on_the_post[$i] = $row->sells_on_the_post;
	    $buy_to_sell_ratio_of_author[$i] = $row->buy_to_sell_ratio;
	    $post_creation_time[$i] = $row->post_creation_time;
		$i++;
	}
	
	$total = $i; 
	
	for($i = 0; $i < $total; $i++){
		echo  'ID of Post: '.$post_id[$i].' | Post Content: '.$post_content[$i].' | 
		URL of Post: '.$post_url[$i].' | Name of SpecStream Component: '.$component_name[$i].' | 
		Full Name of SpecStream Component: '.$full_component_name[$i].' | \'Buys\' on the Post: '.$buys_on_the_post[$i].' | 
		\'Sells\' on the Post: '.$sells_on_the_post[$i].' | 
		\'Buy\' to \'Sell\' Ratio of Author: '.$buy_to_sell_ratio_of_author[$i].' | 
		Post Creation Time: '.$post_creation_time[$i].'<br/>';
	} 	


 



7) PulseStream (Posts Including UserStream and SpecStream Posts):

Endpoint: /pulsestream/

Method: GET

Description: This endpoint displays last 100 posts (including UserStream and SpecStream Posts) in one call.

Example: https://speculatingcoins.com/api/v1/pulsestream/

Sample Response for PulseStream Endpoint:


     
 	[{
		"post_id": 2777,
		"post_content": "$NEOG (NEO GOLD) is down more than 20%, reaching a new downside threshold.",
		"post_url": "https://speculatingcoins.com/pulse/current-movers-decliners/pulse.php?n=2777",
		"author_name": "current-movers-decliners",
		"full_author_name": "Current Movers - Decliners",
		"user_post": "FALSE",
		"buys_on_the_post": 0,
		"sells_on_the_post": 0,
		"buy_to_sell_ratio_of_author": "0",
		"post_creation_time": 1530493658
	},
	{
		"post_id": 2776,
		"post_content": "$LIFE (LIFE) is down more than 10%, reaching a new downside threshold.",
		"post_url": "https://speculatingcoins.com/pulse/current-movers-decliners/pulse.php?n=2776",
		"author_name": "current-movers-decliners",
		"full_author_name": "Current Movers - Decliners",
		"user_post": "FALSE",
		"buys_on_the_post": 0,
		"sells_on_the_post": 0,
		"buy_to_sell_ratio_of_author": "0",
		"post_creation_time": 1530488767
	}
	...
	]


 

PHP JSON_DECODE EXAMPLE FOR PULSESTREAM ENDPOINT:


     
	// A PHP example showing how to get data from PulseStream Endpoint: 

	$url = "https://speculatingcoins.com/api/v1/pulsestream/";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc);
	
	$i = 0;
	foreach($json as $row){
	    $post_id[$i] = $row->post_id;
	    $post_content[$i] = $row->post_content;
	    $post_url[$i] = $row->post_url;
	    $author_name[$i] = $row->author_name;
	    $full_author_name[$i] = $row->full_author_name;
	    $user_post[$i] = $row->user_post;
	    $buys_on_the_post[$i] = $row->buys_on_the_post;
	    $sells_on_the_post[$i] = $row->sells_on_the_post;
	    $buy_to_sell_ratio_of_author[$i] = $row->buy_to_sell_ratio_of_author;
	    $post_creation_time[$i] = $row->post_creation_time;
		$i++;
	}
	
	$total = $i; 
	
	for($i = 0; $i < $total; $i++){
		echo  'ID of Post: '.$post_id[$i].' | Post Content: '.$post_content[$i].' | 
		URL of Post: '.$post_url[$i].' | Name of Author: '.$author_name[$i].' | 
		Full Name of Author: '.$full_author_name[$i].' | User Post: '.$user_post[$i].' | 
		\'Buys\' on the Post: '.$buys_on_the_post[$i].' | \'Sells\' on the Post: '.$sells_on_the_post[$i].' | 
		\'Buy\' to \'Sell\' Ratio of Author: '.$buy_to_sell_ratio_of_author[$i].' | 
		Post Creation Time: '.$post_creation_time[$i].'<br/>';
	} 


 



8) DailyStream (Posts Last 24-Hours):

Endpoint: /dailystream/

Method: GET

Description: This endpoint displays all posts over the last 24-hrs in one call.

Example: https://speculatingcoins.com/api/v1/dailystream/

Sample Response for DailyStream Endpoint:


     
 	[{
		"post_id": 2777,
		"post_content": "$NEOG (NEO GOLD) is down more than 20%, reaching a new downside threshold.",
		"post_url": "https://speculatingcoins.com/pulse/current-movers-decliners/pulse.php?n=2777",
		"author_name": "current-movers-decliners",
		"full_author_name": "Current Movers - Decliners",
		"user_post": "FALSE",
		"buys_on_the_post": 0,
		"sells_on_the_post": 0,
		"buy_to_sell_ratio_of_author": "0",
		"post_creation_time": 1530493658
	},
	{
		"post_id": 2776,
		"post_content": "$LIFE (LIFE) is down more than 10%, reaching a new downside threshold.",
		"post_url": "https://speculatingcoins.com/pulse/current-movers-decliners/pulse.php?n=2776",
		"author_name": "current-movers-decliners",
		"full_author_name": "Current Movers - Decliners",
		"user_post": "FALSE",
		"buys_on_the_post": 0,
		"sells_on_the_post": 0,
		"buy_to_sell_ratio_of_author": "0",
		"post_creation_time": 1530488767
	}
	...
	]


 

PHP JSON_DECODE EXAMPLE FOR DAILYSTREAM ENDPOINT:


     
	// A PHP example showing how to get data from DailyStream Endpoint: 
	
	$url = "https://speculatingcoins.com/api/v1/dailystream/";
	$fgc = file_get_contents($url);
	$json = json_decode($fgc);
	
	$i = 0;
	foreach($json as $row){
	    $post_id[$i] = $row->post_id;
	    $post_content[$i] = $row->post_content;
	    $post_url[$i] = $row->post_url;
	    $author_name[$i] = $row->author_name;
	    $full_author_name[$i] = $row->full_author_name;
	    $user_post[$i] = $row->user_post;
	    $buys_on_the_post[$i] = $row->buys_on_the_post;
	    $sells_on_the_post[$i] = $row->sells_on_the_post;
	    $buy_to_sell_ratio_of_author[$i] = $row->buy_to_sell_ratio_of_author;
	    $post_creation_time[$i] = $row->post_creation_time;
		$i++;
	}
	
	$total = $i; 
	
	for($i = 0; $i < $total; $i++){
		echo  'ID of Post: '.$post_id[$i].' | Post Content: '.$post_content[$i].' | 
		URL of Post: '.$post_url[$i].' | Name of Author: '.$author_name[$i].' | 
		Full Name of Author: '.$full_author_name[$i].' | User Post: '.$user_post[$i].' | 
		\'Buys\' on the Post: '.$buys_on_the_post[$i].' | \'Sells\' on the Post: '.$sells_on_the_post[$i].' | 
		\'Buy\' to \'Sell\' Ratio of Author: '.$buy_to_sell_ratio_of_author[$i].' | 
		Post Creation Time: '.$post_creation_time[$i].'<br/>';
	} 


 



Notes:


Timestamps:

All 'last_updated' and 'timestamp' fields are unix timestamps.



Limits:

We ask that you please limit requests to no more than 60 / minute.

All Coin Symbol Listings (#1 above), Reactions (#5), DailyStream (#8) Endpoints Update Every 5 minutes.

Userstream (#4), SpecStream (#6), PulseStream (#7) Endpoints Update Every 2 minutes.

Coin Symbol (#2 above) Endpoint is Always Up to Date.

Sentiment (#3 above) Endpoint is Always Up to Date.



Terms of Use:

By accessing our Public API, you agree to be bound to our Terms of Use.



Documentation Last Changed:

July 19, 2018