Skip to main content
POST
Place an order (buy or sell)

Authorizations

X-Ladder-Key
string
header
required

Your key id: pk_test_… (sandbox) or pk_live_… (live).

X-Ladder-Timestamp
string
header
required

Unix seconds, as a string; must be within 5 minutes of server time.

X-Ladder-Signature
string
header
required

Lower-case hex HMAC-SHA512 over timestamp, method, path+query and the SHA-256 of the body. See Authentication.

Headers

Idempotency-Key
string
required

Unique per logical request (max 255 chars). A retry with the same key and body returns the original response with Idempotent-Replayed: true; a different body returns 409.

Body

application/json
side
enum<string>
default:buy
Available options:
buy,
sell
investment_id
string<uuid>
amount
string<decimal>
currency
enum<string>
Available options:
GHS,
USD,
NGN
payment_mode
enum<string>
default:wallet
Available options:
wallet,
checkout
holding_id
string<uuid>
units
string<decimal>
client_reference
string
Maximum string length: 100
customer
object
metadata
Metadata · object

Response

data
object
required