{"openapi":"3.1.0","info":{"title":"ATrader Public Discovery API","version":"1.0.0","description":"Only public product metadata and published Funding projections. Referral is not promotion; a coupon does not imply a percentage. Catalog amounts retain their source semantics; no currency or units are inferred."},"servers":[{"url":"https://atraderlive.com"}],"security":[],"paths":{"/.well-known/atrader.json":{"get":{"operationId":"getAtraderCapabilities","summary":"Public product description","security":[],"parameters":[],"description":"Anonymous, read-only maintained product description. No database access. Query parameters have no effect.","responses":{"200":{"description":"Public response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductMetadata"}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Write methods are not supported"},"503":{"description":"Catalog unavailable; no internal details returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/funding/firms":{"get":{"operationId":"listFundingFirms","summary":"List and filter published firms","security":[],"parameters":[{"name":"market","in":"query","required":false,"schema":{"type":"string","enum":["futures","forex_cfd"]}},{"name":"account_size","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d+(?:\\.\\d+)?$","description":"Exact numeric nominal size, >0 and <=1e9. Example: 50000. No K suffix."}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Exact catalog platform label, ASCII case-insensitive. No aliases or inferred compatibility; unknown labels return no matches."}},{"name":"readiness","in":"query","required":false,"schema":{"type":"string","enum":["READY","PARTIAL"],"description":"Uniform explicit readiness of active program versions, or curated PARTIAL when no active version exists. Mixed or unknown active versions do not match."}},{"name":"firm","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":120,"description":"Published firm slug."}},{"name":"program","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Published catalog program id returned by firms. Not a program name."}}],"description":"Anonymous and read-only. Unknown, repeated, empty or invalid query parameters return 400. Filters are ANDed on the same program/account. Query maximum 2048 encoded characters. Missing optional data remains null; empty arrays do not imply completeness. No rankings or recommendations.","responses":{"200":{"description":"Public response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmList"},"example":{"schema_version":"1.0.0","firms":[]}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Write methods are not supported"},"503":{"description":"Catalog unavailable; no internal details returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/funding/firms/{slug}":{"get":{"operationId":"getFundingFirm","summary":"Published firm, programs, rules and referrals","security":[],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":120,"description":"Published firm slug."}}],"description":"Anonymous and read-only. Unknown, repeated, empty or invalid query parameters return 400. Filters are ANDed on the same program/account. Query maximum 2048 encoded characters. Missing optional data remains null; empty arrays do not imply completeness. No rankings or recommendations.","responses":{"200":{"description":"Public response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmDetail"}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown, unpublished or malformed slug: identical not_found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Write methods are not supported"},"503":{"description":"Catalog unavailable; no internal details returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/funding/search":{"get":{"operationId":"searchFundingFirms","summary":"Deterministic structured search","security":[],"parameters":[{"name":"market","in":"query","required":false,"schema":{"type":"string","enum":["futures","forex_cfd"]}},{"name":"account_size","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d+(?:\\.\\d+)?$","description":"Exact numeric nominal size, >0 and <=1e9. Example: 50000. No K suffix."}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Exact catalog platform label, ASCII case-insensitive. No aliases or inferred compatibility; unknown labels return no matches."}},{"name":"readiness","in":"query","required":false,"schema":{"type":"string","enum":["READY","PARTIAL"],"description":"Uniform explicit readiness of active program versions, or curated PARTIAL when no active version exists. Mixed or unknown active versions do not match."}},{"name":"firm","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":120,"description":"Published firm slug."}},{"name":"program","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Published catalog program id returned by firms. Not a program name."}}],"description":"Anonymous and read-only. Unknown, repeated, empty or invalid query parameters return 400. Filters are ANDed on the same program/account. Query maximum 2048 encoded characters. Missing optional data remains null; empty arrays do not imply completeness. No rankings or recommendations.","responses":{"200":{"description":"Public response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FirmList"},"example":{"schema_version":"1.0.0","firms":[]}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Write methods are not supported"},"503":{"description":"Catalog unavailable; no internal details returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/public/funding/compare":{"get":{"operationId":"compareFundingAccounts","summary":"Compare up to 5 firms and 20 accounts; broad requests return 400","security":[],"parameters":[{"name":"market","in":"query","required":false,"schema":{"type":"string","enum":["futures","forex_cfd"]}},{"name":"account_size","in":"query","required":false,"schema":{"type":"string","pattern":"^\\d+(?:\\.\\d+)?$","description":"Exact numeric nominal size, >0 and <=1e9. Example: 50000. No K suffix."}},{"name":"platform","in":"query","required":false,"schema":{"type":"string","minLength":1,"maxLength":120,"description":"Exact catalog platform label, ASCII case-insensitive. No aliases or inferred compatibility; unknown labels return no matches."}},{"name":"readiness","in":"query","required":false,"schema":{"type":"string","enum":["READY","PARTIAL"],"description":"Uniform explicit readiness of active program versions, or curated PARTIAL when no active version exists. Mixed or unknown active versions do not match."}},{"name":"firm","in":"query","required":false,"schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":120,"description":"Published firm slug."}},{"name":"program","in":"query","required":false,"schema":{"type":"string","format":"uuid","description":"Published catalog program id returned by firms. Not a program name."}},{"name":"firms","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","minItems":1,"maxItems":5,"uniqueItems":true,"items":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","maxLength":120,"description":"Published firm slug."}},"description":"Comma-separated slugs. Require firms, firm or accounts. Duplicate or empty entries rejected; unknown selections match nothing."},{"name":"accounts","in":"query","required":false,"style":"form","explode":false,"schema":{"type":"array","minItems":1,"maxItems":20,"uniqueItems":true,"items":{"type":"string","format":"uuid"}},"description":"Comma-separated catalog account ids, never user trading-account ids. Combined with other filters using AND."}],"description":"Anonymous and read-only. Unknown, repeated, empty or invalid query parameters return 400. Filters are ANDed on the same program/account. Query maximum 2048 encoded characters. Missing optional data remains null; empty arrays do not imply completeness. No rankings or recommendations.","responses":{"200":{"description":"Public response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Comparison"},"example":{"schema_version":"1.0.0","items":[]}}}},"400":{"description":"Invalid query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"405":{"description":"Write methods are not supported"},"503":{"description":"Catalog unavailable; no internal details returned","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Capability":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"status":{"type":"string","enum":["available","beta","planned"]},"access":{"type":"string","enum":["public","authenticated","operator","unavailable"]},"description":{"type":"string"}},"required":["id","status","access","description"]},"ProductMetadata":{"type":"object","additionalProperties":false,"properties":{"product_name":{"type":"string"},"canonical_url":{"type":"string","const":"https://atraderlive.com"},"description":{"type":"string"},"schema_version":{"type":"string","const":"1.0.0"},"last_updated":{"type":"string","format":"date"},"supported_markets":{"type":"array","items":{"type":"string","enum":["futures","forex_cfd"]}},"capabilities":{"type":"array","items":{"$ref":"#/components/schemas/Capability"}},"public_resources":{"type":"array","items":{"type":"string","format":"uri"}},"funding_hub_url":{"type":"string"},"public_funding_api":{"type":"object","additionalProperties":false,"properties":{"firms":{"type":"string"},"firm":{"type":"string"},"search":{"type":"string"},"compare":{"type":"string"}},"required":["firms","firm","search","compare"]},"openapi_url":{"type":"string"}},"required":["product_name","canonical_url","description","schema_version","last_updated","supported_markets","capabilities","public_resources","funding_hub_url","public_funding_api","openapi_url"]},"Referral":{"type":"object","additionalProperties":false,"properties":{"type":{"type":["string","null"]},"market":{"type":["string","null"]},"code":{"type":["string","null"]},"affiliate_id":{"type":["string","null"]},"tracking_url":{"type":["string","null"]},"destination_url":{"type":["string","null"]},"disclosure":{"type":["string","null"]},"checked_at":{"type":["string","null"]},"valid_until":{"type":["string","null"]}},"required":["type","market","code","affiliate_id","tracking_url","destination_url","disclosure","checked_at","valid_until"]},"Promotion":{"type":"object","additionalProperties":false,"properties":{"title":{"type":"string"},"description":{"type":["string","null"]},"coupon":{"type":["string","null"]},"expires_at":{"type":"string","format":"date-time"},"discount_percentage":{"type":"number","minimum":0,"maximum":100,"description":"Explicit published active-promotion percentage only. Never inferred from price, text, referral or coupon."}},"required":["title","description","coupon","expires_at"]},"Stage":{"type":"object","additionalProperties":false,"properties":{"key":{"type":"string"},"name":{"type":"string"},"type":{"type":"string","enum":["evaluation","verification","funded"]}},"required":["key","name","type"]},"Rule":{"type":"object","additionalProperties":false,"properties":{"state":{"type":["string","null"],"enum":["known","unknown","not_applicable","unlimited",null]},"key":{"type":"string"},"stage":{"type":["string","null"]},"value":{"type":["string","number","boolean","null"]},"unit":{"type":["string","null"]},"type":{"type":"string","enum":["amount","percentage","count","boolean","text","duration","schedule"]}},"required":["state","key","stage","value","unit","type"]},"PayoutRule":{"type":"object","additionalProperties":false,"properties":{"state":{"type":["string","null"],"enum":["known","unknown","not_applicable","unlimited",null]},"key":{"type":"string"},"stage":{"type":["string","null"]},"value":{"type":["string","number","boolean","null"]},"unit":{"type":["string","null"]}},"required":["state","key","stage","value","unit"]},"Version":{"type":"object","additionalProperties":false,"properties":{"label":{"type":["string","null"]},"status":{"type":"string","enum":["active","legacy","partial"]},"readiness":{"type":["string","null"],"enum":["READY","PARTIAL",null],"description":"Uniform active-version label; when no active version exists, curated informational partial versions retain PARTIAL. Null means unknown or mixed; publication never implies READY."},"effective_from":{"type":["string","null"]},"effective_until":{"type":["string","null"]},"stages":{"type":"array","items":{"$ref":"#/components/schemas/Stage"}},"rules":{"type":"array","items":{"$ref":"#/components/schemas/Rule"}},"payout_rules":{"type":"array","items":{"$ref":"#/components/schemas/PayoutRule"}}},"required":["label","status","readiness","effective_from","effective_until","stages","rules","payout_rules"]},"Account":{"type":"object","additionalProperties":false,"properties":{"currency":{"type":["string","null"]},"selectable":{"type":"boolean"},"readiness":{"type":["string","null"],"enum":["READY","PARTIAL",null],"description":"Uniform active-version label; when no active version exists, curated informational partial versions retain PARTIAL. Null means unknown or mixed; publication never implies READY."},"price_currency":{"type":["string","null"],"description":"Purchase fee currency, independently of simulated account denomination. No exchange rate conversion."},"price_scope":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"variant":{"type":["string","null"]},"account_size":{"type":["number","null"]},"account_size_label":{"type":["string","null"]},"normal_price":{"type":["number","null"]},"discounted_price":{"type":["number","null"]},"profit_target":{"type":["number","null"]},"drawdown":{"type":["number","null"]},"daily_loss_limit":{"type":["number","null"]},"max_contracts":{"type":["number","null"]},"max_micro_contracts":{"type":["number","null"]},"reset_fee":{"type":["number","null"]},"checkout_url":{"type":["string","null"]},"promotion":{"anyOf":[{"$ref":"#/components/schemas/Promotion"},{"type":"null"}]}},"required":["currency","selectable","readiness","price_currency","price_scope","id","variant","account_size","account_size_label","normal_price","discounted_price","profit_target","drawdown","daily_loss_limit","max_contracts","max_micro_contracts","reset_fee","checkout_url","promotion"]},"Program":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"market":{"type":["string","null"],"enum":["futures","forex_cfd",null]},"program_type":{"type":["string","null"]},"readiness":{"type":["string","null"],"enum":["READY","PARTIAL",null],"description":"Uniform active-version label; when no active version exists, curated informational partial versions retain PARTIAL. Null means unknown or mixed; publication never implies READY."},"drawdown_type":{"type":["string","null"]},"profit_split":{"type":["string","null"]},"consistency_rule":{"type":["string","null"]},"payout_frequency":{"type":["string","null"]},"minimum_payout_days":{"type":["number","null"]},"news_trading":{"type":["string","null"]},"versions":{"type":"array","items":{"$ref":"#/components/schemas/Version"}},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Account"}}},"required":["id","name","market","program_type","readiness","drawdown_type","profit_split","consistency_rule","payout_frequency","minimum_payout_days","news_trading","versions","accounts"]},"Firm":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"website_url":{"type":["string","null"]},"markets":{"type":"array","items":{"type":"string","enum":["futures","forex_cfd"]}},"platforms":{"type":"array","items":{"type":"string"}},"referrals":{"type":"array","items":{"$ref":"#/components/schemas/Referral"}},"coupon":{"type":["string","null"]},"programs":{"type":"array","items":{"$ref":"#/components/schemas/Program"}}},"required":["slug","name","url","website_url","markets","platforms","referrals","coupon","programs"]},"FirmList":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","const":"1.0.0"},"firms":{"type":"array","items":{"$ref":"#/components/schemas/Firm"}}},"required":["schema_version","firms"]},"FirmDetail":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","const":"1.0.0"},"firm":{"$ref":"#/components/schemas/Firm"}},"required":["schema_version","firm"]},"ComparisonItem":{"type":"object","additionalProperties":false,"properties":{"firm":{"type":"string"},"program":{"type":"string"},"program_name":{"type":"string"},"market":{"type":["string","null"],"enum":["futures","forex_cfd",null]},"readiness":{"type":["string","null"],"enum":["READY","PARTIAL",null],"description":"Uniform active-version label; when no active version exists, curated informational partial versions retain PARTIAL. Null means unknown or mixed; publication never implies READY."},"platforms":{"type":"array","items":{"type":"string"}},"drawdown_type":{"type":["string","null"]},"profit_split":{"type":["string","null"]},"consistency_rule":{"type":["string","null"]},"payout_frequency":{"type":["string","null"]},"minimum_payout_days":{"type":["number","null"]},"referrals":{"type":"array","items":{"$ref":"#/components/schemas/Referral"}},"coupon":{"type":["string","null"]},"account":{"$ref":"#/components/schemas/Account"}},"required":["firm","program","program_name","market","readiness","platforms","drawdown_type","profit_split","consistency_rule","payout_frequency","minimum_payout_days","referrals","coupon","account"]},"Comparison":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","const":"1.0.0"},"items":{"type":"array","items":{"$ref":"#/components/schemas/ComparisonItem"},"maxItems":20}},"required":["schema_version","items"]},"Error":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","const":"1.0.0"},"error":{"type":"string","enum":["invalid_query","not_found","catalog_unavailable"]}},"required":["schema_version","error"]}}}}