Support
- Contact for API questions: dl.bnpp.smartderivatives.api.support@bnpparibas.com.
Webhooks
- Availability: Not available yet.
- Re-webhooks: No ETA. Currently in discussion with our API provider.
- Alternative: Our solving results are asynchronous. You can start polling after 30 seconds and then poll every 5 seconds until you get a price response.
Polling Time
- General: Varies depending on the complexity of the product. Expect a solve/price in 1-2 minutes.
- Generate Kid/Termsheets: Usually 30 seconds each (can sometimes take 1-2 minutes), and can both be generated simultaneously.
- Booking: Approximately 2-3 minutes.
Price Validity
- Duration: The price validity is 300 seconds but can be increased.
Versioning and Rollouts
- New Versions Rollout: Usually happen after 18:00 Paris time. During these updates, you may receive the message “Exception while polling.”
- API Versioning: New versions are backward compatible. In case of breaking changes, you will be notified via email.
Certificates
- Client Certificate Renewal Process: Clients need to send us the certificates in advance to test them before releasing them into production. If the client creates new credentials using the same keypair as the expired one, we will automatically trust the new certificate if they use the same Common Name.
- Sandbox MTLS Account: Once the certificate is received, we will create your Sandbox MTLS consumer. After the configuration is set, you will receive an invitation to access our devs portal where you will find your credentials.
- Generate Custom Certificate: You need to send it to us. If it's good, we will create the new app.
- MTLS App: Linked with the certificate.
- Certificate Provider: Apigee is the external provider.
- Same Certificate in MTLS and PROD: Yes, you can, but ideally, have a different one.
- CRT and KEY: CRT: Clients needs to generate the CRT certificate, and get the KEY from that generation.
Accounts and Apps
- How Many Accounts: Unlimited.
- How Many Non-MTLS Apps: 10, without a certificate. Even in non-MTLS, you get a user and password.
- Create Account: can be created by yourself first asking for permission in the portal.
- Base URL: https://api-mtls.cib.bnpparibas.com/gm-smart-derivatives
- Where to Get User and Password: At the app portal.
- Same Credentials in MTLS and PROD: No.
- To Go to PROD: Ask the API team to get access to PROD (with the EV certificate) attached, and we will create it directly.
- PROD is Always MTLS App: Yes.
- URL is the Same for MTLS and Non-MTLS: Almost the same. MTLS has just a slash in the URL.
MTLS: https://api-mtls.cib.bnpparibas.com/gm-smart-derivatives
Non-MTLS: https://api.cib.bnpparibas.com/gm-smart-derivatives
Pricing and Trading
- Same Price in UAT or PROD: Yes, you should get the same price. If not, you can ask us.
- First Tries: Easier from Postman.
- Settlement Data Required for Tradable Levels: We need the strike date, strike type (on close or live), and delivery type to provide a tradable price.
- Upfront Fee Cap: Needs to be sent it per deal.
- Trading Hours: It is possible to trade outside trading hours, but it won't be strike live; it will be on the open/close of the market.
Miscellaneous
- Requests Limit: For UAT/PROD: 500 requests/second, so 30,000 requests/minute. This spike alert is for all consumers, meaning all clients at the same time.
- Solve Multiple Fields at Once: currently under development.
- FIX Protocol: No, we use JSON.
- Distribution Fees:
- If you choose to trade at the reoffer price, the distribution fee will be the difference between the reoffer price and the issue price.
- If you prefer to trade at the issue price, you will need to pay the distribution fee upfront.
