Conventions - Grain Developer Portal

Grain’s API provides a comprehensive set of endpoints for managing hedging, spot transactions, pricing, and fund movements — enabling seamless integration of FX workflows into your platform.

Base URL

https://api.grainfinance.co/v1

Environments

Environment	Base URL
Sandbox	`https://api.grainfinance.co/v1` (use Sandbox credentials)
Live	`https://api.grainfinance.co/v1` (use Live credentials)

Switch between environments by swapping your Client ID and Secret — the base URL is the same for both.

Response format

All responses are JSON. Errors follow a consistent structure:

{
  "message": "A description of the error"
}

HTTP status codes follow standard conventions: 2xx for success, 4xx for client errors, 5xx for server errors.

OpenAPI Specification:

Download the full specification here.