What does options_level_required mean?

Your Alpaca options level is too low for the order.

Does Alpaca paper support Level 3?

Yes. Alpaca paper goes up to Level 3.

Can a four-leg order fill in part?

No. Alpaca fills it as a whole or not at all.

Guide

Why does Alpaca say options_level_required?

403 options_level_required means your Alpaca account's options level is too low for the order. Two-leg and four-leg defined-risk spreads need Level 3. Raise the level in Alpaca's Account, Options settings, wait a minute for it to apply, then send the alert again. Alpaca paper goes up to Level 3.

Start free

Official documentation

Nyria docs: Connect Alpaca to Nyria

Fix options_level_required

1
Read the bot log
Open the log entry and read the error_detail field.
2
Check the order type
Note whether the bot tried a single leg or a spread.
3
Open Alpaca settings
Go to Account, then Options in Alpaca.
4
Raise the level
Set the level the strategy needs. Spreads need Level 3.
5
Send the alert again
The new level can take a minute to apply.

What triggers it

Alpaca checks the options level on each order.
Defined-risk spreads need Level 3.
A lower level gets a 403 response.

Paper accounts

Alpaca paper goes up to Level 3.
Set the level before you connect.
Level 3 covers the four-leg structures Nyria supports.

Partial fills

Alpaca fills a multi-leg order as a whole or not at all.
Nyria's per-leg status can lag by a few seconds.
Refresh the log before you worry.

Stay within your level

Match the strategy to the level before you deploy.
Set the level in Alpaca before you connect.
Test the setup on paper first.

Questions

What does options_level_required mean?: Your Alpaca options level is too low for the order.
Which level do spreads need?: Defined-risk spreads need Level 3.
Does Alpaca paper support Level 3?: Yes. Alpaca paper goes up to Level 3.
How long until a new level applies?: It can take a minute.
Can a four-leg order fill in part?: No. Alpaca fills it as a whole or not at all.

All questions