Charitycoin is an open, crowd-sourced index of registered 501(c)(3) nonprofits and their Bitcoin addresses.
View the current list of nonprofits in the dist directory.
The orgs directory contains JSON files for nonprofits. Each nonprofit has its own file, and includes at a minimum the organization's EIN, its bitcoin address and a "confirmation" URL that contains the address. The confirmation URL is usually a page on the organization's site.
For example, the .json file describing the Apache Foundation, looks like this:
{
"ein": "41-6031039",
"name" : "APACHE FOUNDATION",
"payments" : {
"bitcoin" : {
"address" : "1BtjAzWGLyAavUkbw3QsyzzNDKdtPXk95D",
"confirmation" : "http://www.apache.org/foundation/contributing.html"
}
}
}
A simple python script, test.py grabs the markup from the url listed in the "confirmation" field in each entry. The script checks that the address is present in the markup. For the moment, I manually check that the organization's domain name matches the one listed on guidestar. TravisCI runs the script. If there's a missmatch, the build will be labeled as "failing". There may be better ways to do this.
Another simple python script json2mongo.py, takes the argument of a config file (see the sample in the config directory, and creates a collection called "orgs" in the given MongoDB database with all the data in the orgs directory.
Exporting from MongoDB is extremely easy. I run mongoexport --jsonArray --pretty -h ds061371.mongolab.com:61371 -d nonprofits -c orgs -u <username> -p <password> -o dist/all.json to export all the records as a single, pretty-printed JSON array.
There are 1.2 million nonprofits and this index contains a lot less than that. If you know of an organization that accepts bitcion but is not indexed, please open an issue or a pull request.
Also, I welcome any feedback, in the form of messages, issues, and the like. I think this is an important problem to solve, but I'm open to the idea that there are better ways to solve it.
Special thanks to the Machinecoin Project!