API REFERENCE
Quotes over HTTP.
A public, read-only endpoint for exact-input quote requests.
POST
/api/v1/trading/quotesSend JSON to https://www.floor1.fun. This endpoint needs no site session or API key. Browser calls are supported with CORS; credentials are omitted. It computes a quote and does not send a transaction.
Request
Terminal
curl https://www.floor1.fun/api/v1/trading/quotes \
-H 'Content-Type: application/json' \
-d '{
"token": "0x1111111111111111111111111111111111111111",
"side": "buy",
"amount": "10000000000000000",
"slippageBps": 100
}'| Field | Required | Format |
|---|---|---|
| token | Yes | Token contract address. |
| side | Yes | buy or sell. |
| amount | Yes | Positive decimal uint256 string in atomic units. |
| slippageBps | Yes | Integer from 10 to 5000. |
Unknown request fields are rejected. Maximum request body size is 2048 bytes. There is no exact-output mode.
Response
| Field | Type | Meaning |
|---|---|---|
| id | string | Quote identifier. |
| chainId / token / side / mode | number / string | 91342, token address, direction, and exact_in. |
| amount / slippageBps | string / number | The requested input and slippage. |
| amountOut / minimumOut | string | Estimated output and on-chain minimum. |
| fee / protocolFee / creatorFee | string | Fees in quote-asset atomic units. |
| issuedAt / expiresAt | number | Unix timestamps in milliseconds. |
| snapshot | object | State provenance; includes blockNumber, indexedAt, and marketVersion. |
Errors and limits
JSON
{
"error": {
"code": "unprocessable",
"message": "The curve has insufficient liquidity for this amount."
}
}| Status | Code | Meaning |
|---|---|---|
| 400 | bad_request | Invalid input, unsupported fields, or oversized body. |
| 404 | not_found | Token is unknown or removed. |
| 422 | unprocessable | Inactive curve, unsupported asset, tiny amount, or insufficient liquidity. |
| 429 | rate_limited | Wait for the Retry-After interval. |
| 503 | unavailable | Indexed parameters or quote service are unavailable. |
The local fallback admits 40 quote requests per 10 seconds per instance and trusted caller key. Hosted firewall rules can apply stricter limits. Respect Retry-After on 429 and 503 responses. Responses use Cache-Control: no-store. OPTIONS returns the browser preflight response. Other Floor1 API endpoints are outside this public SDK.