Chimere - API

Welcome to Chimere sanctuary! Hope you will build beautiful and functional interfaces with this API!

This API allows you to interact with Chimere - Crypto swap and use our service to allows your users to exchange crypto-to-crypto easily, fast and secure. When your integration is ready, please drop us a message at developer@chimere.io. We will create you an API KEY to use our service and you will get 60% of our total fees by orders you make through your API KEY.

https://chimere.io/api/v2/create-order?api_key=YOUR_API_KEY

get
Get currencies

https://chimere.io/api/v2/get-currencies
This endpoint allows you to retrieve all our supported currencies by symbol/ticker
Request
Response
Request
Response
200: OK
Assets successful retrieved
{
assets:[
{
ticker: 'BAT',
protocol: 'ERC20',
img_url: 'https://etherscan.io/token/images/bat.png',
currency: 'Basic Attention Token',
active: 'true',
},
{...},
{...}
]
}
404: Not Found
{error: "Unable to retrieve currencies"}

post
Get limits

https://chimere.io/api/v2/get-limits
This endpoint allows you to retrieve limits min and max for crypto-to-crypto pair
Request
Response
Request
Body Parameters
deposit_ticker
required
string
Ticker/symbol of the currency to exchange
destination_ticker
required
string
Ticker/symbol of the currency to receive after exchange
Response
200: OK
Limit successful retrieved
{
deposit_ticker: 'eth',
destination_ticker: 'btc',
min: 0.01,
max: 195
}
404: Not Found
{ error: 'pair is unavailable for exchanges'

Example

{
deposit_ticker: 'eth',
destination_ticker: 'btc'
}

post
Get estimate

https://chimere.io/api/v2/get-estimate
This endpoints allows you to get an estimate price you will receive after the exchange
Request
Response
Request
Body Parameters
deposit_ticker
required
string
Ticker/symbol of the currency to exchange
destination_ticker
required
string
Ticker/symbol of the currency to receive after exchange
deposit_amount
required
number
Amount of the currency to exchange
Response
200: OK
Estimate successful retrieved
{
deposit_ticker: 'eth',
destination_ticker: 'btc',
deposit_amount: 1.32,
destination_amount: 0.2
}
404: Not Found
{error: 'pair is unavailable for exchanges'}

Example

{
deposit_ticker: 'eth',
destination_ticker: 'btc',
deposit_amount: 1.32
}

post
Create order

https://chimere.io/api/v2/create-order
This endpoint allows you to create a new order
Request
Response
Request
Body Parameters
owner
optional
string
The unique owner of this order
message_id
optional
string
Extra id to be attached in message transaction
deposit_ticker
required
string
Ticker/symbol of the currency to exchange
destination_ticker
required
string
Ticker/symbol of the currency to receive after exchange
deposit_amount
required
number
Amount of the currency to exchange
destination_address
required
string
Destination address of the currency to receive after exchange
refund_address
optional
string
Address to refund in case order fail
Response
200: OK
Order successful created
{
owner:'chimere',
state: 'unpaid',
deposit_ticker: 'eth',
destination_ticker: 'btc',
order_id: 'xo12345',
destination_address: '1bc...',
deposit_address: '0x...',
message_id: '12345',
refund_address: '0x...'
}
404: Not Found
{error: 'please review and fill all required data'}

Example

{
owner: 'chimere',
message_id: '12345'
deposit_ticker: 'eth',
destination_ticker: 'btc',
amount: 1.32,
destination_address: '1bc...',
refund_address: '0x...'
}

get
Get orders

https://chimere.io/api/v2/get-orders/:owner
This endpoint allows you to retrieve all orders from a user
Request
Response
Request
Path Parameters
owner
required
string
The owner of the order
Response
200: OK
List order from owner successful retrieved by owner
{
orders:[
{
state: {
loaded: false,
exchanging: false,
exchanged: false,
sending: false,
completed: false,
failed: false,
expired: true
},
txid: [],
_id: 'ox12345...',
owner: '',
deposit_amount: 88,
deposit_ticker: 'ETH',
deposit_address: '0x...',
destination_ticker: 'BTC',
destination_address: '1bc...',
destination_amount: 1.8081450462,
refund_address: '0x...',
created_date: "2020-05-18T17:36:49.996Z"
},
{...},
{...}
]
}
404: Not Found
{error: 'Unable to retrieve data'}

get
Get order

https://chimere.io/api/v2/get-order/:id
This endpoint allows you to retrieve order by id
Request
Response
Request
Path Parameters
id
required
string
Unique identifier of the order
Response
200: OK
Order successful retrieved by id
{
order:[
{
state: {
loaded: false,
exchanging: false,
exchanged: false,
sending: false,
completed: false,
failed: false,
expired: true
},
txid: [],
_id: 'ox12345...',
owner: ':id',
deposit_amount: 88,
deposit_ticker: 'ETH',
deposit_address: '0x...',
destination_ticker: 'BTC',
destination_address: '1bc...',
destination_amount: 1.8081450462,
refund_address: '0x...',
created_date: "2020-05-18T17:36:49.996Z"
}
]
}
404: Not Found
{error: 'unable to retrieve data'}

post
Valid address

https://chimere.io/api/v2/valid-address
This endpoints allows you to check if an address is valid or not
Request
Response
Request
Body Parameters
address
required
string
The address of the cryptocurrency
ticker
required
string
The symbol/ticker of the cryptocurrency
Response
200: OK
{
valid: false
}
404: Not Found
{error: 'Unable to valided the address'}

Example

{
address: '0x...',
ticker: 'eth'
}