Quickstart

pip install requests

import requests

API_KEY = "your_api_key"
BASE_URL = "https://api.centosfi.com/v1"

headers = {"x-api-key": API_KEY}

# Search for shutdown related markets on Polymarket
response = requests.get(
    f"{BASE_URL}/markets/search",
    headers=headers,
    params={"q": "shutdown", "exchange": "POLYMARKET"}
)
for market in response.json()["results"]:
    print(f"Centos ID: {market['centos_id']}, Ticker: {market['slug']}")

response = requests.post(
    f"{BASE_URL}/subaccounts",
    headers=headers,
    json={"name": "My Trading Account"}
)
subaccount = response.json()
subaccount_id = subaccount["subaccount_id"]

response = requests.post(
    f"{BASE_URL}/orders",
    headers=headers,
    json={
        "subaccount_id": subaccount_id,
        "centos_id": 4552150,       # From market search
        "order_type": "LIMIT",      # LIMIT or MARKET
        "time_in_force": "GTC",     # FOK, GTC, GTD, or IOC
        "buy_flag": True,           # True=buy, False=sell
        "price": 0.50,              # Limit price (0-1)
        "qty": 10,                  # Number of contracts
    }
)
order = response.json()
print(f"Order placed: {order['centos_order_id']}")

order_id = order['centos_order_id']
response = requests.get(
    f"{BASE_URL}/orders/{order_id}",
    headers=headers
)
order_status = response.json()
print(f"Status: {order_status['status']}, Filled: {order_status['traded_qty']}/{order_status['qty']}")

order_id = order['centos_order_id']
response = requests.delete(
    f"{BASE_URL}/orders/{order_id}",
    headers=headers
)
if response.status_code == 202:
    print(response.json())