Integration Guide
Use Smart Money API from Python
A minimal, copy-paste Python client that checks whether smart-money flow and derivatives positioning confirm a trade before you act on it.
Who this is for
Python developers and quant traders who want to add a smart-money confirmation gate to a script, notebook, or bot. No SDK required — just the standard requests library and an API key.
Get your API key
Every request authenticates with the X-API-Key header. To get a key:
- 1Create a free account, then open your dashboard.
- 2Copy the API key shown under API Access. The free tier covers BTC at 20 requests/day — enough to test this guide end to end.
- 3Need more symbols or higher limits? Compare tiers on the pricing page.
Keep the key secret — store it in an environment variable, never commit it to source control.
Setup
- 1Install the HTTP client:
pip install requests. - 2Export your key so it stays out of source:
export SMA_API_KEY="sk_your_key_here". - 3Drop the snippet below into a file (e.g.
confirm.py) and runpython confirm.py. - 4Wire the returned
confirmationlevel into your own entry logic and risk management.
Working example
This script calls GET /v1/confirm?symbol=BTC&direction=long with your key in the X-API-Key header and prints the confirmation level.
import os
import requests
API_KEY = os.environ["SMA_API_KEY"] # set this in your shell, never hard-code
BASE_URL = "https://api.smartmoneyapi.com"
def confirm(symbol: str, direction: str) -> dict:
"""Ask Smart Money API whether whale flow + derivatives confirm a trade idea."""
resp = requests.get(
f"{BASE_URL}/v1/confirm",
params={"symbol": symbol, "direction": direction},
headers={"X-API-Key": API_KEY},
timeout=10,
)
resp.raise_for_status()
return resp.json()
if __name__ == "__main__":
data = confirm("BTC", "long")
print(f"{data['symbol']} {data['direction']}: "
f"{data['confirmation']} (score {data['score']})")
# Simple gate: only act on a HIGH confirmation
if data["confirmation"] == "HIGH":
print("Smart money agrees -> proceed with your own risk checks")
else:
print("Not confirmed -> skip or wait")
Expected response
A successful call to /v1/confirm returns JSON like this (fields abbreviated):
{
"symbol": "BTC",
"direction": "long",
"confirmation": "HIGH",
"score": 0.78,
"smart_money": {
"net_flow_usd": 4250000,
"long_short_ratio": 1.62,
"whales_long": 38,
"whales_short": 14
},
"derivatives": {
"funding_rate": 0.00011,
"oi_change_24h": 0.067
},
"as_of": "2026-06-30T12:00:00Z"
}
confirmation is one of HIGH / MEDIUM / LOW / NONE and score is a 0–1 conviction blend of smart-money flow and derivatives positioning for the requested side. See the full field reference in the API docs.
Ready to build?
Grab a free key and make your first confirmation call in under a minute.
Not financial advice. Crypto trading involves risk.