Асинхронный REST-клиент для API Finam.
Используется aiohttp для создания клиента и pydantic для удобной работы с моделями данных.
Python >= 3.8 НО!!! Планирую обновить до версии 3.11 отдельной веткой и текущую удалить осенью 2024 года, так как истечет поддержка 3.8
Install with pip
pip install finam-trade-api
import os
from finam_trade_api.client import Client
from finam_trade_api.candles.model import (
DayCandlesRequestModel,
DayInterval,
IntraDayCandlesRequestModel,
IntraDayInterval
)
token = os.getenv("TOKEN", "")
async def get_day_candles():
client = Client(token)
params = DayCandlesRequestModel(
securityBoard="TQBR",
securityCode="SBER",
timeFrame=DayInterval.D1,
intervalFrom="2023-06-05",
intervalTo="2023-06-07",
)
return await client.candles.get_day_candles(params)
async def get_in_day_candles():
client = Client(token)
params = IntraDayCandlesRequestModel(
securityBoard="TQBR",
securityCode="SBER",
timeFrame=IntraDayInterval.M1,
intervalFrom="2023-06-07 08:33:52",
count=10
)
return await client.candles.get_in_day_candles(params)
if __name__ == "__main__":
import asyncio
print(asyncio.run(get_day_candles()))
print(asyncio.run(get_in_day_candles()))
import os
from finam_trade_api.client import Client
from finam_trade_api.order.model import (
BoardType,
CreateOrderRequestModel,
CreateStopOrderRequestModel,
DelOrderModel,
OrdersRequestModel,
OrderType,
PropertyType,
StopLossModel,
StopQuantity,
StopQuantityUnits,
TakeProfitModel
)
token = os.getenv("TOKEN", "")
client_id = os.getenv("CLIENT_ID", "")
client = Client(token)
async def create_order():
payload = CreateOrderRequestModel(
clientId=client_id,
securityBoard=BoardType.Futures,
securityCode="SiH3",
buySell=OrderType.Sell,
quantity=1,
price=74920,
property=PropertyType.PutInQueue,
condition=None,
validateBefore=None,
)
return await client.orders.create_order(payload)
async def get_orders():
params = OrdersRequestModel(
clientId=client_id,
includeActive="true",
includeMatched="true",
)
return await client.orders.get_orders(params)
async def del_order(transaction_id: str):
params = DelOrderModel(
client_id=client_id,
transactionId=transaction_id
)
return await client.orders.del_order(params)
async def create_stop_order(transaction_id: int):
payload = CreateStopOrderRequestModel(
clientId=client_id,
securityBoard=BoardType.Futures,
securityCode="SiH3",
buySell=OrderType.Buy,
linkOrder=transaction_id,
stopLoss=StopLossModel(
activationPrice=74940,
marketPrice=True,
quantity=StopQuantity(
value=1,
units=StopQuantityUnits.Lots,
)
),
takeProfit=TakeProfitModel(
activationPrice=74850,
marketPrice=True,
quantity=StopQuantity(
value=1,
units=StopQuantityUnits.Lots,
)
),
)
return await client.orders.create_stop_order(payload)
Больше примеров в examples/
ДАННОЕ ПРОГРАММНОЕ ОБЕСПЕЧЕНИЕ ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНО ВЫРАЖЕННЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ ГАРАНТИИ ТОВАРНОЙ ПРИГОДНОСТИ, СООТВЕТСТВИЯ ПО ЕГО КОНКРЕТНОМУ НАЗНАЧЕНИЮ И ОТСУТСТВИЯ НАРУШЕНИЙ, НО НЕ ОГРАНИЧИВАЯСЬ ИМИ. НИ В КАКОМ СЛУЧАЕ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ПО КАКИМ-ЛИБО ИСКАМ, ЗА УЩЕРБ ИЛИ ПО ИНЫМ ТРЕБОВАНИЯМ, В ТОМ ЧИСЛЕ, ПРИ ДЕЙСТВИИ КОНТРАКТА, ДЕЛИКТЕ ИЛИ ИНОЙ СИТУАЦИИ, ВОЗНИКШИМ ИЗ-ЗА ИСПОЛЬЗОВАНИЯ ПРОГРАММНОГО ОБЕСПЕЧЕНИЯ ИЛИ ИНЫХ ДЕЙСТВИЙ С ПРОГРАММНЫМ ОБЕСПЕЧЕНИЕМ.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.