Available Commands
Crypto Currency Prices
Returns the latest prices for 1000+ crypto currencies.
Example Request
$ curl cli.fyi/BTC
Example Response
{
"type": "Bitcoin (BTC) Prices",
"data": {
"USD ($)": 7299.97,
"EUR (€)": 6338.15,
"GBP (£)": 5636.17,
"AUD ($)": 9642.69,
"CAD ($)": 9415.97,
"BRL (R$)": 24559.16,
"CHF (CHF)": 7528.65,
"CLP ($)": 4675371.21,
"CNY (¥)": 51398.69,
"DKK (kr)": 51231.61,
"HKD ($)": 57194.57,
"INR (₹)": 490045.94,
"ISK (kr)": 843540.55,
"JPY (¥)": 833628.57,
"KRW (₩)": 8250226.92,
"NZD ($)": 12189.99,
"PLN (zł)": 26717.84,
"RUB (RUB)": 416001.11,
"SEK (kr)": 60000.02,
"SGD ($)": 10016.97,
"THB (฿)": 230183.34,
"TWD (NT$)": 219596.24
}
}
BTC can be replaced with almost any crypto currency symbol. Data is provided by CryptoCompare.com.
Email Address Information
Returns information about an email address.
Example Request
$ curl cli.fyi/john.doe@10minutemail.com
Example Response
{
"type": "Email Query",
"data": {
"validMxRecords": true,
"freeProvider": false,
"disposableEmail": true,
"businessOrRoleEmail": false,
"validHost": true
}
}
IP Address Information
Returns geo-location and ASN/Organisation information related to an IP address.
Example Request
$ curl cli.fyi/8.8.8.8
Example Response
{
"type": "IP Address",
"data": {
"organisation": "Google Inc.",
"country": "United States",
"countryCode": "US",
"city": "Mountain View, California",
"continent": "North America",
"latitude": "37.751",
"longitude": "-97.822"
}
}
Media/URL Information
Returns detailed information about virtually any URL. Supports extracting data from oEmbed, TwitterCards, OpenGraph, LinkPulse, Sailthru Meta-data, HTML and Dublin Core.
Example Request
$ curl cli.fyi/https://vimeo.com/231191863
Example Response
{
"type": "Vimeo Url",
"data": {
"title": "Low Earth Orbit",
"description": "Orbital drone movements are theorbits...",
"url": "https://vimeo.com/231191863",
"type": "video",
"tags": "Drone",
"image": "https://i.vimeocdn.com/video/651947838_640.jpg",
"imageWidth": 640,
"imageHeight": 360,
"code": "[embed code...]",
"width": 640,
"height": 360,
"authorName": "Visual Suspect",
"authorUrl": "https://vimeo.com/vsuspect",
"providerName": "Vimeo",
"providerUrl": "https://vimeo.com/",
.......
}
Client Information
Returns information about the person/machine making the request.
Example Request
$ curl cli.fyi/me
Example Response
{
"type": "Client Query",
"data": {
"userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/62.0.3202.75 Safari/537.36",
"iPAddress": "109.255.10.10",
"browser": "Chrome Dev 62.0.3202.75",
"operatingSystem": "Linux",
"iPAddressInformation": {
"organisation": "Liberty Global Operations B.V.",
"country": "Ireland",
"countryCode": "IE",
"city": "Dublin",
"continent": "Europe",
"latitude": "53.3472",
"longitude": "-6.2439"
}
}
}
Domain Whois / DNS information
Returns whois and DNS information for a given domain.
Example Request
$ curl cli.fyi/github.com
Example Response
{
"type": "Domain Name",
"data": {
"dns": [
"github.com. 3600 IN MX 5 ALT2.ASPMX.L.GOOGLE.com.",
"github.com. 3600 IN MX 5 ALT1.ASPMX.L.GOOGLE.com.",
"github.com. 40 IN A 192.30.253.113",
"github.com. 40 IN A 192.30.253.112",
"github.com. 651 IN NS ns-520.awsdns-01.net.",
"github.com. 651 IN NS ns-421.awsdns-52.com.",
"github.com. 651 IN NS ns-1283.awsdns-32.org.",
"github.com. 900 IN SOA ns-1707.awsdns-21.co.uk. awsdns-hostmaster.amazon.com. (",
" 1 ; serial",
" 7200 ; refresh (2 hours)",
" 900 ; retry (15 minutes)",
" 1209600 ; expire (2 weeks)",
" 86400 ; minimum (1 day)",
" )",
"github.com. 2350 IN TXT \"docusign=087098e3-3d46-47b7-9b4e-8a23028154cd\"",
"github.com. 2350 IN TXT \"v=spf1 ip4:192.30.252.0/22 ip4:208.74.204.0/22 ip4:46.19.168.0/23 include:_spf.google.com include:esp.github.com include:_spf.createsend.com include:mail.zendesk.com include:servers.mcsv.net ~all\""
],
"whois": [
"Domain Name: GITHUB.COM",
"Registry Domain ID: 1264983250_DOMAIN_COM-VRSN",
"Registrar WHOIS Server: whois.markmonitor.com",
"Registrar URL: http://www.markmonitor.com",
....
]
}
}
String Hash Values
Returns various hash values for a given string.
Example Request
$ curl cli.fyi/hash/HelloWorld
Example Response
{
"type": "String Hash Values",
"data": {
"md2": "74655651e01700a25fff9c0127382098",
"md4": "f4e0ffdf5d6d530edb234b381805efc1",
"md5": "292e4a0acc0fb7179dcf58ef02cc2f76",
"sha1": "65cc79bfae2cf9f63475727ee35fd5b4fedeed38",
"sha224": "6a89b325fe53d631a92a75ba43ee8829d686cf135f129af24f9de0ba",
"sha256": "ddec6733cd3fd3fe0ffd13bb477cc28220e8fdbafb217eb16b586af2ea9baa8f",
"sha384": "c83fcbc94b784da0f3223e2c6c69dbc610de24697f7fe26597705af3b946a1dc8d8dcc7aca349579fbea8abab7ecd148",
"sha512/224": "5177294c0c14d3fd34672bb4cad4de3a82454247fcdb1b4b6800c4e6",
"sha512/256": "e373b3e9a3600b5bd7b9609fd0c0fd3cc47e192c0525cff7b197b683bc2b04f0",
.................
}
}
Available Hashes: md2, md4, md5, sha1, sha224, sha256, sha384, sha512/224, sha512/256, sha512, sha3-224, sha3-256, sha3-384, sha3-512, ripemd128, ripemd160, ripemd256, ripemd320, whirlpool, tiger128,3, tiger160,3, tiger192,3, tiger128,4, tiger160,4, tiger192,4, snefru, snefru256, gost, gost-crypto, adler32, crc32, crc32b, fnv132, fnv1a32, fnv164, fnv1a64, joaat, haval128,3, haval160,3, haval192,3, haval224,3, haval256,3, haval128,4, haval160,4, haval192,4, haval224,4, haval256,4, haval128,5, haval160,5, haval192,5, haval224,5, haval256,5
Date/Time Information
Returns information about the current UTC date and time.
Example Request
$ curl cli.fyi/time
Example Response
{
"type": "Date/Time Information (UTC)",
"data": {
"day": "03",
"month": "11",
"year": "2017",
"hour": "16",
"minutes": "11",
"seconds": "22",
"dayName": "Friday",
"MonthName": "November",
"amOrPm": "pm",
"unixEpoch": 1509728122,
"formattedDate": "Fri, 03 Nov 2017 16:55:22 +0000"
}
}
Programming Language Links
Returns useful and up-to-date links for programming languages.
PHP, Javascript & Java currently supported.
Example Request
$ curl cli.fyi/PHP
Example Response
{
"type": "PHP Query",
"data": {
"documentation": "http://php.net/docs.php",
"links": {
"Awesome PHP": "https://github.com/ziadoz/awesome-php",
"PHP The Right Way": "http://www.phptherightway.com",
"Docker Repository": "https://hub.docker.com/_/php/",
"PHP Fig": "http://www.php-fig.org/",
"PHP Security": "http://phpsecurity.readthedocs.io/en/latest/index.html"
}
}
}
Country Information
Returns useful information about a given country.
Example Request
$ curl cli.fyi/united-states
Example Response
{
"type": "Country Query",
"data": {
"commonName": "United States",
"officialName": "United States of America",
"topLevelDomain": ".us",
"currency": "USD",
"callingCode": "+1",
"capitalCity": "Washington D.C.",
"region": "Americas",
"subRegion": "Northern America",
"latitude": 38,
"longitude": -97,
"demonym": "American",
"isLandlocked": "No",
"areaKm": 9372610,
"officialLanguages": "English"
}
}
Popular Emojis
Returns a selection of popular unicode emojis.
Example Request
$ curl cli.fyi/emojis
Example Response
{
"type": "Emoji",
"data": {
"huggingFace": "🤗",
"tearsOfJoy": "😂",
"grinningFace": "😀",
"rofl": "🤣",
"smiling": "😊",
"tongueOut": "😋",
"kissingFace": "😘",
"thinking": "🤔",
"neutralFace": "😐"
}
}
Help
Returns all possible query types and example queries.
Example Request
$ curl cli.fyi/help
Example Response
{
"type": "Help",
"data": {
"IP Address Query": {
"example": "https://cli.fyi/8.8.8.8"
},
"Media/Url Query": {
"example": "https://cli.fyi/https://google.com"
},
"Email Address Query": {
"example": "https://cli.fyi/test@10minutemail.com"
},
"Client (you) Query": {
"example": "https://cli.fyi/me"
},
...
}
}
General Information
FAQ
Why?
cli.fyi's goal is to create a quick an easy way to fetch information about IPs, emails, domains etc. directly from the command line.
Colourised Output?
Unfortunately Curl currently doesn't support colourised output1. HTTPie is a good alternative which does support colour output.
The JSON-Formatter Chrome extension is a good solution for in-browser JSON formatting.
Rate Limits?
There are no rate limits, however we will block any IP which is abusing the service. If you need to make a significant number of requests you can always host your own version.
Who?
cli.fyi is developed by Dave Earley
1 To the best of my knowledge, please correct me if I'm wrong.
Credits
Data
Cli.fyi relies on the following services & projects for its data:
Hosting
Cli.fyi is hosted by Linode .
Terms of Service
Cli.fyi is provided as-is. Cli.fyi makes no guarantees about the quality of the service or the accuracy of data provided by the service.