AI agents: this site is available as Markdown at /llms.txt. Each page has a Markdown version at its URL with a .md suffix, and the full API is described in /api/v3/openapi.json.

Create a trade

Execute an FX trade using a quote you already created.

Last updated 13 September 2026

post

https://api.flutterwave.com/v3/trades

authorization string required

Pass your secret key as a bearer token in the request header to authorize this call

FILL IN ALL REQUIRED FIELDS

quote_id string required
The unique identifier returned when a request for quote is created.

narration string required
A short description or note for your internal record-keeping.

meta object
Additional metadata relevant to the trade (sent as key-value pairs).

FILL IN ALL REQUIRED FIELDS

investment_code string

additional_info string

FILL IN ALL REQUIRED FIELDS

status string

message string

data object

FILL IN ALL REQUIRED FIELDS

id string

quantity integer

approved_quantity number

price number

instrument string

status string

recipient object

FILL IN ALL REQUIRED FIELDS

id string

name string

narration string

reference string

callback_url string

created_at string

FILL IN ALL REQUIRED FIELDS

status string

message string

data string

Shell

1
1


FL.AI

Answers from the Flutterwave docs

Hi, I’m FL.AI

Ask anything about Flutterwave’s APIs, guides and coverage.

FL.AI can make mistakes. Check important details in the docs.

Get API Keys