Intersango/API: Difference between revisions

From Bitcoin Wiki
Jump to navigation Jump to search
No edit summary
(Undo revision 22557 by Phantomcircuit (talk))
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
=== common information ===
To maintain backwards compatibility the following britcoin.co.uk urls are rewritten
{| class="wikitable"
|-
|----
|/api/ticker.php
|/api/ticker.php?currency_pair_id=1
|----
|/api/ticker
|/api/ticker.php?currency_pair_id=1
|----
|/api/getTrades.php
|/api/trades.php?currency_pair_id=1
|----
|/api/getTrades
|/api/trades.php?currency_pair_id=1
|----
|/api/getDepth.php
|/api/depth.php?currency_pair_id=1
|----
|/api/getDepth
|/api/depth.php?currency_pair_id=1
|}
On error a json dictionary will be returned with 'error' set to the error.
Example {'error':'missing api key'}
=== Data API ===
currency_pair_id is an optional GET parameter to all data api calls
currency_pair_id is an optional GET parameter to all data api calls
* 1 = BTC:GBP
* 1 = BTC:GBP
* 2 = BTC:EUR
* 2 = BTC:EUR
* 3 = BTC:USD
* 3 = BTC:USD
* 4 = BTC:PLN
{| class="wikitable"
|-
! URL !! Description !! Parameters !! Return Values
|----
| https://intersango.com/api/ticker.php
|
|
|
|----
| https://intersango.com/api/trades.php
|
|
Filters
* currency_pair_id
* last_trade_id
* last_trade_time
| if currency_pair_id not specified the return value is a dict indexed by the currency pair ids<br/>
if currency_pair_id is specified than an array is returned
|----
| https://intersango.com/api/depth.php
|
|
|
|}
=== Authenticated API ===
== Version 0.1 ==
All API calls are POST and must include the api key as api_key
All return values are json encoded.  All decimal values are sent as strings.
The base url for all calls is
https://intersango.com/api/authenticated/v0.1/
{| class="wikitable"
|-
! Relative URL !! Description !! Parameters !! Return Values
|----
|listAccounts.php
|Accounts.
|No parameters.
|array of accounts
*id
*balance
*outstanding_total
*currency_abbreviation
*currency_id
*reference_code
|----
|listOrders.php
|List orders for an account.
|account_id
|array of orders
*id
*selling
*rate
*quantity
*outstanding
*base_account_id
*quote_account_id
*currency_pair_id
*fulfilled
*placed
*processed
*expire
*cancelled
*partial
*immediate
|----
|listDeposits.php
|Deposits for an account
|account_id
|array of deposits
*account_id
*amount
*deposit_id
|----
|listWithdrawalRequests.php
|Withdraws for an account.
|account_id
|array of withdrawal request
|----
|placeLimitOrder.php
|Place limit order.
|
* quantity
* rate
* selling "true" or "false"
* base_account_id
* quote_account_id
| order_id
|----
|requestCancelOrder.php
|Request that an order be cancelled.
Orders are not guaranteed to have been cancelled<br>
until the cancelled property of the order is the time it was cancelled.
|account_id order_id
|dict with 'result' set to 'success'
|----
|cancelWithdrawalRequest.php
|Cancel request to withdrawal funds
|account_id withdrawal_request_id
|dict with 'result' set to 'success'
|}


* https://intersango.com/api/ticker.php
===Withdrawing and Depositing===
* https://intersango.com/api/trades.php
Withdrawing and depositing BTC is not possible using the official API, but it is possible by impersonating a web-browser. See [[Ad-hoc transfers]]
* https://intersango.com/api/depth.php

Latest revision as of 23:37, 6 April 2014

common information

To maintain backwards compatibility the following britcoin.co.uk urls are rewritten

/api/ticker.php /api/ticker.php?currency_pair_id=1
/api/ticker /api/ticker.php?currency_pair_id=1
/api/getTrades.php /api/trades.php?currency_pair_id=1
/api/getTrades /api/trades.php?currency_pair_id=1
/api/getDepth.php /api/depth.php?currency_pair_id=1
/api/getDepth /api/depth.php?currency_pair_id=1


On error a json dictionary will be returned with 'error' set to the error.

Example {'error':'missing api key'}

Data API

currency_pair_id is an optional GET parameter to all data api calls

  • 1 = BTC:GBP
  • 2 = BTC:EUR
  • 3 = BTC:USD
  • 4 = BTC:PLN
URL Description Parameters Return Values
https://intersango.com/api/ticker.php
https://intersango.com/api/trades.php

Filters

  • currency_pair_id
  • last_trade_id
  • last_trade_time
if currency_pair_id not specified the return value is a dict indexed by the currency pair ids

if currency_pair_id is specified than an array is returned

https://intersango.com/api/depth.php

Authenticated API

Version 0.1

All API calls are POST and must include the api key as api_key

All return values are json encoded. All decimal values are sent as strings.

The base url for all calls is https://intersango.com/api/authenticated/v0.1/

Relative URL Description Parameters Return Values
listAccounts.php Accounts. No parameters. array of accounts
  • id
  • balance
  • outstanding_total
  • currency_abbreviation
  • currency_id
  • reference_code
listOrders.php List orders for an account. account_id array of orders
  • id
  • selling
  • rate
  • quantity
  • outstanding
  • base_account_id
  • quote_account_id
  • currency_pair_id
  • fulfilled
  • placed
  • processed
  • expire
  • cancelled
  • partial
  • immediate
listDeposits.php Deposits for an account account_id array of deposits
  • account_id
  • amount
  • deposit_id
listWithdrawalRequests.php Withdraws for an account. account_id array of withdrawal request
placeLimitOrder.php Place limit order.
  • quantity
  • rate
  • selling "true" or "false"
  • base_account_id
  • quote_account_id
order_id
requestCancelOrder.php Request that an order be cancelled.

Orders are not guaranteed to have been cancelled
until the cancelled property of the order is the time it was cancelled.

account_id order_id dict with 'result' set to 'success'
cancelWithdrawalRequest.php Cancel request to withdrawal funds account_id withdrawal_request_id dict with 'result' set to 'success'

Withdrawing and Depositing

Withdrawing and depositing BTC is not possible using the official API, but it is possible by impersonating a web-browser. See Ad-hoc transfers