Coinsplit API allows to create, edit, update Schemes and Shares by sendight HTTP requests to https://coinsplit.io/api/v1/
POST to /api/v1/schemes/ — create scheme
GET to /api/v1/schemes/ — get schemes list
GET to /api/v1/schemes/<id> — get scheme details
PATCH or PUT to /api/v1/schemes/<id> — change scheme
POST to /api/v1/shares/ — create share
GET to /api/v1/shares/ — get shares list
GET to /api/v1/shares/<id> — get share details
PATCH or PUT to /api/v1/shares/<id> — change share
This authentication scheme uses a simple token-based HTTP Authentication. For clients to authenticate, the token key should be included in the Authorization
HTTP header. The key should be prefixed by the string literal "Token", with whitespace separating the two strings. For example:
You can generate token in Profile.
You can test API calls right in the browser. Log in and open API endpoing. These pages allow for easy browsing of resources, as well as forms for submitting data to the resources.
The curl command line tool may be useful for testing token authenticated APIs. For example:
curl -X GET https://coinsplit.io/api/v1/schemes/ -H 'Authorization: Token 336249a06639907bb8b96171562e275970e9c6c5' { "count": 2, "next": null, "previous": null, "results": [ { "url": "https://coinsplit.io/api/v1/schemes/1/", "id": 1, "name": "test1", "currency": "TBTC", "address": "mfYcMrUA2UY39xe8RCuwtTU44Htb5ybL2p", "public": false, "payout_threshold": "0.00100", "pay_service_fee": true }, { "url": "https://coinsplit.io/api/v1/schemes/2/", "id": 2, "name": "test2", "currency": "TBTC", "address": "mgQi1TR5nsqBLa44E4z9ELWt2nPKZd2NnM", "public": false, "payout_threshold": "0.00100", "pay_service_fee": true } ] }
Create scheme
curl -X POST https://coinsplit.io/api/v1/schemes/ --data 'name=testSplit¤cy=BTC&public=false&payout_threshold=1&pay_service_fee=true' -H 'Authorization: Token 336249a06639907bb8b96171562e275970e9c6c5' { "url": "https://coinsplit.io/api/v1/schemes/100/", "id": 100, "name": "testSplit", "currency": "BTC", "public": false, "payout_threshold": "1.00000", "pay_service_fee": true }
Create share
curl -X POST https://coinsplit.io/api/v1/shares/ --data 'scheme=https://coinsplit.io/api/v1/schemes/100/&address=13sCjVmvNqEjNcBq5uDfNibrf2CKQ8QbtR&size=1&comment=test_comment' -H 'Authorization: Token 336249a06639907bb8b96171562e275970e9c6c5' { "url": "https://coinsplit.io/api/v1/shares/200/", "id": 200, "scheme": "https://coinsplit.io/api/v1/schemes/100/", "address": "13sCjVmvNqEjNcBq5uDfNibrf2CKQ8QbtR", "size": "1.00000", "comment": "test_comment" }